COMPS.Data.Suite module

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

Bases: TaggableEntity, CommissionableEntity, RelatableEntity, SerializableEntity

Represents a grouping of Experiments.

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

  • 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 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 Suites.

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

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

Returns:

A Suite or list of Suites (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 Suite from the server.

Parameters:

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

get_experiments(query_criteria=None)[source]

Retrieve Experiments contained in this Suite.

Parameters:

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:

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

save()[source]

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