ecl-logo Documentation
ECL`

ExperimentDissolution

ExperimentDissolution[Samples]⟹Protocol

creates a Protocol that measures how quickly and completely Samples dissolve under controlled conditions. This test is used to evaluate a drug's performance.

    
A protocol for capturing the visual information and taking samples of a oral solid dosage being dissolved in a liquid media at a controlled temperature. The experiment is often used to determine the dissolution rate of a given formulation.
    

Experimental Principles

    Figure 1.1: The overall dissolution process consists (1) Preheating the dissolution medium to the specified temperature; (2) Introducing the dosage form into the vessel containing the medium to initiate testing, (3) mixing with controlled agitation and withdrawing aliquots at defined time points, (4) in some methods, the agitation rate may be increased at the end of the run to ensure complete release and establish the "infinity" point. Drug dissolution is a dynamic process that often occurs alongside capsule rupture, tablet disintegration, and erosion of the dosage form. Collected samples are separated from undissolved drug and excipients (e.g., by filtration).
    Figure 1.2: The cleaning of the dissolution vessels is performed as a multi-step process with the use of soap, methanol, and brush.

Instrumentation

    Distek 2500 Bathless with Eclipse 5300 autosampler and filter changer

    Figure 2.1: A dissolution instrument has two main components: a dissolution unit and an autosampler. The dissolution unit mixes the sample at a controlled rate and temperature, while the autosampler takes and filters aliquots from the dissolution vessels, with an option to replace the withdrawn media.

    Waters Acquity UPLC Premier PDA

    Figure 2.2.1: Instrument diagram for the H-Class and I-Class systems. Buffer solutions (up to 4) are steadily pumped through the instrument, consisting of a 6-port valve system, adsorbent column, detectors, and terminates at fraction collection or waste. Samples within the autosampler are loaded into the sample loop via positive displacement from the syringe. The rotation of the valve exposes the sample loop, thereby carrying the sample downstream to the column. Within the column, molecular constituents are separated by adsorption -- a function of the buffers, column, sample properties and temperature. Analytes are continuously carried downstream to the detectors, where they can elicit quantifiable peak signals.
    Figure 2.2.2: Principle of PhotodiodeArray detection. Filtered light (across a range of wavelengths) passes through the flow downstream of the column. Presence of light-absorbing molecules will result in less light transmission to the recipient Diode, thereby producing a chromatographic peak for each specific wavelength.

    Lunatic

    Figure 2.3: In the Lunatic, a Xenon Flash Lamp sends photons through the large and small cuvettes of each microfluidic chip. The light that is not absorbed is then directed through a prism which splits the beam into wavelengths from 230 nm to 750 nm that are measured by the detector.

Experiment Options

    General

    Instrument

    The instrument stirs the sample in a temperature-controlled medium, taking aliquots and capturing images of the dissolution vessels at specified time points.
    Default Value: Model[Instrument, DissolutionApparatus, Distek 2500 Bathless with Eclipse 5300 autosampler and filter changer]
    Pattern Description: An object of type or subtype Object[Instrument, DissolutionApparatus] or Model[Instrument, DissolutionApparatus]
    Programmatic Pattern: ObjectP[{Object[Instrument, DissolutionApparatus], Model[Instrument, DissolutionApparatus]}]

    Medium

    Medium

    The buffer used to dissolve samples. This is often chosen to mimic a biologically relevant environment.
    Default Value: Model[Sample, Milli-Q water]
    Pattern Description: An object of type or subtype Object[Sample] or Model[Sample] or a prepared sample or Model[Sample, 0.1N HCl for Dissolution], Model[Sample, Sodium Phosphate 0.05M Buffer, pH 6.80], Model[Sample, Sodium Acetate 0.05M Buffer, pH 4.50], or Model[Sample, Milli-Q water]
    Programmatic Pattern: (Model[Sample, "0.1N HCl for Dissolution"] | Model[Sample, "Sodium Phosphate 0.05M Buffer, pH 6.80"] | Model[Sample, "Sodium Acetate 0.05M Buffer, pH 4.50"] | Model[Sample, "Milli-Q water"]) | (ObjectP[{Object[Sample], Model[Sample]}] | _String)
    Index Matches to: experiment samples

    MediumVolume

    The volume of the medium used to dissolve the samples and from which the aliquots are taken throughout the experiment.
    Default Value: Automatic
    Default Calculation: Automatically set to the RecommendedFillVolume of the DefaultMediumVessel used for the instrument. For Model[Instrument,DissolutionApparatus,"Distek 2500 Bathless with Eclipse 5300 autosampler and filter changer"], 0.9 Liter is set.
    Pattern Description: Greater than or equal to 300 milliliters and less than or equal to 1 liter.
    Programmatic Pattern: RangeP[300*Milliliter, 1*Liter] | Automatic
    Index Matches to: experiment samples

    MediumTemperature

    The temperature of the medium as read by the temperature probe in the agitator that is used to dissolve the sample. The vessel is heated above the ambient temperature via a jacket on the dissolution vessel.
    Default Value: 37 degrees Celsius
    Pattern Description: Ambient or Temperature or Null.
    Programmatic Pattern: (RangeP[25*Celsius, 90*Celsius] | Ambient) | Null
    Index Matches to: experiment samples

    Mixing

    MixingStrategy

    The type of the stirring device used in the experiment to mix the samples.
    Figure 3.1: The MixingStrategy option specifies the type of the stirring device used in the experiment to mix the samples. The different shaft types are represented in the diagram. The paddle shaft is used for low-viscosity media and gentle agitation, while the basket shaft is designed for higher viscosity media and more vigorous mixing. The shaft type should be selected based on the viscosity of the medium and the desired mixing intensity.
    Default Value: Automatic
    Default Calculation: Automatically set to Basket if the SampleBuoyancy is set to Floats, otherwise set to Paddle.
    Pattern Description: Paddle or Basket.
    Programmatic Pattern: DissolutionStrategyP | Automatic

    AgitatorMaterial

    The material of the agitator used in the experiment to mix the samples.
    Default Value: Automatic
    Default Calculation: Automatically inherited from the specified Agitator; if the Agitator is not specified, defaulted to StainlessSteel.
    Pattern Description: StainlessSteel or PTFE.
    Programmatic Pattern: ShaftMaterialP | Automatic

    Agitator

    The specific Model of the agitator used in this experiment.
    Default Value: Automatic
    Default Calculation: Automatically set to the appropriate agitator based on the MixingStrategy, AgitatorMaterial, SampleBuoyancy, and the Instrument specified.
    Pattern Description: An object of type or subtype Model[Item, Agitator] or Object[Item, Agitator]
    Programmatic Pattern: ObjectP[{Model[Item, Agitator], Object[Item, Agitator]}] | Automatic

    SampleBuoyancy

    This indicates if samples are expected to sink or float in the medium. This information is used to inform Automatic selection of the Sinker and MixingStrategy options for keeping the sample submerged during the experiment: either by using a Sinker to weigh down the sample or a Basket MixingStrategy to contain it. Parameters can also be selected manually if desired.
    Default Value: Null
    Pattern Description: Sinks or Floats or Null.
    Programmatic Pattern: (Sinks | Floats) | Null
    Index Matches to: experiment samples

    Sinker

    The weighted enclosure used to keep the sample below the surface of the medium during the experiment to facilitate proper mixing.
    Default Value: Automatic
    Default Calculation: If SampleBuoyancy set to Floats, set the size-appropriate sinker based on the sample information, no sinkers are allowed is Basket MixingStrategy is used.
    Pattern Description: An object of type or subtype Model[Item, Sinker] or Object[Item, Sinker] or Null.
    Programmatic Pattern: (ObjectP[{Model[Item, Sinker], Object[Item, Sinker]}] | Automatic) | Null
    Index Matches to: experiment samples

    SinkerType

    The type of sinker used to keep the sample below the surface of the medium during the experiment to facilitate proper mixing.
    Figure 3.2: The SinkerType option specifies the shape of the weighted enclosure used to keep the sample below the surface of the medium and agitator during the experiment to facilitate proper mixing. The different sinker types are represented in the diagram.
    Default Value: Automatic
    Default Calculation: Automatically set to the ThreeProng sinker if the SampleBuoyancy is set to Floats and the MixingStrategy is set to Paddle.
    Pattern Description: ThreeProng, Helix, Japanese, Cage, or Basic or Null.
    Programmatic Pattern: (SinkerTypeP | Automatic) | Null
    Index Matches to: experiment samples

    MixRate

    The frequency at which the agitator is rotated during the experiment.
    Default Value: Automatic
    Default Calculation: Automatically set to 100RPM for Basket MixingStrategy and 50RPM for Paddle MixingStrategy. Basket MixingStrategy is often used with lower MixRate. After the MixTime has elapsed, the MixRate is increased to InfinityMixRate to achieve the "final" saturation point.
    Pattern Description: Greater than or equal to 25 revolutions per minute and less than or equal to 350 revolutions per minute.
    Programmatic Pattern: RangeP[25*RPM, 350*RPM] | Automatic

    MixTime

    The duration of time the sample is mixed prior to the Infinity Mixing period during which the sampling occurs at the specified SamplingTime intervals. The Infinity Mixing period involves a higher stirring rate at the end of the protocol to obtain the final saturation point.
    Default Value: Automatic
    Default Calculation: Automatically set based on the SamplingTime. When SamplingTime is provided as a list, the duration is set to the highest value in the list. When SamplingTime is a single value, the total duration is calculated based on the NumberOfAliquots. If SamplingTime and NumberOfAliquots are set to Automatic, the duration set to 1 hour.
    Pattern Description: Greater than or equal to 0 minutes and less than or equal to 72 hours.
    Programmatic Pattern: RangeP[0*Minute, $MaxExperimentTime] | Automatic

    Degas

    Indicates if dissolution medium will be degassed by bubbling Helium though it. The degassing is performed after the media is transferred into the vessels in the selected instrument.
    Default Value: True
    Pattern Description: True or False.
    Programmatic Pattern: BooleanP

    DegasTime

    The duration of time the Helium is being bubbled though the Medium in the DissolutionVessels prior to the experiment starting. Doing this for the medium containing sufractants is not advised due to the potential of the foam forming on the surface of the medium.
    Default Value: Automatic
    Default Calculation: If Degas is specified to True, automatally set to 5 Minutes, othwerwise, set to Null.
    Pattern Description: Greater than or equal to 1 minute and less than or equal to 5 hours or Null.
    Programmatic Pattern: (RangeP[1*Minute, 5*Hour] | Automatic) | Null

    Sampling

    Cannula

    The cannula used to sample media during the dissolution experiment.
    Default Value: Automatic
    Default Calculation: Automatically set based on MediumVolume: 900mL cannula if MediumVolume > 700mL, otherwise 500mL cannula.
    Pattern Description: An object of type or subtype Model[Item, Cannula]
    Programmatic Pattern: ObjectP[Model[Item, Cannula]] | Automatic

    Sampling

    Indicates if samples of the dissolution media should be taken during the experiment. These samples are commonly used to determine the amount of the sample that was dissolved in the medium at a given time point.
    Default Value: True
    Pattern Description: True or False.
    Programmatic Pattern: BooleanP

    NumberOfAliquots

    Indicates the number of aliquots taken from the dissolution medium during the experiment.
    Default Value: Automatic
    Default Calculation: Automatically set to the number of SamplingTime intervals if SamplingTime is set to a single value, otherwise set to the number of SamplingTime intervals that fit into MixTime. If MixTime and SamplingTIme are set to Automatic, NumberOfAliquots is set to the maximum number of samples that can be taken from the dissolution medium during the experiment minus one to account for InfinityMixing.
    Pattern Description: Greater than or equal to 1 and less than or equal to 12 in increments of 1 or Null.
    Programmatic Pattern: (RangeP[1, 12, 1] | Automatic) | Null

    SamplingTime

    The time interval or the list of the time points for taking aliquots of the dissolution medium. For example, to take an aliquot every 5 minutes, SamplingTime can be specified as either 5 Minute or {5 Minute, 10 Minute, 15 Minute, 20 Minute..}.
    Default Value: Automatic
    Default Calculation: Automatically set so that the number of SamplingTime intervals is equal to NumberOfAliquots. If NumberOfAliquots and MixTime are set to Automatic, SamplingTime is set to the 5 Minutes.
    Pattern Description: List of time points or Time interval or Null.
    Programmatic Pattern: ((RangeP[2*Minute, $MaxExperimentTime] | {RangeP[2*Minute, $MaxExperimentTime]..}) | Automatic) | Null

    SamplingVolume

    The volume aliquot taken from the dissolution medium at each SamplingTime time point.
    Default Value: Automatic
    Default Calculation: Automatically set to 1.5 Milliliters if Sampling is specified.
    Pattern Description: Greater than or equal to 300 microliters and less than or equal to 2 milliliters or Null.
    Programmatic Pattern: (RangeP[300*Microliter, 2*Milliliter] | Automatic) | Null

    ContainersOut

    The container type that each aliquoted sample is deposited to. The vials should have a slitted cover to be allowed on the isntrument.
    Default Value: Automatic
    Default Calculation: Automatically set to Model[Container,Vessel,"2mL HPLC clear vial, flat bottom"] if Sampling is specified.
    Pattern Description: An object of type or subtype Model[Container] or Object[Container] or a prepared sample or Null.
    Programmatic Pattern: ((ObjectP[{Model[Container], Object[Container]}] | _String) | Automatic) | Null

    CollectionFlowRate

    The speed at which the medium is aspirated during the experiment.
    Default Value: Automatic
    Default Calculation: Automatically set to the instrument default value of 8 Milliliter/Minute if Sampling is specified.
    Pattern Description: Greater than or equal to 8 milliliters per minute and less than or equal to 50 milliliters per minute.
    Programmatic Pattern: RangeP[8*(Milliliter/Minute), 50*(Milliliter/Minute)] | Automatic

    DispenseFlowRate

    The speed at which the medium is dispensed during the experiment.
    Default Value: Automatic
    Default Calculation: Automatically sets to 8 Milliliter/Minute if Sampling is specified.
    Pattern Description: Greater than or equal to 8 milliliters per minute and less than or equal to 50 milliliters per minute or Null.
    Programmatic Pattern: (RangeP[8*(Milliliter/Minute), 50*(Milliliter/Minute)] | Automatic) | Null

    VesselReturnFlowRate

    The speed at which the medium is returned to the dissolution vessel after sampling from the recycling reservoir or from the ReplacementMedia bottle.
    Default Value: Automatic
    Default Calculation: Automatically sets to 8 Milliliter/Minute if Sampling is specified.
    Pattern Description: Greater than or equal to 8 milliliters per minute and less than or equal to 25 milliliters per minute or Null.
    Programmatic Pattern: (RangeP[8*(Milliliter/Minute), 25*(Milliliter/Minute)] | Automatic) | Null

    ReplaceMedium

    Indicates if the buffer removed for sampling is replaced with an equal volume of the fresh buffer each time an aliquot is taken.
    Default Value: Automatic
    Default Calculation: Automatically set to True if ReplacementMedium is set, otherwise set to False.
    Pattern Description: True or False.
    Programmatic Pattern: BooleanP | Automatic

    ReplacementMedium

    The medium used to replace the buffer removed for sampling each time an aliquot is taken.
    Default Value: Automatic
    Default Calculation: Automatically set to the medium used in the experiment if ReplaceMedium is set to True. If several different buffers are used, the buffer with the highest frequency is used. If several buffers are used with the same frequency, the first specified buffer is used.
    Pattern Description: An object of type or subtype Object[Sample] or Model[Sample] or a prepared sample or Null.
    Programmatic Pattern: ((ObjectP[{Object[Sample], Model[Sample]}] | _String) | Automatic) | Null

    SamplingFlushVolume

    The volume of the medium used to clean the sampling lines before sampling.
    Default Value: Automatic
    Default Calculation: Automatically set to 3 Milliliter if Sampling is set.
    Pattern Description: Greater than or equal to 0 milliliters and less than or equal to 13 milliliters or Null.
    Programmatic Pattern: (RangeP[0*Milliliter, 13*Milliliter] | Automatic) | Null

    NumberOfSamplingFlushes

    Indicate the number of times the sampling lines should be cleaned prior to sampling.
    Default Value: Automatic
    Default Calculation: Automatically sets to 1 if SamplingFlushVolume is set.
    Pattern Description: Greater than or equal to 1 and less than or equal to 5 in increments of 1 or Null.
    Programmatic Pattern: (RangeP[1, 5, 1] | Automatic) | Null

    RecycleSamplingMedium

    Indicates if the buffer removed for sample flushing is returned from the lines back to the dissolution vessel. Refer to the instrument diagram of the liquid flow path during the instrument operation for more details.
    Default Value: Automatic
    Default Calculation: Automatically set to False if Sampling is set to False, otherwise set to True.
    Pattern Description: True or False.
    Programmatic Pattern: BooleanP | Automatic

    NumberOfSamplingWashCycles

    Indicate the number of times the system wash cycle is performed between each sampling timepoint.
    Default Value: Automatic
    Default Calculation: Automatically set to 1 if Sampling is set.
    Pattern Description: 1, 2, 3, 4, or 5 or Null.
    Programmatic Pattern: ((1 | 2 | 3 | 4 | 5) | Automatic) | Null

    Sampling Filtration

    FilterSamples

    Indicates the type(s) of filtration applied to dissolution media samples during transfer. Accepts a list of filtration types (CannulaTipFiltration, InLineFiltration, AutosamplerFiltration) that are applied in sequence. CannulaTipFiltration: filters before liquid enters the cannula. InLineFiltration: filters the liquid as it passes through the cannula immediately after removal from the vessel. AutosamplerFiltration: filters media before dispensing into ContainersOut (can be changed between aliquots).
    Default Value: Automatic
    Default Calculation: Automatically set based on which filtration sub-options are specified. Default is {InLineFiltration} if Sampling is True.
    Pattern Description: Multiple Types or None or Single Type.
    Programmatic Pattern: (None | DissolutionFiltrationTypeP | {DissolutionFiltrationTypeP..}) | Automatic

    AutosamplerFilterMaterial

    The membrane material of the filter disk used to remove impurities before the aliquots are saved.
    Default Value: Automatic
    Default Calculation: Automatically set to the match the material of the filter disks specifiedby the AutosamplerFilter option, otherwise set to PVDF when AutosamplerFiltration is in the FilterSamples list.
    Pattern Description: Cellulose, Cotton, Polyethylene, Polypropylene, PTFE, wwPTFE, Nylon, PES, PLUS, PVDF, GlassFiber, GHP, UHMWPE, EPDM, DuraporePVDF, GxF, ZebaDesaltingResin, NickelResin, AgaroseResin, CobaltResin, Silica, HLB, or AnoporeAlumina or Null.
    Programmatic Pattern: (FilterMembraneMaterialP | Automatic) | Null

    AutosamplerFilterPoreSize

    The pore size of the filter disk used to remove impurities before the aliquots are saved.
    Default Value: Automatic
    Default Calculation: Automatically set to the match the pore size of the filter disks specified by the AutosamplerFilter option, otherwise set to 0.45 Micron when AutosamplerFiltration is in the FilterSamples list.
    Pattern Description: 0.008 micrometers, 0.02 micrometers, 0.1 micrometers, 0.2 micrometers, 0.22 micrometers, 0.45 micrometers, 1 micrometer, 1. micrometer, 1.1 micrometers, 2.5 micrometers, 6 micrometers, 6. micrometers, 10 micrometers, 10. micrometers, 20 micrometers, 20. micrometers, 30 micrometers, 30. micrometers, 35 micrometers, 35. micrometers, 45 micrometers, 45. micrometers, 70 micrometers, 70. micrometers, 100 micrometers, or 100. micrometers or Null.
    Programmatic Pattern: (FilterSizeP | Automatic) | Null

    AutosamplerFilter

    The filter disks used to filter the aliquots of samples that are taken from the dissolution medium at the specified time points before the sample is dispenced into the ContainerOut. This filter is applied after the InLineFilter and is optinally changed between each aliquot.
    Default Value: Automatic
    Default Calculation: Automatically set to a Filter with the specified AutosamplerFilterMaterial and AutosamplerFilterPoreSize, if none are specified, automatically set to Model[Item, Filter, "PSF Acrodisc PVDF syringe filter, 0.45 µm, 25 mm"] if AutosamplerFiltration is in the FilterSamples list.
    Pattern Description: An object of type or subtype Model[Item, Filter] or Null.
    Programmatic Pattern: (ObjectP[{Model[Item, Filter]}] | Automatic) | Null

    NumberOfFilterUses

    Indicates the number of times the AutosamplerFilter is used before being replaced with a new one.
    Default Value: Automatic
    Default Calculation: Automatically set to 1 if AutosamplerFiltration is in the FilterSamples list.
    Pattern Description: 1, 2, or 3 or Null.
    Programmatic Pattern: ((1 | 2 | 3) | Automatic) | Null

    InLineFilterMaterial

    The material of the filter that is used to remove impurities from the samples right after they are removed from the dissolution vessel and prior to the liquid entering the autosampler.
    Default Value: Automatic
    Default Calculation: Automatically set to the match the material of the filter specified by the InLineFilter option, otherwise set to UHMWPE when InLineFiltration is in the FilterSamples list.
    Pattern Description: Cellulose, Cotton, Polyethylene, Polypropylene, PTFE, wwPTFE, Nylon, PES, PLUS, PVDF, GlassFiber, GHP, UHMWPE, EPDM, DuraporePVDF, GxF, ZebaDesaltingResin, NickelResin, AgaroseResin, CobaltResin, Silica, HLB, or AnoporeAlumina or Null.
    Programmatic Pattern: (FilterMembraneMaterialP | Automatic) | Null

    InLineFilterPoreSize

    The pore size of the filter that is used to remove impurities from the samples right after they are removed from the dissolution vessel and prior to the liquid entering the autosampler.
    Default Value: Automatic
    Default Calculation: Automatically set to the match the pore size of the filter specified by the InLineFilter option, otherwise set to 45 Micron when InLineFiltration is in the FilterSamples list.
    Pattern Description: 0.008 micrometers, 0.02 micrometers, 0.1 micrometers, 0.2 micrometers, 0.22 micrometers, 0.45 micrometers, 1 micrometer, 1. micrometer, 1.1 micrometers, 2.5 micrometers, 6 micrometers, 6. micrometers, 10 micrometers, 10. micrometers, 20 micrometers, 20. micrometers, 30 micrometers, 30. micrometers, 35 micrometers, 35. micrometers, 45 micrometers, 45. micrometers, 70 micrometers, 70. micrometers, 100 micrometers, or 100. micrometers or Null.
    Programmatic Pattern: (FilterSizeP | Automatic) | Null

    InLineFilter

    The filter that is used to remove impurities from the samples right after they are removed from the dissolution vessel and prior to the liquid entering the autosampler for optinal secondary filtration.
    Default Value: Automatic
    Default Calculation: Automatically set to a Filter with the specified InLineFilterMaterial and InLineFilterPoreSize, if none are specified, automatically set to Model[Item,Filter,"QLA 45um UHMW PE inline filter for Distek Autosampler"] if InLineFiltration is in the FilterSamples list.
    Pattern Description: An object of type or subtype Model[Item, Filter] or Null.
    Programmatic Pattern: (ObjectP[{Model[Item, Filter]}] | Automatic) | Null

    CannulaTipFilterMaterial

    The material of the cannula tip filter used to filter samples during transfer.
    Default Value: Automatic
    Default Calculation: Automatically set to match the material of the CannulaTipFilter if specified, otherwise set to UHMWPE when CannulaTipFiltration is in the FilterSamples list.
    Pattern Description: Cellulose, Cotton, Polyethylene, Polypropylene, PTFE, wwPTFE, Nylon, PES, PLUS, PVDF, GlassFiber, GHP, UHMWPE, EPDM, DuraporePVDF, GxF, ZebaDesaltingResin, NickelResin, AgaroseResin, CobaltResin, Silica, HLB, or AnoporeAlumina or Null.
    Programmatic Pattern: (FilterMembraneMaterialP | Automatic) | Null

    CannulaTipFilterPoreSize

    The pore size of the cannula tip filter used to filter samples during transfer.
    Default Value: Automatic
    Default Calculation: Automatically set to match the pore size of the CannulaTipFilter if specified, otherwise set to 10 Micrometer when CannulaTipFiltration is in the FilterSamples list.
    Pattern Description: 0.008 micrometers, 0.02 micrometers, 0.1 micrometers, 0.2 micrometers, 0.22 micrometers, 0.45 micrometers, 1 micrometer, 1. micrometer, 1.1 micrometers, 2.5 micrometers, 6 micrometers, 6. micrometers, 10 micrometers, 10. micrometers, 20 micrometers, 20. micrometers, 30 micrometers, 30. micrometers, 35 micrometers, 35. micrometers, 45 micrometers, 45. micrometers, 70 micrometers, 70. micrometers, 100 micrometers, or 100. micrometers or Null.
    Programmatic Pattern: (FilterSizeP | Automatic) | Null

    CannulaTipFilter

    The filter model attached to cannula tips for filtering samples during transfer from dissolution vessel to collection container.
    Default Value: Automatic
    Default Calculation: Automatically set to a filter matching CannulaTipFilterMaterial and CannulaTipFilterPoreSize when CannulaTipFiltration is in FilterSamples list.
    Pattern Description: An object of type or subtype Model[Item, Filter] or Null.
    Programmatic Pattern: (ObjectP[{Model[Item, Filter]}] | Automatic) | Null

    InfinityMixing

    InfinityMix

    Indicates if additional mixing at higher rotational speed will be performed at the end of the MixTime. The Infinity Mixing period is used to achieve the final saturation point.
    Default Value: Automatic
    Default Calculation: Automatically set to True if Sampling is set to True, otherwise set to False.
    Pattern Description: True or False.
    Programmatic Pattern: BooleanP | Automatic

    InfinityMixRate

    The frequency of rotation used by the dissolution instrument at the end of the experiment to achieve final dissolution condition. This is typically set to a higher value than the MixRate to achieve the final saturation point.
    Default Value: Automatic
    Default Calculation: Automatically set to MixRate + 50RPM (up to the maximum rotation rate supported by the instrument) if InfinityMix is set to True.
    Pattern Description: Greater than or equal to 25 revolutions per minute and less than or equal to 350 revolutions per minute or Null.
    Programmatic Pattern: (RangeP[25*RPM, 350*RPM] | Automatic) | Null

    InfinityMixTime

    Duration of time for which the samples will be mixed at InfinityMixRate after MixTime to achieve the final saturation point.
    Default Value: Automatic
    Default Calculation: Automatically set to 20 Minutes if InfinityMix is set to True.
    Pattern Description: Greater than or equal to 0 minutes and less than or equal to 72 hours or Null.
    Programmatic Pattern: (RangeP[0*Minute, $MaxExperimentTime] | Automatic) | Null

    System Suitability

    PerformSystemSuitability

    Indicates if a system suitability test is performed before processing experimental samples. The test validates autosampler and collection system functionality by collecting media-only samples (using the same Media specified for the main experiment) at a single 5-minute timepoint and verifying collected volume meets expected volume within SystemSuitabilityTolerance. If the first attempt fails, the autosampler is power cycled, filters and containers are replaced, and the test retries SystemSuitabilityAttempts times. If all system suitability attempts fail, the protocol skips the main experiment run and marks the protocol as SystemSuitabilityPassed False.
    Default Value: Automatic
    Default Calculation: Automatically set to True if SystemSuitabilityTolerance or SystemSuitabilityAttempts are specified. Otherwise set to False.
    Pattern Description: True or False.
    Programmatic Pattern: BooleanP | Automatic

    SystemSuitabilityTolerance

    The acceptable deviation factor for collected sample volume from expected volume during system suitability testing. Volume is considered acceptable if actual volume is greater than or equal to (expected volume multiplied by tolerance factor). Expected volume is calculated from SamplingVolume.
    Default Value: Automatic
    Default Calculation: Automatically set to 0.33 (33% of expected volume) if PerformSystemSuitability is True.
    Pattern Description: Greater than or equal to 0 and less than or equal to 1 or Null.
    Programmatic Pattern: (RangeP[0, 1] | Automatic) | Null

    SystemSuitabilityAttempts

    The number of times the system suitability test will be attempted. Between the attempts, the autosampler is power cycled and the filters are changed.
    Default Value: Automatic
    Default Calculation: Automatically set to 2 if PerformSystemSuitability is True.
    Pattern Description: Greater than 0 in increments of 1 or Null.
    Programmatic Pattern: (GreaterP[0, 1] | Automatic) | Null

    Post Experiment

    SamplesInStorageCondition

    The non-default conditions under which the SamplesIn of this experiment should be stored after the protocol is completed. If left unset, SamplesIn will be stored according to their current StorageCondition.
    Default Value: Null
    Pattern Description: {AmbientStorage, EnclosedAmbientStorage, Refrigerator, Freezer, DeepFreezer, CryogenicStorage, YeastIncubation, YeastShakingIncubation, BacterialIncubation, BacterialShakingIncubation, MammalianIncubation, ViralIncubation, CrystalIncubation, AcceleratedTesting, IntermediateTesting, LongTermTesting, UVVisLightTesting} or Disposal or Null.
    Programmatic Pattern: (Alternatives[SampleStorageTypeP | Disposal]) | Null
    Index Matches to: experiment samples

    SamplesOutStorageCondition

    The non-default conditions under which any new samples generated by this experiment should be stored after the protocol is completed. If left unset, the new samples will be stored according to their Models' DefaultStorageCondition.
    Default Value: Refrigerator
    Pattern Description: {AmbientStorage, EnclosedAmbientStorage, Refrigerator, Freezer, DeepFreezer, CryogenicStorage, YeastIncubation, YeastShakingIncubation, BacterialIncubation, BacterialShakingIncubation, MammalianIncubation, ViralIncubation, CrystalIncubation, AcceleratedTesting, IntermediateTesting, LongTermTesting, UVVisLightTesting} or Disposal or Null.
    Programmatic Pattern: (Null | (Alternatives[SampleStorageTypeP | Disposal])) | Null
    Index Matches to: experiment samples

Sample Prep Options

    Sample Preparation

    PreparatoryUnitOperations

    Specifies a sequence of transferring, aliquoting, consolidating, or mixing of new or existing samples before the main experiment. These prepared samples can be used in the main experiment by referencing their defined name. For more information, please reference the documentation for ExperimentSamplePreparation.
    Default Value: Null
    Pattern Description: List of one or more unit Operation ManualSamplePreparation or RoboticSamplePreparation or unit Operation must match SamplePreparationP entries or Null.
    Programmatic Pattern: {((ManualSamplePreparationMethodP | RoboticSamplePreparationMethodP) | SamplePreparationP)..} | Null

Protocol Options

    Organizational Information

    Template

    A template protocol whose methodology should be reproduced in running this experiment. Option values will be inherited from the template protocol, but can be individually overridden by directly specifying values for those options to this Experiment function.
    Default Value: Null
    Pattern Description: An object of type or subtype Object[Protocol] or an object of type or subtype of Object[Protocol] with UnresolvedOptions, ResolvedOptions specified or Null.
    Programmatic Pattern: (ObjectP[Object[Protocol]] | FieldReferenceP[Object[Protocol], {UnresolvedOptions, ResolvedOptions}]) | Null

    Name

    A object name which should be used to refer to the output object in lieu of an automatically generated ID number.
    Default Value: Null
    Pattern Description: A string or Null.
    Programmatic Pattern: _String | Null

    Post Experiment

    MeasureWeight

    Indicates if any solid samples that are modified in the course of the experiment should have their weights measured and updated after running the experiment. Please note that public samples are weighed regardless of the value of this option.
    Default Value: True
    Pattern Description: True or False or Null.
    Programmatic Pattern: (Null | BooleanP) | Null

    MeasureVolume

    Indicates if any liquid samples that are modified in the course of the experiment should have their volumes measured and updated after running the experiment. Please note that public samples are volume measured regardless of the value of this option.
    Default Value: False
    Pattern Description: True or False or Null.
    Programmatic Pattern: (Null | BooleanP) | Null

    ImageSample

    Indicates if any samples that are modified in the course of the experiment should be freshly imaged after running the experiment. Please note that public samples are imaged regardless of the value of this option.
    Default Value: False
    Pattern Description: True or False or Null.
    Programmatic Pattern: (Null | BooleanP) | Null

Example Calls

    Dissolve a sample in a medium with aliquots every 5 minutes

    Dissolve a sample in a medium with aliquots every 5 minutes using a paddle apparatus:
    Dissolve a sample in a medium with aliquots every 5 minutes using a paddle apparatus with sinker and infinite mixing:

Warnings and Errors

    Messages  (15)

    ContainersOutFootprintIncompatible  (1)

    Error when ContainersOut has incompatible footprint or MaxVolume:

    DegasSpecificationError  (1)

    Error when DegasTime specified but Degas is False:

    DiscardedSamples  (1)

    Error when using discarded samples:

    FilterSpecificationConflict  (1)

    Error when filter specifications conflict:

    IncompatibleAgitatorSinker  (1)

    Error when sinker used with Basket strategy:

    InfinityMixRateConflict  (1)

    Warning when InfinityMixRate is not greater than MixRate:

    InsufficientFlowRates  (2)

    Error when flow rates are below higher minimums required with ReplaceMedium -> True:

    Error when user-specified flow rates are below the minimum for 5-minute sampling interval:

    MaxNumberOfAliquots  (1)

    Error when too many aliquots requested exceeds instrument capacity:

    NumberOfAliquotsConflict  (1)

    Error when NumberOfAliquots conflicts with SamplingTime length:

    ReplacementMediumMismatch  (1)

    Warning for single replacement medium that doesn't match medium used in the experiment:

    SamplingIntervalTooShort  (1)

    Error when sampling interval is less than the 5-minute instrument minimum:

    SamplingTimeSpecificationIssue  (2)

    Error when sampling times are not in ascending order:

    Error when sampling times have duplicates:

    ShortMixTime  (1)

    Error when mix time is insufficient for sampling schedule:

Last modified on Wed 8 Apr 2026 14:02:52

EMERALD CLOUD LAB
15500 Wells Port Drive
Austin, TX 78728
© 2025 Emerald Cloud Lab, Inc.