ecl-logo Documentation
ECL`

AnalyzeComposition

AnalyzeComposition[Protocol]Object

analyzes the chemical composition of chromatogram peaks in a HPLC protocol.

Details

    Input
    Output
    Standards Options
    Upload Options
    Method Options

Examples

open allclose all

Example Setup

These expressions are used in the examples to follow:

Basic Examples  (3)

Concentrations are calculated by fitting, for each analyte, a standard curve mapping analyte peak area to analyte concentration in input protocol Standards. Both standards and assays must have their HPLC data peak-picked. Analytes are considered to be the set of all Model[Molecule] objects assigned to peaks in the StandardData objects:

Given an HPLC protocol containing Standards with known concentrations of analytes, and SamplesIn containing unknown assays, compute the concentration of analytes in each assay sample:

The concentrations of standards and assays are stored in the StandardCompositions and AssayCompositions fields of the resulting analysis object:

Options  (9)

ExcludeStandard  (1)

Provide the indices of the standards that should be excluded from the analysis:

Name  (1)

Name to be used as the name of Object[Analysis, Composition] generated by the analysis:

PreferredConcentrationType  (2)

AnalyzeComposition will attempt to convert concentrations to MolarConcentration by default:

Attempt to convert concentrations to mass concentrations. If not enough information (molecular weights, densities, sample volumes) is available from the analyte models, concentrations will remain in their original units:

StandardConcentrations  (2)

Explicitly specify the concentrations of analyte for each Standard object in the protocol with arbitrary concentration units, using a list of {analyte,concentration} pairs for each Standard:

StandardConcentrations will default to concentrations computed from the Composition field(s) of the objects in the Standard field of input protocol. Empty entries {} indicate no analytes could be assigned to picked-peaks in StandardData:

StandardData  (2)

Explicitly specify the Object[Data] measurements to use as standards for the composition analysis:

StandardData defaults to using the StandardData field in the input protocol:

UpdateSampleComposition  (1)

Indicate whether the Composition fields of objects in the StandardsIn field of the input protocol should be updated with the results of this analysis:

Messages  (11)

AnalytesNotFound  (1)

Show a warning if any of the analyte concentrations specified in StandardConcentrations cannot be matched to picked peaks:

InvalidCompositionUpdate  (1)

Composition updating is only supported when standard concentrations are given in units that are compatible with supported units in CompositionP:

InvalidExcludeStandardsOption  (1)

Return a $Failed state if the ExcludeStandard option specifies indices which exceed the number of standards in the input protocol:

InvalidStandardConcentrationLength  (1)

If the length of the StandardConcentrations option does not match the length of the Standard field of the input protocol, a warning is displayed and the option will be ignored:

InvalidStandardDataLength  (1)

If the length of the StandardData option does not match the length of the Standard field of the input protocol, a warning is displayed and the option will be ignored:

InvalidStandardDataReferences  (1)

If the data objects in the StandardData option do not point to the same data objects as the Standards field of the input protocol, a warning is displayed and the option will be ignored:

InvalidStandardsNoPeaks  (1)

Warning shows if any of the Standards do not have analytes assigned to their peaks in StandardData. Set ExcludeStandard->Automatic to exclude these standards automatically:

NoAnalytesFoundInStandards  (1)

Warning shows if for at least one analyte, there are no standards with a non-zero concentration of that analyte. This handles the case where all standards have a zero concentration of a given analyte:

NoStandardsForSamples  (1)

Return a $Failed state if analytes of the SamplesIn of the input protocol cannot be matched to the composition of any included Standards:

NoStandardsFound  (1)

Protocols which are either missing standards or have not had their StandardData peak-picked will return an error:

StandardConcentrationIncompatibleUnits  (1)

All concentrations specified in StandardConcentrations must be given in compatible units:

Last modified on Fri 12 Sep 2025 18:00:55