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.