omnipy.components.isa
ISA-Tab component package providing Investigation, Study, and Assay
models and datasets for working with ISA-Tab structured metadata.
| MODULE | DESCRIPTION |
|---|---|
datasets |
Datasets for ISA-JSON documents and flattened ISA-JSON records. |
flows |
Flows for transforming ISA-JSON datasets into flattened tabular-like structures. |
models |
|
| CLASS | DESCRIPTION |
|---|---|
FlattenedIsaJsonDataset |
Dataset containing flattened ISA-JSON records. |
FlattenedIsaJsonModel |
|
IsaAssayJsonSchema |
Schema describing an assay block in ISA-JSON. |
IsaCommentSchema |
Schema for comments attached to ISA objects. |
IsaDataSchema |
Schema for a data file entry in an ISA assay. |
IsaFactorSchema |
Schema for an experimental factor defined in a study. |
IsaFactorValueSchema |
Schema for values assigned to study factors. |
IsaInvestigationSchema |
Schema for an ISA investigation document. |
IsaJsonDataset |
Dataset containing validated ISA-JSON documents. |
IsaJsonModel |
Union model that accepts both common ISA investigation shapes. |
IsaMaterialAttributeSchema |
Schema for material attribute categories in ISA. |
IsaMaterialAttributeValueSchema |
Schema for assigned material attribute values. |
IsaMaterialSchema |
Schema for non-sample materials in ISA studies. |
IsaOntologyReferenceSchema |
Schema for ontology terms referenced in ISA metadata. |
IsaOntologySourceReferenceSchema |
Schema for ontology source references in ISA metadata. |
IsaOrganizationSchema |
Schema for organization entries referenced in ISA metadata. |
IsaPersonSchema |
Schema for people associated with ISA investigations. |
IsaProcessOrProtocolApplicationSchema |
Schema for process or protocol application steps in ISA workflows. |
IsaProcessParameterValueSchema |
Schema for protocol parameter values applied in process steps. |
IsaProtocolParameterSchema |
Schema for protocol parameters used by ISA process steps. |
IsaProtocolSchema |
Schema for protocols referenced by ISA process workflows. |
IsaPublicationSchema |
Schema for publication metadata linked to ISA investigations. |
IsaSampleSchema |
Schema for sample entities in ISA study materials. |
IsaSourceSchema |
Schema for source materials in ISA study definitions. |
IsaStudyGroupSchema |
Schema for study groups used to organize related samples. |
IsaStudySchema |
Schema for study entries inside an ISA investigation. |
| FUNCTION | DESCRIPTION |
|---|---|
flatten_isa_json |
Flatten ISA-JSON documents into tabular-like records. |
FlattenedIsaJsonDataset
Bases: Dataset[FlattenedIsaJsonModel]
flowchart BT
omnipy.components.isa.FlattenedIsaJsonDataset[FlattenedIsaJsonDataset]
omnipy.data.dataset.Dataset[Dataset]
omnipy.data._mixins.display.DatasetDisplayMixin[DatasetDisplayMixin]
omnipy.data._mixins.display.BaseDisplayMixin[BaseDisplayMixin]
omnipy.data._mixins.task.TaskDatasetMixin[TaskDatasetMixin]
omnipy.data._data_class_creator.DataClassBase[DataClassBase]
omnipy.data.dataset.Dataset --> omnipy.components.isa.FlattenedIsaJsonDataset
omnipy.data._mixins.display.DatasetDisplayMixin --> omnipy.data.dataset.Dataset
omnipy.data._mixins.display.BaseDisplayMixin --> omnipy.data._mixins.display.DatasetDisplayMixin
omnipy.data._mixins.task.TaskDatasetMixin --> omnipy.data.dataset.Dataset
omnipy.data._data_class_creator.DataClassBase --> omnipy.data.dataset.Dataset
omnipy.util.pydantic.GenericModel --> omnipy.data.dataset.Dataset
click omnipy.components.isa.FlattenedIsaJsonDataset href "" "omnipy.components.isa.FlattenedIsaJsonDataset"
click omnipy.data.dataset.Dataset href "" "omnipy.data.dataset.Dataset"
click omnipy.data._mixins.display.DatasetDisplayMixin href "" "omnipy.data._mixins.display.DatasetDisplayMixin"
click omnipy.data._mixins.display.BaseDisplayMixin href "" "omnipy.data._mixins.display.BaseDisplayMixin"
click omnipy.data._mixins.task.TaskDatasetMixin href "" "omnipy.data._mixins.task.TaskDatasetMixin"
click omnipy.data._data_class_creator.DataClassBase href "" "omnipy.data._data_class_creator.DataClassBase"
Dataset containing flattened ISA-JSON records.
Records in this dataset follow :class:FlattenedIsaJsonModel and are
intended for tabular-style processing after ISA structures are flattened.
- Reference Code reference
Source code in src/omnipy/components/isa/datasets.py
FlattenedIsaJsonModel
Bases: Model[JsonScalarColumnWiseTableWithColNamesModel], PrintableTable
flowchart BT
omnipy.components.isa.FlattenedIsaJsonModel[FlattenedIsaJsonModel]
omnipy.data.model.Model[Model]
omnipy.data._mixins.display.ModelDisplayMixin[ModelDisplayMixin]
omnipy.data._mixins.display.BaseDisplayMixin[BaseDisplayMixin]
omnipy.data._data_class_creator.DataClassBase[DataClassBase]
omnipy.components.tables.models.PrintableTable[PrintableTable]
omnipy.data.model.Model --> omnipy.components.isa.FlattenedIsaJsonModel
omnipy.data._mixins.display.ModelDisplayMixin --> omnipy.data.model.Model
omnipy.data._mixins.display.BaseDisplayMixin --> omnipy.data._mixins.display.ModelDisplayMixin
omnipy.data._data_class_creator.DataClassBase --> omnipy.data.model.Model
omnipy.util.pydantic.GenericModel --> omnipy.data.model.Model
omnipy.components.tables.models.PrintableTable --> omnipy.components.isa.FlattenedIsaJsonModel
click omnipy.components.isa.FlattenedIsaJsonModel href "" "omnipy.components.isa.FlattenedIsaJsonModel"
click omnipy.data.model.Model href "" "omnipy.data.model.Model"
click omnipy.data._mixins.display.ModelDisplayMixin href "" "omnipy.data._mixins.display.ModelDisplayMixin"
click omnipy.data._mixins.display.BaseDisplayMixin href "" "omnipy.data._mixins.display.BaseDisplayMixin"
click omnipy.data._data_class_creator.DataClassBase href "" "omnipy.data._data_class_creator.DataClassBase"
click omnipy.components.tables.models.PrintableTable href "" "omnipy.components.tables.models.PrintableTable"
- Reference Code reference
Source code in src/omnipy/components/isa/models/__init__.py
IsaAssayJsonSchema
flowchart BT
omnipy.components.isa.IsaAssayJsonSchema[IsaAssayJsonSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaAssayJsonSchema
click omnipy.components.isa.IsaAssayJsonSchema href "" "omnipy.components.isa.IsaAssayJsonSchema"
Schema describing an assay block in ISA-JSON.
| ATTRIBUTE | DESCRIPTION |
|---|---|
filename |
Source filename for the assay metadata.
TYPE:
|
measurementType |
Ontology term describing what is measured.
TYPE:
|
technologyType |
Ontology term describing the assay technology.
TYPE:
|
dataFiles |
Data files produced or referenced by the assay.
TYPE:
|
processSequence |
Ordered process applications for the assay workflow.
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA assay schema parsing. |
Source code in src/omnipy/components/isa/models/assay_schema.py
characteristicCategories
class-attribute
instance-attribute
characteristicCategories: list[material_attribute_schema.IsaMaterialAttributeModel] | None = (
pyd.Field(
None,
description="List of all the characteristics categories (or material attributes) defined in the study, used to avoid duplication of their declaration when each material_attribute_value is created. ",
)
)
comments
class-attribute
instance-attribute
comments: list[comment_schema.IsaCommentModel] | None = None
dataFiles
class-attribute
instance-attribute
dataFiles: list[data_schema.IsaDataModel] | None = None
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
measurementType
class-attribute
instance-attribute
measurementType: ontology_annotation_schema.IsaOntologyReferenceModel | None = None
processSequence
class-attribute
instance-attribute
processSequence: list[process_schema.IsaProcessOrProtocolApplicationModel] | None = None
technologyType
class-attribute
instance-attribute
technologyType: ontology_annotation_schema.IsaOntologyReferenceModel | None = None
unitCategories
class-attribute
instance-attribute
unitCategories: list[ontology_annotation_schema.IsaOntologyReferenceModel] | None = pyd.Field(
None,
description="List of all the units defined in the study, used to avoid duplication of their declaration when each value is created. ",
)
Config
Validation settings for ISA assay schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects keys not defined in the schema.
|
use_enum_values |
Serializes enum members as their value strings.
|
Source code in src/omnipy/components/isa/models/assay_schema.py
IsaCommentSchema
flowchart BT
omnipy.components.isa.IsaCommentSchema[IsaCommentSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaCommentSchema
click omnipy.components.isa.IsaCommentSchema href "" "omnipy.components.isa.IsaCommentSchema"
Schema for comments attached to ISA objects.
| ATTRIBUTE | DESCRIPTION |
|---|---|
name |
Comment key or label.
TYPE:
|
value |
Comment text associated with
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA comment schema parsing. |
Source code in src/omnipy/components/isa/models/comment_schema.py
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
Config
Validation settings for ISA comment schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects unknown keys in input data.
|
use_enum_values |
Emits enum members as raw value strings.
|
Source code in src/omnipy/components/isa/models/comment_schema.py
IsaDataSchema
flowchart BT
omnipy.components.isa.IsaDataSchema[IsaDataSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaDataSchema
click omnipy.components.isa.IsaDataSchema href "" "omnipy.components.isa.IsaDataSchema"
Schema for a data file entry in an ISA assay.
| ATTRIBUTE | DESCRIPTION |
|---|---|
name |
Logical or physical filename for the data object.
TYPE:
|
type |
Controlled category describing the data file kind.
TYPE:
|
comments |
Optional free-form metadata attached to the file.
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA data-file schema parsing. |
Source code in src/omnipy/components/isa/models/data_schema.py
comments
class-attribute
instance-attribute
comments: list[comment_schema.IsaCommentModel] | None = None
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
Config
Validation settings for ISA data-file schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects keys not declared by the schema.
|
use_enum_values |
Converts enum members to string values.
|
Source code in src/omnipy/components/isa/models/data_schema.py
IsaFactorSchema
flowchart BT
omnipy.components.isa.IsaFactorSchema[IsaFactorSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaFactorSchema
click omnipy.components.isa.IsaFactorSchema href "" "omnipy.components.isa.IsaFactorSchema"
Schema for an experimental factor defined in a study.
| ATTRIBUTE | DESCRIPTION |
|---|---|
factorName |
Human-readable factor label.
TYPE:
|
factorType |
Ontology term describing the factor category.
TYPE:
|
comments |
Optional comments attached to the factor definition.
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA factor schema parsing. |
Source code in src/omnipy/components/isa/models/factor_schema.py
comments
class-attribute
instance-attribute
comments: list[comment_schema.IsaCommentModel] | None = None
factorType
class-attribute
instance-attribute
factorType: ontology_annotation_schema.IsaOntologyReferenceModel | None = None
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
Config
Validation settings for ISA factor schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects unknown keys in incoming data.
|
use_enum_values |
Serializes enums as value strings.
|
Source code in src/omnipy/components/isa/models/factor_schema.py
IsaFactorValueSchema
flowchart BT
omnipy.components.isa.IsaFactorValueSchema[IsaFactorValueSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaFactorValueSchema
click omnipy.components.isa.IsaFactorValueSchema href "" "omnipy.components.isa.IsaFactorValueSchema"
Schema for values assigned to study factors.
| ATTRIBUTE | DESCRIPTION |
|---|---|
category |
Factor definition that this value belongs to.
TYPE:
|
value |
Actual assigned value, either ontology-backed or scalar.
TYPE:
|
unit |
Unit ontology term for numeric values when applicable.
TYPE:
|
comments |
Optional comments describing the assignment.
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA factor-value schema parsing. |
Source code in src/omnipy/components/isa/models/factor_value_schema.py
comments
class-attribute
instance-attribute
comments: list[comment_schema.IsaCommentModel] | None = None
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
unit
class-attribute
instance-attribute
unit: ontology_annotation_schema.IsaOntologyReferenceModel | None = None
value
class-attribute
instance-attribute
value: ontology_annotation_schema.IsaOntologyReferenceModel | str | float | None = None
Config
Validation settings for ISA factor-value schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects keys not declared in the schema.
|
use_enum_values |
Converts enum members to raw value strings.
|
Source code in src/omnipy/components/isa/models/factor_value_schema.py
IsaInvestigationSchema
flowchart BT
omnipy.components.isa.IsaInvestigationSchema[IsaInvestigationSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaInvestigationSchema
click omnipy.components.isa.IsaInvestigationSchema href "" "omnipy.components.isa.IsaInvestigationSchema"
Schema for an ISA investigation document.
| ATTRIBUTE | DESCRIPTION |
|---|---|
identifier |
Stable identifier for the investigation.
TYPE:
|
title |
Human-readable investigation title.
TYPE:
|
studies |
Study entries included in this investigation.
TYPE:
|
submissionDate |
Submission date value for the investigation metadata. |
publicReleaseDate |
Public release date for the investigation. |
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA investigation schema parsing. |
Source code in src/omnipy/components/isa/models/investigation_schema.py
comments
class-attribute
instance-attribute
comments: list[comment_schema.IsaCommentModel] | None = None
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
ontologySourceReferences
class-attribute
instance-attribute
ontologySourceReferences: (
list[ontology_source_reference_schema.IsaOntologySourceReferenceModel] | None
) = None
publicReleaseDate
class-attribute
instance-attribute
publications
class-attribute
instance-attribute
publications: list[publication_schema.IsaPublicationModel] | None = None
submissionDate
class-attribute
instance-attribute
Config
Validation settings for ISA investigation schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects undeclared keys in incoming payloads.
|
use_enum_values |
Emits enum fields as their value strings.
|
Source code in src/omnipy/components/isa/models/investigation_schema.py
IsaJsonDataset
Bases: Dataset[IsaJsonModel]
flowchart BT
omnipy.components.isa.IsaJsonDataset[IsaJsonDataset]
omnipy.data.dataset.Dataset[Dataset]
omnipy.data._mixins.display.DatasetDisplayMixin[DatasetDisplayMixin]
omnipy.data._mixins.display.BaseDisplayMixin[BaseDisplayMixin]
omnipy.data._mixins.task.TaskDatasetMixin[TaskDatasetMixin]
omnipy.data._data_class_creator.DataClassBase[DataClassBase]
omnipy.data.dataset.Dataset --> omnipy.components.isa.IsaJsonDataset
omnipy.data._mixins.display.DatasetDisplayMixin --> omnipy.data.dataset.Dataset
omnipy.data._mixins.display.BaseDisplayMixin --> omnipy.data._mixins.display.DatasetDisplayMixin
omnipy.data._mixins.task.TaskDatasetMixin --> omnipy.data.dataset.Dataset
omnipy.data._data_class_creator.DataClassBase --> omnipy.data.dataset.Dataset
omnipy.util.pydantic.GenericModel --> omnipy.data.dataset.Dataset
click omnipy.components.isa.IsaJsonDataset href "" "omnipy.components.isa.IsaJsonDataset"
click omnipy.data.dataset.Dataset href "" "omnipy.data.dataset.Dataset"
click omnipy.data._mixins.display.DatasetDisplayMixin href "" "omnipy.data._mixins.display.DatasetDisplayMixin"
click omnipy.data._mixins.display.BaseDisplayMixin href "" "omnipy.data._mixins.display.BaseDisplayMixin"
click omnipy.data._mixins.task.TaskDatasetMixin href "" "omnipy.data._mixins.task.TaskDatasetMixin"
click omnipy.data._data_class_creator.DataClassBase href "" "omnipy.data._data_class_creator.DataClassBase"
Dataset containing validated ISA-JSON documents.
Each record in the dataset is validated by :class:IsaJsonModel, allowing
downstream ISA flows and tasks to operate on a consistent document shape.
- Reference Code reference
Source code in src/omnipy/components/isa/datasets.py
IsaJsonModel
Bases: Model[IsaInvestigationSchema | IsaTopLevelModel]
flowchart BT
omnipy.components.isa.IsaJsonModel[IsaJsonModel]
omnipy.data.model.Model[Model]
omnipy.data._mixins.display.ModelDisplayMixin[ModelDisplayMixin]
omnipy.data._mixins.display.BaseDisplayMixin[BaseDisplayMixin]
omnipy.data._data_class_creator.DataClassBase[DataClassBase]
omnipy.data.model.Model --> omnipy.components.isa.IsaJsonModel
omnipy.data._mixins.display.ModelDisplayMixin --> omnipy.data.model.Model
omnipy.data._mixins.display.BaseDisplayMixin --> omnipy.data._mixins.display.ModelDisplayMixin
omnipy.data._data_class_creator.DataClassBase --> omnipy.data.model.Model
omnipy.util.pydantic.GenericModel --> omnipy.data.model.Model
click omnipy.components.isa.IsaJsonModel href "" "omnipy.components.isa.IsaJsonModel"
click omnipy.data.model.Model href "" "omnipy.data.model.Model"
click omnipy.data._mixins.display.ModelDisplayMixin href "" "omnipy.data._mixins.display.ModelDisplayMixin"
click omnipy.data._mixins.display.BaseDisplayMixin href "" "omnipy.data._mixins.display.BaseDisplayMixin"
click omnipy.data._data_class_creator.DataClassBase href "" "omnipy.data._data_class_creator.DataClassBase"
Union model that accepts both common ISA investigation shapes.
Input can be either a raw :class:IsaInvestigationSchema object or a
top-level wrapper containing the investigation field.
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Pydantic settings for ISA union parsing behavior. |
Source code in src/omnipy/components/isa/models/__init__.py
Config
Pydantic settings for ISA union parsing behavior.
| ATTRIBUTE | DESCRIPTION |
|---|---|
smart_union |
Keeps explicit branch resolution for union parsing.
|
Source code in src/omnipy/components/isa/models/__init__.py
IsaMaterialAttributeSchema
flowchart BT
omnipy.components.isa.IsaMaterialAttributeSchema[IsaMaterialAttributeSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaMaterialAttributeSchema
click omnipy.components.isa.IsaMaterialAttributeSchema href "" "omnipy.components.isa.IsaMaterialAttributeSchema"
Schema for material attribute categories in ISA.
| ATTRIBUTE | DESCRIPTION |
|---|---|
characteristicType |
Ontology term describing the attribute category.
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA material-attribute schema parsing. |
Source code in src/omnipy/components/isa/models/material_attribute_schema.py
characteristicType
class-attribute
instance-attribute
characteristicType: ontology_annotation_schema.IsaOntologyReferenceModel | None = None
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
Config
Validation settings for ISA material-attribute schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects keys not present in the schema.
|
use_enum_values |
Serializes enums with raw value strings.
|
Source code in src/omnipy/components/isa/models/material_attribute_schema.py
IsaMaterialAttributeValueSchema
flowchart BT
omnipy.components.isa.IsaMaterialAttributeValueSchema[IsaMaterialAttributeValueSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaMaterialAttributeValueSchema
click omnipy.components.isa.IsaMaterialAttributeValueSchema href "" "omnipy.components.isa.IsaMaterialAttributeValueSchema"
Schema for assigned material attribute values.
| ATTRIBUTE | DESCRIPTION |
|---|---|
category |
Attribute definition that this value belongs to.
TYPE:
|
value |
Scalar or ontology-backed attribute value.
TYPE:
|
unit |
Unit ontology term when the value is quantitative.
TYPE:
|
comments |
Optional comments attached to the value.
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA attribute-value schema parsing. |
Source code in src/omnipy/components/isa/models/material_attribute_value_schema.py
category
class-attribute
instance-attribute
category: material_attribute_schema.IsaMaterialAttributeModel | None = None
comments
class-attribute
instance-attribute
comments: list[comment_schema.IsaCommentModel] | None = None
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
unit
class-attribute
instance-attribute
unit: ontology_annotation_schema.IsaOntologyReferenceModel | None = None
value
class-attribute
instance-attribute
value: ontology_annotation_schema.IsaOntologyReferenceModel | str | float | None = None
Config
Validation settings for ISA attribute-value schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects undeclared keys from input data.
|
use_enum_values |
Emits enum members as their value strings.
|
Source code in src/omnipy/components/isa/models/material_attribute_value_schema.py
IsaMaterialSchema
flowchart BT
omnipy.components.isa.IsaMaterialSchema[IsaMaterialSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaMaterialSchema
click omnipy.components.isa.IsaMaterialSchema href "" "omnipy.components.isa.IsaMaterialSchema"
Schema for non-sample materials in ISA studies.
| ATTRIBUTE | DESCRIPTION |
|---|---|
name |
Material name or identifier.
TYPE:
|
type |
Controlled label for material category.
TYPE:
|
characteristics |
Assigned material attribute values.
TYPE:
|
derivesFrom |
Parent materials from which this material was derived.
TYPE:
|
comments |
Optional comments attached to the material.
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA material schema parsing. |
Source code in src/omnipy/components/isa/models/material_schema.py
characteristics
class-attribute
instance-attribute
characteristics: list[material_attribute_value_schema.IsaMaterialAttributeValueModel] | None = None
comments
class-attribute
instance-attribute
comments: list[comment_schema.IsaCommentModel] | None = None
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
Config
Validation settings for ISA material schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects unknown fields.
|
use_enum_values |
Serializes enum fields by raw values.
|
Source code in src/omnipy/components/isa/models/material_schema.py
IsaOntologyReferenceSchema
flowchart BT
omnipy.components.isa.IsaOntologyReferenceSchema[IsaOntologyReferenceSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaOntologyReferenceSchema
click omnipy.components.isa.IsaOntologyReferenceSchema href "" "omnipy.components.isa.IsaOntologyReferenceSchema"
Schema for ontology terms referenced in ISA metadata.
| ATTRIBUTE | DESCRIPTION |
|---|---|
annotationValue |
Free-text or numeric value associated with the term.
TYPE:
|
termSource |
Short name of the ontology source.
TYPE:
|
termAccession |
Accession identifier for the ontology term.
TYPE:
|
comments |
Optional comments attached to the annotation.
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA ontology-annotation parsing. |
Source code in src/omnipy/components/isa/models/ontology_annotation_schema.py
comments
class-attribute
instance-attribute
comments: list[comment_schema.IsaCommentModel] | None = None
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
termSource
class-attribute
instance-attribute
termSource: str | None = pyd.Field(
None,
description="The abbreviated ontology name. It should correspond to one of the sources as specified in the ontologySourceReference section of the Investigation.",
)
Config
Validation settings for ISA ontology-annotation parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects keys that are not defined by the schema.
|
use_enum_values |
Outputs enum fields as value strings.
|
Source code in src/omnipy/components/isa/models/ontology_annotation_schema.py
IsaOntologySourceReferenceSchema
flowchart BT
omnipy.components.isa.IsaOntologySourceReferenceSchema[IsaOntologySourceReferenceSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaOntologySourceReferenceSchema
click omnipy.components.isa.IsaOntologySourceReferenceSchema href "" "omnipy.components.isa.IsaOntologySourceReferenceSchema"
Schema for ontology source references in ISA metadata.
| ATTRIBUTE | DESCRIPTION |
|---|---|
name |
Short source name used by ontology term references.
TYPE:
|
version |
Version string for the ontology source.
TYPE:
|
file |
Optional URI or file reference for the ontology.
TYPE:
|
description |
Human-readable source description.
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA ontology-source schema parsing. |
Source code in src/omnipy/components/isa/models/ontology_source_reference_schema.py
comments
class-attribute
instance-attribute
comments: list[comment_schema.IsaCommentModel] | None = None
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
Config
Validation settings for ISA ontology-source schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects undeclared keys in input payloads.
|
use_enum_values |
Serializes enum values as strings.
|
Source code in src/omnipy/components/isa/models/ontology_source_reference_schema.py
IsaOrganizationSchema
flowchart BT
omnipy.components.isa.IsaOrganizationSchema[IsaOrganizationSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaOrganizationSchema
click omnipy.components.isa.IsaOrganizationSchema href "" "omnipy.components.isa.IsaOrganizationSchema"
Schema for organization entries referenced in ISA metadata.
| ATTRIBUTE | DESCRIPTION |
|---|---|
name |
Organization name.
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA organization schema parsing. |
Source code in src/omnipy/components/isa/models/organization_schema.py
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
Config
Validation settings for ISA organization schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects unknown keys.
|
use_enum_values |
Emits enum members as value strings.
|
Source code in src/omnipy/components/isa/models/organization_schema.py
IsaPersonSchema
flowchart BT
omnipy.components.isa.IsaPersonSchema[IsaPersonSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaPersonSchema
click omnipy.components.isa.IsaPersonSchema href "" "omnipy.components.isa.IsaPersonSchema"
Schema for people associated with ISA investigations.
| ATTRIBUTE | DESCRIPTION |
|---|---|
firstName |
Given name.
TYPE:
|
lastName |
Family name.
TYPE:
|
email |
Contact email for the person. |
affiliation |
Organizational affiliation text.
TYPE:
|
roles |
Ontology terms describing investigation roles.
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA person schema parsing. |
Source code in src/omnipy/components/isa/models/person_schema.py
comments
class-attribute
instance-attribute
comments: list[comment_schema.IsaCommentModel] | None = None
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
roles
class-attribute
instance-attribute
roles: list[ontology_annotation_schema.IsaOntologyReferenceModel] | None = None
Config
Validation settings for ISA person schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects keys not listed in the schema.
|
use_enum_values |
Converts enum members to raw strings.
|
Source code in src/omnipy/components/isa/models/person_schema.py
IsaProcessOrProtocolApplicationSchema
flowchart BT
omnipy.components.isa.IsaProcessOrProtocolApplicationSchema[IsaProcessOrProtocolApplicationSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaProcessOrProtocolApplicationSchema
click omnipy.components.isa.IsaProcessOrProtocolApplicationSchema href "" "omnipy.components.isa.IsaProcessOrProtocolApplicationSchema"
Schema for process or protocol application steps in ISA workflows.
| ATTRIBUTE | DESCRIPTION |
|---|---|
name |
Process step label.
TYPE:
|
executesProtocol |
Protocol executed by this step.
TYPE:
|
parameterValues |
Parameter assignments used for execution.
TYPE:
|
inputs |
Materials or data consumed by the process.
TYPE:
|
outputs |
Materials or data produced by the process.
TYPE:
|
previousProcess |
Upstream process in a linked process chain.
TYPE:
|
nextProcess |
Downstream process in a linked process chain.
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA process-step schema parsing. |
Source code in src/omnipy/components/isa/models/process_schema.py
comments
class-attribute
instance-attribute
comments: list[comment_schema.IsaCommentModel] | None = None
date
class-attribute
instance-attribute
executesProtocol
class-attribute
instance-attribute
executesProtocol: protocol_schema.IsaProtocolModel | None = None
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
inputs
class-attribute
instance-attribute
inputs: (
list[
source_schema.IsaSourceModel
| sample_schema.IsaSampleModel
| data_schema.IsaDataModel
| material_schema.IsaMaterialModel
]
| None
) = None
nextProcess
class-attribute
instance-attribute
nextProcess: IsaProcessOrProtocolApplicationModel | None = None
outputs
class-attribute
instance-attribute
outputs: (
list[sample_schema.IsaSampleModel | data_schema.IsaDataModel | material_schema.IsaMaterialModel]
| None
) = None
parameterValues
class-attribute
instance-attribute
parameterValues: list[process_parameter_value_schema.IsaProcessParameterValueModel] | None = None
previousProcess
class-attribute
instance-attribute
previousProcess: IsaProcessOrProtocolApplicationModel | None = None
Config
Validation settings for ISA process-step schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects keys outside the declared schema.
|
use_enum_values |
Serializes enum fields as raw values.
|
Source code in src/omnipy/components/isa/models/process_schema.py
IsaProcessParameterValueSchema
flowchart BT
omnipy.components.isa.IsaProcessParameterValueSchema[IsaProcessParameterValueSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaProcessParameterValueSchema
click omnipy.components.isa.IsaProcessParameterValueSchema href "" "omnipy.components.isa.IsaProcessParameterValueSchema"
Schema for protocol parameter values applied in process steps.
| ATTRIBUTE | DESCRIPTION |
|---|---|
category |
Protocol parameter definition this value belongs to.
TYPE:
|
value |
Scalar or ontology-backed assigned value.
TYPE:
|
unit |
Unit ontology annotation for quantitative values.
TYPE:
|
comments |
Optional comments attached to the value.
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA process-parameter schema parsing. |
Source code in src/omnipy/components/isa/models/process_parameter_value_schema.py
category
class-attribute
instance-attribute
category: protocol_parameter_schema.IsaProtocolParameterModel | None = None
comments
class-attribute
instance-attribute
comments: list[comment_schema.IsaCommentModel] | None = None
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
unit
class-attribute
instance-attribute
unit: ontology_annotation_schema.IsaOntologyReferenceModel | None = None
value
class-attribute
instance-attribute
value: ontology_annotation_schema.IsaOntologyReferenceModel | str | float | None = None
Config
Validation settings for ISA process-parameter schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects unknown keys in input payloads.
|
use_enum_values |
Emits enum members by value string.
|
Source code in src/omnipy/components/isa/models/process_parameter_value_schema.py
IsaProtocolParameterSchema
flowchart BT
omnipy.components.isa.IsaProtocolParameterSchema[IsaProtocolParameterSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaProtocolParameterSchema
click omnipy.components.isa.IsaProtocolParameterSchema href "" "omnipy.components.isa.IsaProtocolParameterSchema"
Schema for protocol parameters used by ISA process steps.
| ATTRIBUTE | DESCRIPTION |
|---|---|
parameterName |
Ontology-backed name of the protocol parameter.
TYPE:
|
comments |
Optional comments attached to the parameter definition.
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA protocol-parameter schema parsing. |
Source code in src/omnipy/components/isa/models/protocol_parameter_schema.py
comments
class-attribute
instance-attribute
comments: list[comment_schema.IsaCommentModel] | None = None
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
parameterName
class-attribute
instance-attribute
parameterName: ontology_annotation_schema.IsaOntologyReferenceModel | None = None
Config
Validation settings for ISA protocol-parameter schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects undeclared keys from input data.
|
use_enum_values |
Emits enum fields as their value strings.
|
Source code in src/omnipy/components/isa/models/protocol_parameter_schema.py
IsaProtocolSchema
flowchart BT
omnipy.components.isa.IsaProtocolSchema[IsaProtocolSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaProtocolSchema
click omnipy.components.isa.IsaProtocolSchema href "" "omnipy.components.isa.IsaProtocolSchema"
Schema for protocols referenced by ISA process workflows.
| ATTRIBUTE | DESCRIPTION |
|---|---|
name |
Protocol name.
TYPE:
|
protocolType |
Ontology term describing protocol category.
TYPE:
|
description |
Human-readable protocol description.
TYPE:
|
parameters |
Parameter definitions accepted by the protocol.
TYPE:
|
components |
Reusable protocol components and materials.
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA protocol schema parsing. |
Source code in src/omnipy/components/isa/models/protocol_schema.py
comments
class-attribute
instance-attribute
comments: list[comment_schema.IsaCommentModel] | None = None
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
parameters
class-attribute
instance-attribute
parameters: list[protocol_parameter_schema.IsaProtocolParameterModel] | None = None
protocolType
class-attribute
instance-attribute
protocolType: ontology_annotation_schema.IsaOntologyReferenceModel | None = None
Config
Validation settings for ISA protocol schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects keys that are not defined in the schema.
|
use_enum_values |
Serializes enum members by value.
|
Source code in src/omnipy/components/isa/models/protocol_schema.py
IsaPublicationSchema
flowchart BT
omnipy.components.isa.IsaPublicationSchema[IsaPublicationSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaPublicationSchema
click omnipy.components.isa.IsaPublicationSchema href "" "omnipy.components.isa.IsaPublicationSchema"
Schema for publication metadata linked to ISA investigations.
| ATTRIBUTE | DESCRIPTION |
|---|---|
pubMedID |
PubMed identifier, when available.
TYPE:
|
doi |
DOI string for the publication.
TYPE:
|
authorList |
Free-form list of publication authors.
TYPE:
|
title |
Publication title.
TYPE:
|
status |
Ontology term describing publication status.
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA publication schema parsing. |
Source code in src/omnipy/components/isa/models/publication_schema.py
comments
class-attribute
instance-attribute
comments: list[comment_schema.IsaCommentModel] | None = None
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
status
class-attribute
instance-attribute
status: ontology_annotation_schema.IsaOntologyReferenceModel | None = None
Config
Validation settings for ISA publication schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects undeclared keys from payloads.
|
use_enum_values |
Emits enum fields as value strings.
|
Source code in src/omnipy/components/isa/models/publication_schema.py
IsaSampleSchema
flowchart BT
omnipy.components.isa.IsaSampleSchema[IsaSampleSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaSampleSchema
click omnipy.components.isa.IsaSampleSchema href "" "omnipy.components.isa.IsaSampleSchema"
Schema for sample entities in ISA study materials.
| ATTRIBUTE | DESCRIPTION |
|---|---|
name |
Sample name or identifier.
TYPE:
|
characteristics |
Material attribute values describing the sample.
TYPE:
|
factorValues |
Factor assignments associated with the sample.
TYPE:
|
derivesFrom |
Source materials from which the sample originates.
TYPE:
|
comments |
Optional comments attached to the sample.
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA sample schema parsing. |
Source code in src/omnipy/components/isa/models/sample_schema.py
characteristics
class-attribute
instance-attribute
characteristics: list[material_attribute_value_schema.IsaMaterialAttributeValueModel] | None = None
comments
class-attribute
instance-attribute
comments: list[comment_schema.IsaCommentModel] | None = None
derivesFrom
class-attribute
instance-attribute
derivesFrom: list[source_schema.IsaSourceModel] | None = None
factorValues
class-attribute
instance-attribute
factorValues: list[factor_value_schema.IsaFactorValueModel] | None = None
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
Config
Validation settings for ISA sample schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects unknown keys in input payloads.
|
use_enum_values |
Serializes enums to their raw values.
|
Source code in src/omnipy/components/isa/models/sample_schema.py
IsaSourceSchema
flowchart BT
omnipy.components.isa.IsaSourceSchema[IsaSourceSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaSourceSchema
click omnipy.components.isa.IsaSourceSchema href "" "omnipy.components.isa.IsaSourceSchema"
Schema for source materials in ISA study definitions.
| ATTRIBUTE | DESCRIPTION |
|---|---|
name |
Source name or identifier.
TYPE:
|
characteristics |
Material attribute values describing the source.
TYPE:
|
comments |
Optional comments attached to the source entry.
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA source schema parsing. |
Source code in src/omnipy/components/isa/models/source_schema.py
characteristics
class-attribute
instance-attribute
characteristics: list[material_attribute_value_schema.IsaMaterialAttributeValueModel] | None = None
comments
class-attribute
instance-attribute
comments: list[comment_schema.IsaCommentModel] | None = None
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
Config
Validation settings for ISA source schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects undeclared keys in payloads.
|
use_enum_values |
Serializes enum members to value strings.
|
Source code in src/omnipy/components/isa/models/source_schema.py
IsaStudyGroupSchema
flowchart BT
omnipy.components.isa.IsaStudyGroupSchema[IsaStudyGroupSchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaStudyGroupSchema
click omnipy.components.isa.IsaStudyGroupSchema href "" "omnipy.components.isa.IsaStudyGroupSchema"
Schema for study groups used to organize related samples.
| ATTRIBUTE | DESCRIPTION |
|---|---|
name |
Study group label.
TYPE:
|
factor_levels |
Factor-value assignments that define the group.
TYPE:
|
study_group_size |
Number of members in the group.
TYPE:
|
members |
Sample entries assigned to the group.
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA study-group schema parsing. |
Source code in src/omnipy/components/isa/models/study_group.py
comments
class-attribute
instance-attribute
comments: list[comment_schema.IsaCommentModel] | None = None
factor_levels
class-attribute
instance-attribute
factor_levels: list[factor_value_schema.IsaFactorValueModel] | None = None
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
members
class-attribute
instance-attribute
members: list[sample_schema.IsaSampleModel] | None = None
Config
Validation settings for ISA study-group schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects keys not declared by the schema.
|
use_enum_values |
Converts enum members to value strings.
|
Source code in src/omnipy/components/isa/models/study_group.py
IsaStudySchema
flowchart BT
omnipy.components.isa.IsaStudySchema[IsaStudySchema]
omnipy.util.pydantic.BaseModel --> omnipy.components.isa.IsaStudySchema
click omnipy.components.isa.IsaStudySchema href "" "omnipy.components.isa.IsaStudySchema"
Schema for study entries inside an ISA investigation.
| ATTRIBUTE | DESCRIPTION |
|---|---|
identifier |
Stable identifier for the study.
TYPE:
|
title |
Human-readable study title.
TYPE:
|
materials |
Sources, samples, and other materials in the study.
TYPE:
|
processSequence |
Ordered list of process steps.
TYPE:
|
assays |
Assay entries defined for the study.
TYPE:
|
factors |
Experimental factors used to structure comparisons.
TYPE:
|
- Reference Code reference
| CLASS | DESCRIPTION |
|---|---|
Config |
Validation settings for ISA study schema parsing. |
Source code in src/omnipy/components/isa/models/study_schema.py
assays
class-attribute
instance-attribute
assays: list[assay_schema.IsaAssayJsonModel] | None = None
characteristicCategories
class-attribute
instance-attribute
characteristicCategories: list[material_attribute_schema.IsaMaterialAttributeModel] | None = (
pyd.Field(
None,
description="List of all the characteristics categories (or material attributes) defined in the study, used to avoid duplication of their declaration when each material_attribute_value is created. ",
)
)
comments
class-attribute
instance-attribute
comments: list[comment_schema.IsaCommentModel] | None = None
factors
class-attribute
instance-attribute
factors: list[factor_schema.IsaFactorModel] | None = None
field_context
class-attribute
instance-attribute
field_type
class-attribute
instance-attribute
processSequence
class-attribute
instance-attribute
processSequence: list[process_schema.IsaProcessOrProtocolApplicationModel] | None = None
protocols
class-attribute
instance-attribute
protocols: list[protocol_schema.IsaProtocolModel] | None = None
publicReleaseDate
class-attribute
instance-attribute
publications
class-attribute
instance-attribute
publications: list[publication_schema.IsaPublicationModel] | None = None
studyDesignDescriptors
class-attribute
instance-attribute
studyDesignDescriptors: list[ontology_annotation_schema.IsaOntologyReferenceModel] | None = None
submissionDate
class-attribute
instance-attribute
unitCategories
class-attribute
instance-attribute
unitCategories: list[ontology_annotation_schema.IsaOntologyReferenceModel] | None = pyd.Field(
None,
description="List of all the units defined in the study, used to avoid duplication of their declaration when each value is created. ",
)
Config
Validation settings for ISA study schema parsing.
| ATTRIBUTE | DESCRIPTION |
|---|---|
extra |
Rejects undeclared keys from input data.
|
use_enum_values |
Emits enum fields as value strings.
|
Source code in src/omnipy/components/isa/models/study_schema.py
flatten_isa_json
flatten_isa_json(dataset: IsaJsonDataset) -> FlattenedIsaJsonDataset
Flatten ISA-JSON documents into tabular-like records.
The flow converts each ISA document to an intermediate dictionary-of-dictionaries representation, transposes that structure into record lists, and then flattens nested keys into scalar columns.
| PARAMETER | DESCRIPTION |
|---|---|
dataset
|
Dataset with ISA-JSON documents to flatten.
TYPE:
|
| RETURNS | DESCRIPTION |
|---|---|
FlattenedIsaJsonDataset
|
A dataset containing flattened ISA records suitable for tabular workflows. |