ecl-logo Documentation

DiscardSamples

DiscardSamples[objects]updatedObjects

directs the ECL to permanently dispose of the provided objects along with their containers or contents as appropriate during the next daily maintenance cycle.

Details

  • Providing a sample results in both the sample and its container being discarded.
  • Samples can be un-marked for discarding up until the next daily maintenance cycle, using StoreSamples to reset the samples' storage condition:     e.g. StoreSamples[samples,Refrigerator]
  • Input
    Output
    General Options

Examples

Basic Examples  (3)

Mark a sample for disposal; it and its container will be discarded once they are not in use by any experiment:

Mark a plate for disposal; all samples within the container will be discarded:

Mark multiple samples for disposal:

Additional Examples  (3)

Mark multiple containers for disposal; all samples within the containers are also marked for disposal:

Mark a mixed list of samples and containers for disposal:

Marking a sample for disposal marks both the sample and its container as AwaitingDisposal:

Options  (5)

DiscardContainer  (5)

Indicate that the container of a fluid sample should be thrown out:

Normally, if a container is marked as reusable in its Model, discarding it will direct it to be dishwashed and restocked:

Set DiscardContainer to True to indicate that a normally reusable container should no longer be considered reusable, and be thrown out instead of dishwashed:

If a container is marked as non-reusable, discarding it will direct it to be thrown out:

Non-reusable containers must always be thrown out; DiscardContainer cannot be set to False:

Messages  (6)

ConflictingConditionsInContainer  (1)

If not all samples within the same container are provided, an error is thrown, as partial containers cannot be discarded:

ContainerDiscardRequired  (1)

Samples in non-reusable containers must be discarded along with their containers; DiscardContainer cannot be set to False:

DiscardedInputs  (1)

Samples already discarded cannot be discarded again:

InputLengthMismatch  (1)

If DiscardContainer is provided as a list, the list must have the same length as the input list:

ItemsContainerless  (1)

The DiscardContainer option will be ignored for items that are not moved around the lab inside an associated container:

OutstandingResources  (1)

A warning is thrown is samples with outstanding resources are discarded; the samples will not actually be discarded until the outstanding resources are fulfilled: