COMPS.Data.Experiment module

class COMPS.Data.Experiment.Experiment(name, suite_id=None, description=None, configuration=None)[source]

Bases: TaggableEntity, CommissionableEntity, RelatableEntity, SerializableEntity

Represents a grouping of Simulations.

Contains various basic properties accessible by getters (and, in some cases, +setters):

  • id

  • +suite_id

  • +name

  • +description

  • owner

  • date_created

  • last_modified

Also contains “child objects” (which must be specifically requested for retrieval using the QueryCriteria.select_children() method of QueryCriteria):

  • tags

  • configuration

property id
property suite_id
property name
property description
property owner
property date_created
property last_modified
property tags
property configuration
classmethod get(id=None, query_criteria=None)[source]

Retrieve one or more Experiments.

Parameters:
  • id – The id (str or UUID) of the Experiment to retrieve

  • query_criteria – A QueryCriteria object specifying basic property filters and tag-filters to apply to the set of Experiments returned, as well as which properties and child-objects to fill for the returned Experiments

Returns:

An Experiment or list of Experiments (depending on whether ‘id’ was specified) with basic properties and child-objects assigned as specified by ‘query_criteria’

refresh(query_criteria=None)[source]

Update properties of an existing Experiment from the server.

Parameters:

query_criteria – A QueryCriteria object specifying which properties and child-objects to refresh on the Experiment

get_simulations(query_criteria=None)[source]

Retrieve Simulations contained in this Experiment.

Parameters:

query_criteria – A QueryCriteria object specifying basic property filters and tag-filters to apply to the set of Simulations returned, as well as which properties and child-objects to fill for the returned Simulations

Returns:

A list of Simulations with basic properties and child-objects assigned as specified by ‘query_criteria’

save()[source]

Save a single Experiment. If it’s a new Experiment, an id is automatically assigned.