ecl-logo Documentation
ECL`

UploadStockSolution

UploadStockSolution[Components,Solvent,TotalVolume]⟹StockSolutionModel

creates a new StockSolutionModel for combining Components and using Solvent to fill to TotalVolume after initial component combination.

UploadStockSolution[Components]⟹StockSolutionModel

creates a new StockSolutionModel that is prepared by combining all samples as specified in the Components.

UploadStockSolution[TemplateStockSolution]⟹StockSolutionModel

creates a new StockSolutionModel using the formula from the TemplateStockSolution and drawing any preparation parameter defaults from the TemplateStockSolution.

UploadStockSolution[UnitOperations]⟹StockSolutionModel

creates a new StockSolutionModel that is prepared by following the specified UnitOperations.

Details

  • If an existing stock solution model is found that matches all of the parameters specified for the new stock solution model, the existing model is returned in a simplified packet.
  • However if a Name is explicitly provided, a new stock solution model will ALWAYS be uploaded.
  • Stock solution models generated with this function may be then prepared via ExperimentStockSolution.
  • ExperimentStockSolution also has an overload that directly calls this function.
  • Components will be combined in the following order:     1.) All solids are combined first in the provided order     2.) All liquids will be added in the provided order, except for acids and bases     3.) (optional): Fill-to-volume additions will be made to the provided total volume     4.) All liquids that are acids and bases will be added
    • Input
    Output
    Autoclaving Options
    Compatibility Options
    Filtration Options
    Health & Safety Options
    Incubation Options
    Mixing Options
    Organizational Information Options
    pHing Limits Options
    pH Titration Options
    Physical Properties Options
    Preparation Options
    Preparation Information Options
    Storage Information Options

Examples

open allclose all

Example Setup

These expressions are used in the examples to follow:

Basic Examples  (5)

Create a model for a 50% (v/v) methanol/water solution:

Create a model for a 50% (v/v) methanol/water solution:

Create a model for a salt solution filled to a total volume of 1L with deionized water:

Create a model for a solution of multiple solid components with a total volume of 1L:

Create a model for a stock solution based on unit operations:

Additional Examples  (21)

A stock solution formula including a tablet component will not have a unit associated with the component amount:

A stock solution including a fixed-aliquot sample populates the VolumeIncrements field:

A stock solution including a fixed amounts sample has the Resuspension resolved to True automatically:

A stock solution including a tablet component will automatically be marked as only preparable in multiples that require equal or less than the lowest of all tablet counts:

Create a model for a solution in which a solid component is a tablet by specifying a particular count of tablets to be included in the mixture:

Create a model for a stock solution based on various unit operations:

Formula components may themselves be stock solutions:

If an existing stock solution model is found in Constellation that has the exact same formula components in the same ratios, as well as identical preparation parameters, that model is returned in lieu of generating a new model:

Liquid components can be specified with amounts that have units of mass:

Only the Formula field is populated for a stock solution with no specified solvent or fill-to volume:

Safety information of the stock solution is automatically resolved based on the formula components:

The Formula, FillToVolumeSolvent, and TotalVolume fields in the uploaded stock solution model are populated with the provided inputs for a fill-to-volume style solution:

The solvent of a solution may itself be a stock solution:

Formula Issues  (7)

Formula components cannot be deprecated:

Formula components must be unique:

If no solvent is explicitly provided, the mixture of all solids will be a new stock solution with State->Solid:

Only solids and liquids are supported as formula components:

Tablet components must be specified in amounts that are tablet counts, not masses:

The solvent must be a liquid if explicitly provided:

The sum of the volumes of any formula components should not exceed the requested total volume of the solution:

Template Input  (1)

A template stock solution may also be provided directly as an input; this template specification will use the Formula from the template solution as the new solution's formula, as well as using preparation parameters in the template for option defaults:

Options  (112)

Acid  (2)

Acid and Base storage cannot be simultaneously required for a stock solution:

Indicates if this stock solution is a strong acid (pH <= 2) and samples of this stock solution model require dedicated secondary containment during storage:

AdjustpH  (1)

Specify whether to adjust the pH following component combination and mixing; if AdjustpH->True and NominalpH is not specified, it is automatically set to 7:

Autoclave  (1)

Use Autoclave option to indicate if the stock solution should be autoclaved:

AutoclaveProgram  (1)

Use AutoclaveProgram option to specify the autoclave program:

Base  (2)

Acid and Base storage cannot be simultaneously required for a stock solution:

Indicates if this stock solution is a strong base (pH >= 12) and samples of this stock solution model require dedicated secondary containment during storage:

CentrifugeIncompatible  (1)

Specify that a stock solution model is centrifuge incompatible:

Composition  (2)

Calculate the composition correctly from the formula:

Use Composition option to specify the composition:

DefaultStorageCondition  (2)

Automatically resolves based on the lowest required temperature of any formula components:

Indicate the temperature conditions in which samples of this stock solution should be stored. This default condition can be overridden for specific samples using the function StoreSamples:

Density  (1)

If known explicitly, specify the density that should be associated with this mixture. This will allow samples of this stock solution model to have their volumes measured via the gravimetric method:

DiscardThreshold  (1)

Specify the percentage of the prepared stock solution volume below which the sample will be automatically marked as AwaitingDisposal:

Expires  (3)

If Expires is set to False, ShelfLife/UnsealedShelfLife cannot also be set:

If the stock solution is stable and should never be automatically disposed, set Expires to False:

Indicate if stock solution samples of this model expire after a given amount of time (specifiable via the ShelfLife option). Expired samples may be subjected to automated disposal:

ExtinctionCoefficients  (1)

Indicate how strongly this chemical absorbs light at a given wavelength:

FillToVolumeMethod  (1)

Specify the method by which the fill to volume stock solution should be prepared:

Filter  (4)

Indicate if the stock solution should be filtered following component combination, filling to volume with solvent, mixing, and/or pH titration; the resulting stock solution model will have default filtration parameters assigned:

Indicate if the stock solution should NOT be filtered following component combination, filling to volume with solvent, mixing, and/or pH adjustment; the resulting stock solution model will not have any filtration parameters populated:

The total preparation volume of the stock solution must exceed a minimum threshold for filtration to ensure that a method with low enough dead volume is available:

This boolean option must be set to True in order to set specific filtration parameters:

FilterMaterial  (1)

Specify a filter material through which this solution should be filtered following component combination, filling to volume with solvent, mixing, and/or pH titration:

FilterSize  (1)

Specify the size of the pores through which this solution should be filtered after component combination, filling to volume with solvent, mixing, and/or pH titration:

Flammable  (1)

Indicates if samples of this stock solution are easily set aflame under standard conditions:

Fuming  (1)

Indicates if samples of this stock solution emit fumes spontaneously when exposed to air:

IncompatibleMaterials  (1)

Provide a list of materials which may be damaged when wetted by this stock solution:

Incubate  (5)

Indicate if the stock solution should be incubated following component combination and filling to volume with solvent; if Mix->True and Incubate->True, will resolve to 30 Celsius:

Indicate if the stock solution should be incubated following component combination and filling to volume with solvent; if the resulting stock solution has Mix->False but Incubate->True, IncubationTime will be populated:

Indicate if the stock solution should be incubated following component combination and filling to volume with solvent; if the resulting stock solution is resolved to mix AND incubate, MixTime and IncubationTime will be populated with the same thing:

Indicate if the stock solution should NOT be incubated following component combination; the resulting stock solution model will have no incubation information:

Setting Incubate to False but specifying incubation parameters results in an error:

IncubationTemperature  (1)

Set the temperature at which the stock solution should be incubated following component combination, filling to volume with solvent, and mixint:

IncubationTime  (1)

Set the duration for which the stock solution should be incubated following component combination and filling to volume with solvent, while mixing:

LightSensitive  (2)

Indicate if a solution is sensitive to light exposure and should be stored in light-blocking containers when possible:

This option automatically resolves to True if any components in the provided formula are themselves marked as LightSensitive:

MaxAcidAmountPerCycle  (1)

Returns specified MaxAcidAmountPerCycle:

MaxBaseAmountPerCycle  (1)

Returns specified MaxBaseAmountPerCycle:

MaxMixTime  (3)

An upper bound on mixing time should only be provided if mixing until dissolution with MixTime specified:

Set a maximum duration for which the stock solution should be mixed in an attempt to dissolve any solid components following component combination and filling to volume with solvent:

This maximum will resolve automatically if a mix time to start with is provided:

MaxNumberOfMixes  (1)

Specify the max number of mixes. If specified, MixType must be Invert or Pipette and MixUntilDissolved must be True:

MaxNumberOfpHingCycles  (1)

Returns specified MaxNumberOfpHingCycles:

MaxpH  (3)

MaxpH cannot be specified if AdjustpH is set to False:

MaxpH will automatically resolve to 0.1 above the NominalpH if that option is specified:

Specify the maximum pH this solution should be allowed to have following component combination and mixing:

MaxpHingAdditionVolume  (1)

Returns specified MaxpHingAdditionVolume:

MinpH  (3)

MinpH cannot be specified if AdjustpH is set to False:

MinpH will automatically resolve to 0.1 below the NominalpH if that option is specified:

Specify the minimum pH this solution should be allowed to have following component combination and mixing:

Mix  (3)

Indicate if the stock solution should be mixed following component combination and filling to volume with solvent; the resulting stock solution model will have default mixing parameters assigned:

Indicate if the stock solution should NOT be mixed following component combination; the resulting stock solution model will have no mixing information:

Setting Mix to False but specifying mixing parameters results in an error:

Mixer  (1)

Specify the model of mixer with which you want this stock solution to be mixed. In order to specify this, MixType must also be specified:

MixRate  (1)

Specify the rate of mixing by which you want this stock solution to be mixed. In order to specify this, MixType must also be specified:

MixTime  (1)

Set the duration for which the stock solution should be mixed following component combination and filling to volume with solvent:

MixType  (1)

Specify the type of mixing by which you want this stock solution to be mixed:

MixUntilDissolved  (1)

Indicate if the stocksolution should be mixed in an attempt to completed dissolve any solid components following component combination and filling to volume with solvent:

Name  (2)

If a Name is already in use in Constellation, a new stock solution cannot also get that Name:

Name the new stock solution model being created:

NominalpH  (5)

If MinpH and MaxpH are specified, choose the mean between them to resolve NominalpH:

If pH titration is requested, the preparation volume of the provided stock solution formula must exceed the minimum threshold to ensure the smallest pH probe can fit in any container in which this formula can be combined:

Specify the pH to which this solution should be adjusted following component combination and mixing:

The MinpH, MaxpH, pHingAcid and pHingBase can be automatically resolved if a NominalpH is set:

The NominalpH, MinpH, and MaxpH options should be in appropriate numerical order:

NumberOfMixes  (1)

Specify the number of mixes. If specified, MixType must be Invert or Pipette:

OrderOfOperations  (1)

Indicate the order in which the stock solution should be prepared:

pHingAcid  (3)

A pHingAcid cannot be specified if AdjustpH is set to False:

Specify the solution that should be used to adjust the pH of this solution downwards following component combination and mixing:

The pHingAcid will automatically resolve to 2 M HCl if a NominalpH is specified:

pHingBase  (3)

A pHingBase cannot be specified if AdjustpH is set to False:

Specify the solution that should be used to adjust the pH of this solution upwards following component combination and mixing:

The pHingBase will automatically resolve to 1.85 M NaOH if a NominalpH is specified:

PostAutoclaveIncubate  (1)

Use PostAutoclaveIncubate and related options to specify the autoclave program:

PostAutoclaveIncubationTemperature  (1)

Use PostAutoclaveIncubate and related options to specify the autoclave program:

PostAutoclaveIncubationTime  (1)

Use PostAutoclaveIncubate and related options to specify the autoclave program:

PostAutoclaveMaxMixTime  (1)

Use PostAutoclaveMix and related options to specify the autoclave program:

PostAutoclaveMaxNumberOfMixes  (1)

Use PostAutoclaveNumberOfMixes and related options to specify the autoclave program:

PostAutoclaveMix  (1)

Use PostAutoclaveMix and related options to specify the autoclave program:

PostAutoclaveMixer  (1)

Use PostAutoclaveMix and related options to specify the autoclave program:

PostAutoclaveMixTime  (1)

Use PostAutoclaveMix and related options to specify the autoclave program:

PostAutoclaveMixType  (1)

Use PostAutoclaveMix and related options to specify the autoclave program:

PostAutoclaveMixUntilDissolved  (1)

Use PostAutoclaveMix and related options to specify the autoclave program:

PostAutoclaveNumberOfMixes  (1)

Use PostAutoclaveNumberOfMixes and related options to specify the autoclave program:

PreferredContainers  (1)

Specify the containers you'd like the sample to be stored and prepared in, whenever possible:

Preparable  (2)

If Preparable->False, skip error checking that is only relevant to preparation in ExperimentStockSolution:

Specify whether a stock solution might be preparable in ExperimentStockSolution:

PrepareInResuspensionContainer  (1)

Use PrepareInResuspensionContainer options to indicate if the stock solution should be prepared in the original container of the fixed amounts component in the formula:

Resuspension  (1)

Use Resuspension options to indicate if the stock solution has a fixed amount component that should be resuspended in its original container first:

SafetyOverride  (1)

If the order of the components are such that liquid acids are added before other liquid components and the solution is safe to create, specify a safety override:

ShelfLife  (3)

Automatically resolves to 5 years if Expires is set to True and no formula components have shelf lives:

Automatically resolves to the shortest of the shelf lives of any formula components:

Specify the length of time after preparation (but without being used) that samples of this stock solution are recommended for use before they should be discarded:

StockSolutionTemplate  (9)

A template may also be provided directly as an input; this template specification will use the Formula from the template solution as the new solution's formula:

Draw filtration defaults from an existing template, overriding the filter and material with new values:

Draw incubation defaults from an existing template, overriding the incubation parameters with new values:

If a provided template model is deprecated, it will not be used as a source of default option values:

If BOTH the template input and option are used, and the option differs from the input, the option will be ignored in favor of the direct input:

If the template is not specified but a model is provided, the Template option resolves to that model:

Provide a stock solution model from which to draw default options:

The type of the new stock solution matches the type of the input sample:

Use preparation defaults from an existing solution for a different formula:

Synonyms  (1)

Provide synonyms by which this solution can also be found via Search or ObjectSelect. Note that the provided Name will always be duplicated as a synonym:

TransportTemperature  (2)

Indicate at what temperature samples of this stock solution should be refrigerated during transport when used in experiments:

Indicate at what temperature samples of this stock solution should be refrigerated during transport when used in experiments:

Type  (3)

Specify the SLL type of the new media model being created, with the UsedAsMedia field automatically set to True:

Specify the SLL type of the new stock solution model being created:

Specify the SLL type of the new stock solution model being created, which works for Standards too:

UltrasonicIncompatible  (4)

Automatically resolves to True if 50% or more of the volume consists of UltrasonicIncompatible chemicals:

Automatically resolves to True if 50% or more of the volume consists of UltrasonicIncompatible chemicals (including the solvent in FillToVolume solutions):

Override automatic resolution if specifying UltrasonicIncompatible manually:

Pass the UltrasonicIncompatible option down from the provided template:

UnsealedShelfLife  (4)

Automatically resolves to match ShelfLife if Expires is set to True and no formula components have unsealed shelf lives:

Automatically resolves to the shortest of the unsealed shelf lives of any formula components:

A warning is provided if the provided UnsealedShelfLife is longer than the provided ShelfLife:

Specify the length of time after first use that samples of this stock solution are recommended for use before they should be discarded:

Ventilated  (1)

Indicate if samples of this stock solution should be handled in a ventilated enclosure:

VolumeIncrements  (2)

Single VolumeIncrements are allowed:

Specify the volumes at which a given stock solution might be prepared:

Messages  (61)

AcidBaseConflict  (1)

Acid and Base storage cannot be simultaneously required for a stock solution:

BelowFillToVolumeMinimum  (2)

The solvent volume in a FillToVolume stock solution for Volumetric method has lower limits:

The solvent volume in a FillToVolume stock solution may not be outside of RangeP[$MinStockSolutionUltrasonicSolventVolume, $MaxStockSolutionComponentVolume]:

ComponentAmountOutOfRange  (3)

If the provided liquid amount is above the maximum allowed in the ECL, throw an error:

If the provided solid amount is above the maximum allowed in the ECL, throw an error:

If the provided solid amount is below the minimum allowed in the ECL, throw an error:

ComponentOrder  (7)

If in a fill-to-volume stock solution and using an acid, alter the formula to add some of the fill-to-volume solvent before adding the acid, and filling to the requested volume after:

If in a fill-to-volume stock solution and using an acid and there is another UsedAsSolvent liquid added before the acid to a sufficient amount, no warning is thrown and the input order is respected:

If in a fill-to-volume stock solution and using more than one acid, if at the addition of any acid and there is not sufficient UsedAsSolvent liquid added before for the combined acid volume, throw a warning and adjust the order:

If in a formula-only stock solution and using an acid and there is UsedAsSolvent liquid added before the acid to a sufficient amount, no warning is thrown and the input order is respected:

If in a formula-only stock solution and using more than one acid, if at the addition of any acid and there is not sufficient UsedAsSolvent liquid added before for the combined acid volume, and we are adding more liquid to it, throw a warning and adjust the order:

If in a formula-only stock solution and using more than one acid, if at the addition of any acid and there is not sufficient UsedAsSolvent liquid added before for the combined acid volume, but we are not adding more liquid to it, no warning is thrown and the input order is respected:

If the order of the components are such that liquid acids are added before other liquid components, throw a warning and change the order:

ComponentRequiresTabletCount  (1)

Tablet components must be specified in amounts that are tablet counts, not masses:

ComponentStateInvalid  (1)

Only solids and liquids are supported as formula components:

ConflictingUnitOperationsOptions  (1)

An error will be thrown if a preparation option is specified when using the unit operations input:

DeprecatedComponents  (1)

Formula components cannot be deprecated:

DeprecatedTemplate  (3)

A template model used as input cannot be deprecated:

A template model used as input cannot be deprecated:

If a provided template model is deprecated, it will not be used as a source of default option values:

DuplicatedComponents  (1)

Formula components must be unique:

ExistingModelReplacesInput  (1)

A warning will be thrown if an existing model fulfills the input template model with specified options:

ExpirationShelfLifeConflict  (1)

If Expires is set to False, ShelfLife/UnsealedShelfLife cannot also be set:

FilterOptionConflictUSS  (1)

This boolean option must be set to True in order to set specific filtration parameters:

FormulaVolumeTooLarge  (2)

An error will be thrown if the input formula has the combined total volume of its components equal to or exceeds the model's TotalVolume:

The sum of the volumes of any formula components should not exceed the requested total volume of the solution:

IncubateOptionConflict  (1)

Setting Incubate to False but specifying incubation parameters results in an error:

InvalidFillToVolumeMethodNoSolvent  (1)

Solvent must be specified if a fill to volume method is specified:

InvalidLabelContainerUnitOperationInput  (1)

An error will be thrown if a the unit operations input does not start with a LabelContainer unit operation:

InvalidOrderOfOperations  (5)

Filtration must occur last (if present):

FixedReagentAddition must occur first:

Incubation (if present) must occur after any pHTitration/FillToVolume:

OrderOfOperations should be consistent with other options:

OrderOfOperations should not have duplicates:

InvalidOrderOfOperationsForpH  (1)

pHTitration must occur after any liquid is added:

InvalidPreparationInResuspensionContainer  (1)

If there is no fixed amounts sample in the formula, PrepareInResuspensionContainer cannot be True:

InvalidResuspensionAmounts  (1)

When PrepareInResuspensionContainer is True, the amount of the fixed amounts component in the formula has to be a member of its FixedAmounts field:

InvalidResuspensionOption  (1)

A stock solution including a fixed-aliquot sample cannot have the Resuspension set to False:

InvalidUltrasonicFillToVolumeMethod  (1)

An error will be thrown when the FillToVolumeMethod is incompatible with the stock solution being prepared (Methanol is UltrasonicIncompatible):

InvalidVolumetricFillToVolumeMethod  (3)

The solvent volume in a Volumetric FillToVolume light-sensitive stock solution cannot exceed the volume of the largest opaque volumetric flask:

The solvent volume in a Volumetric FillToVolume stock solution cannot exceed the volume of the largest volumetric flask:

The solvent volume in a Volumetric FillToVolume stock solution that is incompatible with Glass cannot exceed the volume of the largest polypropylene volumetric flask:

MixOptionConflict  (1)

Setting Mix to False but specifying mixing parameters results in an error:

MixTimeIncubateTimeMismatch  (1)

If MixTime and IncubationTime are both specified, they must be the same:

MixTypeRequired  (2)

If Mixer is specified, MixType must also be specified:

If MixRate is specified, MixType must also be specified:

NewModelCreation  (1)

A warning will be thrown if a new model is created when using template model input:

NoNominalpH  (2)

A pHingBase cannot be specified if AdjustpH is set to False:

MinpH cannot be specified if AdjustpH is set to False:

pHOrderInvalidUSS  (1)

The NominalpH, MinpH, and MaxpH options should be in appropriate numerical order:

SolventNotLiquid  (1)

The solvent must be a liquid if explicitly provided:

SpecifedMixRateNotSafe  (2)

If given formula, a warning will be thrown if the specified mix rate is over the safe mix rate of the container:

If given model stock solution, a warning will be thrown if the specified mix rate is over the safe mix rate of the container, and a new model will be generated with the specified mix rate:

StockSolutionNameInUse  (1)

If a Name is already in use in Constellation, a new stock solution cannot also get that Name:

StorageCombinationUnsupported  (1)

Acid and Base storage cannot be simultaneously required for a stock solution:

TemplateOptionUnused  (1)

If BOTH the template input and option are used, and the option differs from the input, the option will be ignored in favor of the direct input:

UnitOperationInvalidVolumeIncrement  (1)

An error will be thrown the specified VolumeIncrements are not multiples of the total volume of the resulting sample:

UnitOperationsContainObject  (1)

An error will be thrown if unit operations have objects in them:

UnsealedShelfLifeLonger  (1)

A warning is provided if the provided UnsealedShelfLife is longer than the provided ShelfLife:

VolumeBelowFiltrationMinimum  (1)

The total preparation volume of the stock solution must exceed a minimum threshold for filtration to ensure that a method with low enough dead volume is available:

VolumeBelowpHMinimum  (1)

If pH titration is requested, the preparation volume of the provided stock solution formula must exceed the minimum threshold to ensure the smallest pH probe can fit in any container in which this formula can be combined:

Last modified on Thu 22 Jan 2026 09:51:35

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