CollectionSearch Subclasses

Collection-specific subclasses are the recommended public entry points. Each class inherits CollectionSearch behavior while preconfiguring a collection target.

Choosing a Subclass

• Pick the subclass matching the record type you want to query.

• Use inherited methods such as get_record_by_id, get_record_by_attribute, get_record_by_filter, and get_records.

• See Using MongoDB filters for query construction and operator examples.

• NMDC Schema reference: https://microbiomedata.github.io/nmdc-schema/

• Typecode-to-class map: https://microbiomedata.github.io/nmdc-schema/typecode-to-class-map/

Biosample and Study Related

These classes focus on study-level and site-level discovery. Use them when starting from study metadata, biosamples, or collection events.

class nmdc_api_utilities.biosample_search.BiosampleSearch(api_base_url='https://api.microbiomedata.org', env='')

Bases: CollectionSearch, LatLongFilters

Class to interact with the NMDC API to search for records within the biosample_set collection.

class nmdc_api_utilities.study_search.StudySearch(api_base_url='https://api.microbiomedata.org', env='')

Bases: CollectionSearch

Class to interact with the NMDC API to search for records within the study_set collection.

class nmdc_api_utilities.collecting_biosamples_from_site_search.CollectingBiosamplesFromSiteSearch(api_base_url='https://api.microbiomedata.org', env='')

Bases: CollectionSearch

Class to interact with the NMDC API to search for records within the collecting_biosamples_from_site_set collection.

class nmdc_api_utilities.field_research_site_search.FieldResearchSiteSearch(api_base_url='https://api.microbiomedata.org', env='')

Bases: LatLongFilters, CollectionSearch

Class to interact with the NMDC API to search for records within the field_research_site_set collection.

Sample Processing Related

These classes target records produced through sample processing lifecycle, including processed sample entities and upstream material/storage processes. Use NMDC Schema docs to confirm class semantics and filterable fields.

class nmdc_api_utilities.processed_sample_search.ProcessedSampleSearch(api_base_url='https://api.microbiomedata.org', env='')

Bases: CollectionSearch

Class to interact with the NMDC API to search for records within the processed_sample_set collection.

class nmdc_api_utilities.material_processing_search.MaterialProcessingSearch(api_base_url='https://api.microbiomedata.org', env='')

Bases: CollectionSearch

Class to interact with the NMDC API to search for records within the material_processing_set collection.

class nmdc_api_utilities.storage_process_search.StorageProcessSearch(api_base_url='https://api.microbiomedata.org', env='')

Bases: CollectionSearch

Class to interact with the NMDC API to search for records within the storage_process_set collection.

Data Generation Related

These classes cover records tied to generation setup and instrumentation. Use schema and typecode map when selecting classes for linked-instance queries.

class nmdc_api_utilities.data_generation_search.DataGenerationSearch(api_base_url='https://api.microbiomedata.org', env='')

Bases: CollectionSearch

Class to interact with the NMDC API to search for records within the data_generation_set collection.

class nmdc_api_utilities.manifest_search.ManifestSearch(api_base_url='https://api.microbiomedata.org', env='')

Bases: CollectionSearch

Class to interact with the NMDC API to search for records within the manifest_set collection.

class nmdc_api_utilities.instrument_search.InstrumentSearch(api_base_url='https://api.microbiomedata.org', env='')

Bases: CollectionSearch

Class to interact with the NMDC API to search for records within the instrument_set collection.

class nmdc_api_utilities.configuration_search.ConfigurationSearch(api_base_url='https://api.microbiomedata.org', env='')

Bases: CollectionSearch

Class to interact with the NMDC API to search for records within the configuration_set collection.

Data and Processing Related

These classes are useful for workflow context, calibration context, data objects, and functional annotation aggregation outputs. Use NMDC Schema docs for exact field meanings and schema class names.

class nmdc_api_utilities.workflow_execution_search.WorkflowExecutionSearch(api_base_url='https://api.microbiomedata.org', env='')

Bases: CollectionSearch

Class to interact with the NMDC API to search for records within the workflow_execution_set collection.

class nmdc_api_utilities.calibration_search.CalibrationSearch(api_base_url='https://api.microbiomedata.org', env='')

Bases: CollectionSearch

Class to interact with the NMDC API to search for records within the calibration_set collection.

class nmdc_api_utilities.data_object_search.DataObjectSearch(api_base_url='https://api.microbiomedata.org', env='')

Bases: CollectionSearch

Class to interact with the NMDC API to search for records within the data_object_set collection.

get_data_objects_for_studies(study_id, max_page_size=None)

(Deprecated) This method is deprecated. Use get_data_objects_for_study instead.

Return type:

list[dict]

get_data_objects_for_study(study_id)

Get all data objects related to the specified study.

Parameters:

study_id (str) – The ID of the study.

Returns:

The data objects.

Return type:

list[dict]

Raises:

RuntimeError – If the API request fails.

class nmdc_api_utilities.functional_annotation_agg_search.FunctionalAnnotationAggSearch(api_base_url='https://api.microbiomedata.org', env='')

Bases: FunctionalSearch

Class to interact with the NMDC API to search for records within the functional_annotation_agg collection.

These are most helpful when trying to identify workflows associated with a KEGG, COG, or PFAM ids.