Resource

pydantic model Resource[source]

Metadata about an ontology, database, or other resource.

Create a new model by parsing and validating input data from keyword arguments.

Raises ValidationError if the input data cannot be parsed to form a valid model.

Show JSON schema
{
   "title": "Resource",
   "description": "Metadata about an ontology, database, or other resource.",
   "type": "object",
   "properties": {
      "prefix": {
         "title": "Prefix",
         "description": "The prefix for this resource",
         "integration_status": "required",
         "type": "string"
      },
      "name": {
         "title": "Name",
         "description": "The name of the resource",
         "integration_status": "required",
         "type": "string"
      },
      "description": {
         "title": "Description",
         "description": "A description of the resource",
         "integration_status": "required",
         "type": "string"
      },
      "pattern": {
         "title": "Pattern",
         "description": "The regular expression pattern for local unique identifiers in the resource",
         "integration_status": "required_for_new",
         "type": "string"
      },
      "uri_format": {
         "title": "URI format string",
         "description": "The URI format string, which must have at least one ``$1`` in it",
         "integration_status": "required_for_new",
         "type": "string"
      },
      "providers": {
         "title": "Providers",
         "description": "Additional, non-default providers for the resource",
         "type": "array",
         "items": {
            "$ref": "#/definitions/Provider"
         }
      },
      "homepage": {
         "title": "Homepage",
         "description": "The URL for the homepage of the resource, preferably using HTTPS",
         "integration_status": "required",
         "type": "string"
      },
      "repository": {
         "title": "Repository",
         "description": "The URL for the repository of the resource",
         "type": "string"
      },
      "contact": {
         "title": "Contact",
         "description": "The contact email address for the resource. This must correspond to a specific person and not be a listserve nor a shared email account.",
         "integration_status": "suggested",
         "allOf": [
            {
               "$ref": "#/definitions/Attributable"
            }
         ]
      },
      "example": {
         "title": "Example",
         "description": "An example local identifier for the resource, explicitly excluding any redundant usage of the prefix in the identifier. For example, a GO identifier should only look like ``1234567`` and not like ``GO:1234567``",
         "integration_status": "required",
         "type": "string"
      },
      "example_extras": {
         "title": "Example Extras",
         "description": "Extra example identifiers",
         "type": "array",
         "items": {
            "type": "string"
         }
      },
      "example_decoys": {
         "title": "Example Decoys",
         "description": "Extra example identifiers that explicitly fail regex tests",
         "type": "array",
         "items": {
            "type": "string"
         }
      },
      "license": {
         "title": "License",
         "description": "The license for the resource",
         "type": "string"
      },
      "version": {
         "title": "Version",
         "description": "The version for the resource",
         "type": "string"
      },
      "part_of": {
         "title": "Part Of",
         "description": "An annotation between this prefix and a super-prefix. For example, ``chembl.compound`` is a part of ``chembl``.",
         "type": "string"
      },
      "provides": {
         "title": "Provides",
         "description": "An annotation between this prefix and a prefix for which it is redundant. For example, ``ctd.gene`` has been given a prefix by Identifiers.org, but it actually just reuses identifies from ``ncbigene``, so ``ctd.gene`` provides ``ncbigene``.",
         "type": "string"
      },
      "download_owl": {
         "title": "OWL Download URL",
         "description": "The URL to download the resource as an ontology encoded in the OWL format. More information about this format can be found at https://www.w3.org/TR/owl2-syntax/.",
         "type": "string"
      },
      "download_obo": {
         "title": "OBO Download URL",
         "description": "The URL to download the resource as an ontology encoded in the OBO format. More information about this format can be found at https://owlcollab.github.io/oboformat/doc/obo-syntax.html.",
         "type": "string"
      },
      "download_json": {
         "title": "OBO Graph JSON Download URL",
         "description": "The URL to download the resource as an ontology encoded in the OBO Graph JSON format. More information about this format can be found at https://github.com/geneontology/obographs.",
         "type": "string"
      },
      "download_rdf": {
         "title": "RDF Download URL",
         "description": "The URL to download the resource as an RDF file, in one of many formats.",
         "type": "string"
      },
      "banana": {
         "title": "Banana",
         "description": "The `banana` is a generalization of the concept of the \"namespace embedded in local unique identifier\". Many OBO foundry ontologies use the redundant uppercased name of the ontology in the local identifier, such as the Gene Ontology, which makes the prefixes have a redundant usage as in ``GO:GO:1234567``. The `banana` tag explicitly annotates the part in the local identifier that should be stripped, if found. While the Bioregistry automatically knows how to handle all OBO Foundry ontologies' bananas because the OBO Foundry provides the \"preferredPrefix\" field, the banana can be annotated on non-OBO ontologies to more explicitly write the beginning part of the identifier that should be stripped. This allowed for solving one of the long-standing issues with the Identifiers.org resolver (e.g., for ``oma.hog``; see https://github.com/identifiers-org/identifiers-org.github.io/issues/155) as well as better annotate new entries, such as SwissMap Lipids, which have the prefix ``swisslipid`` but have the redundant information ``SLM:`` in the beginning of identifiers. Therefore, ``SLM:`` is the banana.",
         "type": "string"
      },
      "banana_peel": {
         "title": "Banana Peel",
         "description": "Delimiter used in banana",
         "type": "string"
      },
      "deprecated": {
         "title": "Deprecated",
         "description": "A flag denoting if this resource is deprecated. Currently, this is a blanket term that covers cases when the prefix is no longer maintained, when it has been rolled into another resource, when the website related to the resource goes down, or any other reason that it's difficult or impossible to find full metadata on the resource. If this is set to true, please add a comment explaining why. This flag will override annotations from the OLS, OBO Foundry, and others on the deprecation status, since they often disagree and are very conservative in calling dead resources.",
         "type": "boolean"
      },
      "mappings": {
         "title": "Mappings",
         "description": "A dictionary of metaprefixes (i.e., prefixes for registries) to prefixes in external registries. These also correspond to the registry-specific JSON fields in this model like ``miriam`` field.",
         "type": "object",
         "additionalProperties": {
            "type": "string"
         }
      },
      "synonyms": {
         "title": "Synonyms",
         "description": "A list of synonyms for the prefix of this resource. These are used in normalization of prefixes and are a useful reference tool for prefixes that are written many ways. For example, ``snomedct`` has many synonyms including typos like ``SNOWMEDCT``, lexical variants like ``SNOMED_CT``, version-variants like ``SNOMEDCT_2010_1_31``, and tons of other nonsense like ``SNOMEDCTCT``.",
         "type": "array",
         "items": {
            "type": "string"
         }
      },
      "references": {
         "title": "References",
         "description": "A list of URLs to also see, such as publications describing the resource",
         "type": "array",
         "items": {
            "type": "string"
         }
      },
      "publications": {
         "title": "Publications",
         "description": "A list of URLs to also see, such as publications describing the resource",
         "type": "array",
         "items": {
            "$ref": "#/definitions/Publication"
         }
      },
      "appears_in": {
         "title": "Appears In",
         "description": "A list of prefixes that use this resource for xrefs, provenance, etc.",
         "type": "array",
         "items": {
            "type": "string"
         }
      },
      "depends_on": {
         "title": "Depends On",
         "description": "A list of prefixes that use this resource depends on, e.g., ontologies that import each other.",
         "type": "array",
         "items": {
            "type": "string"
         }
      },
      "namespace_in_lui": {
         "title": "Namespace Embedded in Local Unique Identifier",
         "description": "A flag denoting if the namespace is embedded in the LUI (if this is true and it is not accompanied by a banana, assume that the banana is the prefix in all caps plus a colon, as is standard in OBO). Currently this flag is only used to override identifiers.org in the case of ``gramene.growthstage``, ``oma.hog``, and ``vario``.",
         "type": "boolean"
      },
      "no_own_terms": {
         "title": "No Own Terms",
         "description": "A flag denoting if the resource mints its own identifiers. Omission or explicit marking as false means that the resource does have its own terms. This is most applicable to ontologies, specifically application ontologies, which only reuse terms from others. One example is ChIRO.",
         "type": "boolean"
      },
      "comment": {
         "title": "Comment",
         "description": "A field for a free text comment",
         "type": "string"
      },
      "contributor": {
         "title": "Contributor",
         "description": "The contributor of the prefix to the Bioregistry, including at a minimum their name and ORCiD and optionall their email address and GitHub handle. All entries curated through the Bioregistry GitHub Workflow must contain this field.",
         "integration_status": "required_for_new",
         "allOf": [
            {
               "$ref": "#/definitions/Author"
            }
         ]
      },
      "contributor_extras": {
         "title": "Contributor Extras",
         "description": "Additional contributors besides the original submitter.",
         "type": "array",
         "items": {
            "$ref": "#/definitions/Author"
         }
      },
      "reviewer": {
         "title": "Reviewer",
         "description": "The reviewer of the prefix to the Bioregistry, including at a minimum their name and ORCiD and optionall their email address and GitHub handle. All entries curated through the Bioregistry GitHub Workflow should contain this field pointing to the person who reviewed it on GitHub.",
         "integration_status": "required_for_new",
         "allOf": [
            {
               "$ref": "#/definitions/Author"
            }
         ]
      },
      "proprietary": {
         "title": "Proprietary",
         "description": "A flag to denote if this database is proprietary and therefore can not be included in normal quality control checks nor can it be resolved. Omission or explicit marking as false means that the resource is not proprietary.",
         "type": "boolean"
      },
      "has_canonical": {
         "title": "Has Canonical",
         "description": "If this shares an IRI with another entry, maps to which should be be considered as canonical",
         "type": "string"
      },
      "preferred_prefix": {
         "title": "Preferred Prefix",
         "description": "An annotation of stylization of the prefix. This appears in OBO ontologies like FBbt as well as databases like NCBIGene. If it's not given, then assume that the normalized prefix used in the Bioregistry is canonical.",
         "type": "string"
      },
      "twitter": {
         "title": "Twitter",
         "description": "The twitter handle for the project",
         "type": "string"
      },
      "github_request_issue": {
         "title": "Github Request Issue",
         "description": "The GitHub issue for the new prefix request",
         "type": "integer"
      },
      "miriam": {
         "title": "Miriam",
         "type": "object"
      },
      "n2t": {
         "title": "N2T",
         "type": "object"
      },
      "prefixcommons": {
         "title": "Prefixcommons",
         "type": "object"
      },
      "wikidata": {
         "title": "Wikidata",
         "type": "object"
      },
      "go": {
         "title": "Go",
         "type": "object"
      },
      "obofoundry": {
         "title": "Obofoundry",
         "type": "object"
      },
      "bioportal": {
         "title": "Bioportal",
         "type": "object"
      },
      "ecoportal": {
         "title": "Ecoportal",
         "type": "object"
      },
      "agroportal": {
         "title": "Agroportal",
         "type": "object"
      },
      "cropoct": {
         "title": "Cropoct",
         "type": "object"
      },
      "ols": {
         "title": "Ols",
         "type": "object"
      },
      "aberowl": {
         "title": "Aberowl",
         "type": "object"
      },
      "ncbi": {
         "title": "Ncbi",
         "type": "object"
      },
      "uniprot": {
         "title": "Uniprot",
         "type": "object"
      },
      "biolink": {
         "title": "Biolink",
         "type": "object"
      },
      "cellosaurus": {
         "title": "Cellosaurus",
         "type": "object"
      },
      "ontobee": {
         "title": "Ontobee",
         "type": "object"
      },
      "cheminf": {
         "title": "Cheminf",
         "type": "object"
      },
      "fairsharing": {
         "title": "Fairsharing",
         "type": "object"
      },
      "biocontext": {
         "title": "Biocontext",
         "type": "object"
      },
      "edam": {
         "title": "Edam",
         "type": "object"
      },
      "re3data": {
         "title": "Re3Data",
         "type": "object"
      },
      "hl7": {
         "title": "Hl7",
         "type": "object"
      },
      "bartoc": {
         "title": "Bartoc",
         "type": "object"
      }
   },
   "required": [
      "prefix"
   ],
   "definitions": {
      "Provider": {
         "title": "Provider",
         "description": "A provider.",
         "type": "object",
         "properties": {
            "code": {
               "title": "Code",
               "description": "A locally unique code within the prefix for the provider",
               "type": "string"
            },
            "name": {
               "title": "Name",
               "description": "Name of the provider",
               "type": "string"
            },
            "description": {
               "title": "Description",
               "description": "Description of the provider",
               "type": "string"
            },
            "homepage": {
               "title": "Homepage",
               "description": "Homepage of the provider",
               "type": "string"
            },
            "uri_format": {
               "title": "URI Format",
               "description": "The URI format string, which must have at least one ``$1`` in it",
               "type": "string"
            }
         },
         "required": [
            "code",
            "name",
            "description",
            "homepage",
            "uri_format"
         ]
      },
      "Attributable": {
         "title": "Attributable",
         "description": "An upper-level metadata for a researcher.",
         "type": "object",
         "properties": {
            "name": {
               "title": "Name",
               "description": "The full name of the researcher",
               "type": "string"
            },
            "orcid": {
               "title": "Open Researcher and Contributor Identifier",
               "description": "The Open Researcher and Contributor Identifier (ORCiD) provides researchers with an open, unambiguous identifier for connecting various digital assets (e.g., publications, reviews) across the semantic web. An account can be made in seconds at https://orcid.org.",
               "type": "string"
            },
            "email": {
               "title": "Email address",
               "description": "The email address specific to the researcher.",
               "type": "string"
            },
            "github": {
               "title": "GitHub handle",
               "description": "The GitHub handle enables contacting the researcher on GitHub: the *de facto* version control in the computer sciences and life sciences.",
               "type": "string"
            }
         },
         "required": [
            "name"
         ]
      },
      "Publication": {
         "title": "Publication",
         "description": "Metadata about a publication.",
         "type": "object",
         "properties": {
            "pubmed": {
               "title": "PubMed",
               "description": "The PubMed identifier for the article",
               "type": "string"
            },
            "doi": {
               "title": "DOI",
               "description": "The DOI for the article. DOIs are case insensitive, so these are required by the Bioregistry to be standardized to their lowercase form.",
               "type": "string"
            },
            "pmc": {
               "title": "PMC",
               "description": "The PubMed Central identifier for the article",
               "type": "string"
            },
            "title": {
               "title": "Title",
               "description": "The title of the article",
               "type": "string"
            },
            "year": {
               "title": "Year",
               "description": "The year the article was published",
               "type": "integer"
            }
         }
      },
      "Author": {
         "title": "Author",
         "description": "Metadata for an author.",
         "type": "object",
         "properties": {
            "name": {
               "title": "Name",
               "description": "The full name of the researcher",
               "type": "string"
            },
            "orcid": {
               "title": "Open Researcher and Contributor Identifier",
               "description": "The Open Researcher and Contributor Identifier (ORCiD) provides researchers with an open, unambiguous identifier for connecting various digital assets (e.g., publications, reviews) across the semantic web. An account can be made in seconds at https://orcid.org.",
               "type": "string"
            },
            "email": {
               "title": "Email address",
               "description": "The email address specific to the researcher.",
               "type": "string"
            },
            "github": {
               "title": "GitHub handle",
               "description": "The GitHub handle enables contacting the researcher on GitHub: the *de facto* version control in the computer sciences and life sciences.",
               "type": "string"
            }
         },
         "required": [
            "name",
            "orcid"
         ]
      }
   }
}

Fields
field aberowl: Optional[Mapping[str, Any]] = None

External data from the AberOWL ontology repository

field agroportal: Optional[Mapping[str, Any]] = None

External data from the AgroPortal ontology repository

field appears_in: Optional[List[str]] = None

A list of prefixes that use this resource for xrefs, provenance, etc.

field banana: Optional[str] = None

The banana is a generalization of the concept of the “namespace embedded in local unique identifier”. Many OBO foundry ontologies use the redundant uppercased name of the ontology in the local identifier, such as the Gene Ontology, which makes the prefixes have a redundant usage as in GO:GO:1234567. The banana tag explicitly annotates the part in the local identifier that should be stripped, if found. While the Bioregistry automatically knows how to handle all OBO Foundry ontologies’ bananas because the OBO Foundry provides the “preferredPrefix” field, the banana can be annotated on non-OBO ontologies to more explicitly write the beginning part of the identifier that should be stripped. This allowed for solving one of the long-standing issues with the Identifiers.org resolver (e.g., for oma.hog; see https://github.com/identifiers-org/identifiers-org.github.io/issues/155) as well as better annotate new entries, such as SwissMap Lipids, which have the prefix swisslipid but have the redundant information SLM: in the beginning of identifiers. Therefore, SLM: is the banana.

field banana_peel: Optional[str] = None

Delimiter used in banana

field bartoc: Optional[Mapping[str, Any]] = None

External data from bartoc

field biocontext: Optional[Mapping[str, Any]] = None

External data from BioContext

External data from the BioLink Model’s custom registry

field bioportal: Optional[Mapping[str, Any]] = None

External data from the BioPortal ontology repository

field cellosaurus: Optional[Mapping[str, Any]] = None

External data from the Cellosaurus custom registry

field cheminf: Optional[Mapping[str, Any]] = None

External data from ChemInf

field comment: Optional[str] = None

A field for a free text comment.

A field for a free text comment

field contact: Optional[Attributable] = None

The contact email address for the resource. This must correspond to a specific person and not be a listserve nor a shared email account.

field contributor: Optional[Author] = None

The contributor of the prefix to the Bioregistry, including at a minimum their name and ORCiD and optionall their email address and GitHub handle. All entries curated through the Bioregistry GitHub Workflow must contain this field.

field contributor_extras: Optional[List[Author]] = None

Additional contributors besides the original submitter.

field cropoct: Optional[Mapping[str, Any]] = None

External data from the CropOCT ontology curation tool

field depends_on: Optional[List[str]] = None

A list of prefixes that use this resource depends on, e.g., ontologies that import each other.

field deprecated: Optional[bool] = None

A flag denoting if this resource is deprecated. Currently, this is a blanket term that covers cases when the prefix is no longer maintained, when it has been rolled into another resource, when the website related to the resource goes down, or any other reason that it’s difficult or impossible to find full metadata on the resource. If this is set to true, please add a comment explaining why. This flag will override annotations from the OLS, OBO Foundry, and others on the deprecation status, since they often disagree and are very conservative in calling dead resources.

field description: Optional[str] = None

A description of the resource

field download_json: Optional[str] = None

The URL to download the resource as an ontology encoded in the OBO Graph JSON format. More information about this format can be found at https://github.com/geneontology/obographs.

field download_obo: Optional[str] = None

The URL to download the resource as an ontology encoded in the OBO format. More information about this format can be found at https://owlcollab.github.io/oboformat/doc/obo-syntax.html.

field download_owl: Optional[str] = None

The URL to download the resource as an ontology encoded in the OWL format. More information about this format can be found at https://www.w3.org/TR/owl2-syntax/.

field download_rdf: Optional[str] = None

The URL to download the resource as an RDF file, in one of many formats.

field ecoportal: Optional[Mapping[str, Any]] = None

External data from the EcoPortal ontology repository

field edam: Optional[Mapping[str, Any]] = None

External data from EDAM ontology

field example: Optional[str] = None

An example local identifier for the resource, explicitly excluding any redundant usage of the prefix in the identifier. For example, a GO identifier should only look like 1234567 and not like GO:1234567

field example_decoys: Optional[List[str]] = None

Extra example identifiers that explicitly fail regex tests

field example_extras: Optional[List[str]] = None

Extra example identifiers

field fairsharing: Optional[Mapping[str, Any]] = None

External data from FAIRsharing

field github_request_issue: Optional[int] = None

The GitHub issue for the new prefix request

field go: Optional[Mapping[str, Any]] = None

External data from the Gene Ontology’s custom registry

field has_canonical: Optional[str] = None

An annotation between this prefix and another prefix if they share the same provider IRI to denote that the other prefix should be considered as the canonical prefix to which IRIs should be contracted as CURIEs.

See also

This field was added and described in detail in https://github.com/biopragmatics/bioregistry/pull/164

If this shares an IRI with another entry, maps to which should be be considered as canonical

field hl7: Optional[Mapping[str, Any]] = None

External data from hl7

field homepage: Optional[str] = None

The URL for the homepage of the resource, preferably using HTTPS

field license: Optional[str] = None

The license for the resource

field mappings: Optional[Dict[str, str]] = None

A dictionary of metaprefixes (i.e., prefixes for registries) to prefixes in external registries. These also correspond to the registry-specific JSON fields in this model like miriam field.

field miriam: Optional[Mapping[str, Any]] = None

External data from Identifiers.org’s MIRIAM Database

field n2t: Optional[Mapping[str, Any]] = None

External data from the Name-to-Thing service

field name: Optional[str] = None

The name of the resource

field namespace_in_lui: Optional[bool] = None

A flag denoting if the namespace is embedded in the LUI (if this is true and it is not accompanied by a banana, assume that the banana is the prefix in all caps plus a colon, as is standard in OBO). Currently this flag is only used to override identifiers.org in the case of gramene.growthstage, oma.hog, and vario.

field ncbi: Optional[Mapping[str, Any]] = None

External data from the NCBI Genbank’s custom registry

field no_own_terms: Optional[bool] = None

A flag denoting if the resource mints its own identifiers. Omission or explicit marking as false means that the resource does have its own terms. This is most applicable to ontologies, specifically application ontologies, which only reuse terms from others. One example is ChIRO.

field obofoundry: Optional[Mapping[str, Any]] = None

External data from the Open Biomedical Ontologies (OBO) Foundry catalog

field ols: Optional[Mapping[str, Any]] = None

External data from the Ontology Lookup Service

field ontobee: Optional[Mapping[str, Any]] = None

External data from the OntoBee

field part_of: Optional[str] = None

An annotation between this prefix and a super-prefix. For example, chembl.compound is a part of chembl.

field pattern: Optional[str] = None

The regular expression pattern for local unique identifiers in the resource

field preferred_prefix: Optional[str] = None

An annotation of stylization of the prefix. This appears in OBO ontologies like FBbt as well as databases like NCBIGene. If it’s not given, then assume that the normalized prefix used in the Bioregistry is canonical.

field prefix: str [Required]

The prefix for this resource

field prefixcommons: Optional[Mapping[str, Any]] = None

External data from Prefix Commons

field proprietary: Optional[bool] = None

A flag to denote if this database is proprietary and therefore can not be included in normal quality control checks nor can it be resolved. Omission or explicit marking as false means that the resource is not proprietary.

field providers: Optional[List[Provider]] = None

Additional, non-default providers for the resource

field provides: Optional[str] = None

An annotation between this prefix and a prefix for which it is redundant. For example, ctd.gene has been given a prefix by Identifiers.org, but it actually just reuses identifies from ncbigene, so ctd.gene provides ncbigene.

field publications: Optional[List[Publication]] = None

A list of URLs to also see, such as publications describing the resource

field re3data: Optional[Mapping[str, Any]] = None

External data from re3data

field references: Optional[List[str]] = None

A list of URLs to also see, such as publications describing the resource

field repository: Optional[str] = None

The URL for the repository of the resource

field reviewer: Optional[Author] = None

The reviewer of the prefix to the Bioregistry, including at a minimum their name and ORCiD and optionall their email address and GitHub handle. All entries curated through the Bioregistry GitHub Workflow should contain this field pointing to the person who reviewed it on GitHub.

field synonyms: Optional[List[str]] = None

A list of synonyms for the prefix of this resource. These are used in normalization of prefixes and are a useful reference tool for prefixes that are written many ways. For example, snomedct has many synonyms including typos like SNOWMEDCT, lexical variants like SNOMED_CT, version-variants like SNOMEDCT_2010_1_31, and tons of other nonsense like SNOMEDCTCT.

field twitter: Optional[str] = None

The twitter handle for the project

field uniprot: Optional[Mapping[str, Any]] = None

External data from UniProt’s custom registry

field uri_format: Optional[str] = None

The URI format string, which must have at least one $1 in it

field version: Optional[str] = None

The version for the resource

field wikidata: Optional[Mapping[str, Any]] = None

External data from Wikidata Properties

get_banana()[source]

Get the optional redundant prefix to go before an identifier.

A “banana” is an embedded prefix that isn’t actually part of the identifier. Usually this corresponds to the prefix itself, with some specific stylization such as in the case of FBbt. The banana does NOT include a colon “:” at the end

Return type

Optional[str]

Returns

The banana, if the prefix is valid and has an associated banana.

Explicitly annotated banana

>>> from bioregistry import get_resource
>>> get_resource("go.ref").get_banana()
'GO_REF'

Banana imported through OBO Foundry

>>> get_resource("go").get_banana()
'GO'
>>> get_resource("vario").get_banana()
'VariO'

Banana inferred for OBO Foundry ontology

>>> get_resource("chebi").get_banana()
'CHEBI'

No banana, no namespace in LUI

>>> get_resource("pdb").get_banana()
None

Banana is not inferred for OBO Foundry ontologies that were imported: >>> get_resource(“ncit”).get_banana() None >>> get_resource(“ncbitaxon”).get_banana() None

get_banana_peel()[source]

Get the delimiter between the banana and the local unique identifier.

Return type

str

get_biocontext_uri_format()[source]

Get the BioContext URI format string for this entry, if available.

Return type

Optional[str]

Returns

The BioContext URI format string, if available.

>>> from bioregistry import get_resource
>>> get_resource("hgmd").get_biocontext_uri_format()
'http://www.hgmd.cf.ac.uk/ac/gene.php?gene=$1'
get_contact()[source]

Get the contact, if available.

Return type

Optional[Attributable]

get_contact_email()[source]

Return the contact email, if available.

Return type

Optional[str]

Returns

The resource’s contact email address, if it is available.

>>> from bioregistry import get_resource
>>> get_resource("bioregistry").get_contact_email()  # from bioregistry curation
'cthoyt@gmail.com'
>>> get_resource("chebi").get_contact_email()
'amalik@ebi.ac.uk'
get_contact_github()[source]

Return the contact GitHub handle, if available.

Return type

Optional[str]

Returns

The resource’s contact GitHub handle, if it is available.

>>> from bioregistry import get_resource
>>> get_resource("bioregistry").get_contact_github()  # from bioregistry curation
'cthoyt'
>>> get_resource("agro").get_contact_github()  # from OBO Foundry
'marieALaporte'
get_contact_name()[source]

Return the contact name, if available.

Return type

Optional[str]

Returns

The resource’s contact name, if it is available.

>>> from bioregistry import get_resource
>>> get_resource("bioregistry").get_contact_name()  # from bioregistry curation
'Charles Tapley Hoyt'
>>> get_resource("chebi").get_contact_name()
'Adnan Malik'
get_contact_orcid()[source]

Return the contact ORCiD, if available.

Return type

Optional[str]

Returns

The resource’s contact ORCiD, if it is available.

>>> from bioregistry import get_resource
>>> get_resource("bioregistry").get_contact_orcid()  # from bioregistry curation
'0000-0003-4423-4370'
>>> get_resource("aero").get_contact_orcid()
'0000-0002-9551-6370'
get_curie(identifier, use_preferred=False)[source]

Get a CURIE for a local unique identifier in this resource’s semantic space.

Parameters
  • identifier (str) – A local unique identifier in this resource’s semantic space

  • use_preferred (bool) – Should preferred prefixes be used? Set this to true if you’re in the OBO context.

Return type

str

Returns

A CURIE for the given identifier

>>> import bioregistry
>>> resource = bioregistry.get_resource("go")
>>> resource.get_curie("0000001")
'go:0000001'
>>> resource.get_curie("0000001", use_preferred=True)
'GO:0000001'
get_default_format()[source]

Get the default, first-party URI prefix.

Return type

Optional[str]

Returns

The first-party URI prefix string, if available.

>>> from bioregistry import get_resource
>>> get_resource("ncbitaxon").get_default_format()
'https://www.ncbi.nlm.nih.gov/Taxonomy/Browser/wwwtax.cgi?mode=Info&id=$1'
>>> get_resource("go").get_default_format()
'http://amigo.geneontology.org/amigo/term/GO:$1'
get_default_uri(identifier)[source]

Return the default URI for the identifier.

Parameters

identifier (str) – The local identifier in the nomenclature represented by this resource

Return type

Optional[str]

Returns

The first-party provider URI for the local identifier, if one can be constructed

>>> from bioregistry import get_resource
>>> get_resource("chebi").get_default_uri("24867")
'https://www.ebi.ac.uk/chebi/searchId.do?chebiId=CHEBI:24867'
get_description(use_markdown=False)[source]

Get the description for the given prefix, if available.

Return type

Optional[str]

get_download_obo()[source]

Get the download link for the latest OBO file.

Return type

Optional[str]

Returns

A URL for an OBO text file download, if exists.

Get an ontology download link annotated directly in the Bioregistry:

>>> from bioregistry import get_resource
>>> get_resource("caloha").get_download_obo()
'https://download.nextprot.org/pub/current_release/controlled_vocabularies/caloha.obo'

Get an ontology download link from the OBO Foundry:

>>> get_resource("bfo").get_download_obo()
'http://purl.obolibrary.org/obo/bfo.obo'

Get ontology download link in AberOWL but not OBO Foundry (note this might change over time so the exact value isn’t used in the doctest):

>>> url = get_resource("dermo").get_download_obo()
>>> assert url is not None and url.startswith("http://aber-owl.net/media/ontologies/DERMO")
get_download_obograph()[source]

Get the download link for the latest OBOGraph JSON file.

Return type

Optional[str]

get_download_owl()[source]

Get the download link for the latest OWL file.

Return type

Optional[str]

Returns

A URL for an OWL file download, if exists.

Get an ontology download link annotated directly in the Bioregistry:

>>> from bioregistry import get_resource
>>> get_resource("orphanet.ordo").get_download_owl()
'http://www.orphadata.org/data/ORDO/ordo_orphanet.owl'

Get an ontology download link from the OBO Foundry:

>>> get_resource("mod").get_download_owl()
'http://purl.obolibrary.org/obo/mod.owl'

Get ontology download link in AberOWL but not OBO Foundry (note this might change over time so the exact value isn’t used in the doctest):

>>> url = get_resource("birnlex").get_download_owl()
>>> assert url is not None and url.startswith("http://aber-owl.net/media/ontologies/BIRNLEX/")
get_download_rdf()[source]

Get the download link for the latest RDF file.

Return type

Optional[str]

get_example()[source]

Get an example identifier, if it’s available.

Return type

Optional[str]

get_example_curie(use_preferred=False)[source]

Get an example CURIE, if an example identifier is available.

Parameters

use_preferred (bool) – Should the preferred prefix be used instead of the Bioregistry prefix (if it exists)?

Return type

Optional[str]

Returns

An example CURIE for this resource

get_example_iri()[source]

Get an example IRI.

Return type

Optional[str]

get_examples()[source]

Get a list of examples.

Return type

List[str]

get_external(metaprefix)[source]

Get an external registry.

Return type

Mapping[str, Any]

get_extra_providers()[source]

Get a list of all extra providers.

Return type

List[Provider]

get_homepage()[source]

Return the homepage, if available.

Return type

Optional[str]

get_identifiers_org_prefix()[source]

Get the MIRIAM/Identifiers.org prefix, if available.

Return type

Optional[str]

Returns

The Identifiers.org/MIRIAM prefix corresponding to the prefix, if mappable.

>>> from bioregistry import get_resource
>>> get_resource('chebi').get_identifiers_org_prefix()
'chebi'
>>> get_resource('ncbitaxon').get_identifiers_org_prefix()
'taxonomy'
>>> assert get_resource('MONDO').get_identifiers_org_prefix() is None
get_legacy_miriam_uri_format()[source]

Get the legacy Identifiers.org URI format string for this entry, if possible.

Return type

Optional[str]

get_license()[source]

Get the license for the resource.

Return type

Optional[str]

get_mapped_prefix(metaprefix)[source]

Get the prefix for the given external.

Parameters

metaprefix (str) – The metaprefix for the external resource

Return type

Optional[str]

Returns

The prefix in the external registry, if it could be mapped

>>> from bioregistry import get_resource
>>> get_resource("chebi").get_mapped_prefix("wikidata")
'P683'
>>> get_resource("chebi").get_mapped_prefix("obofoundry")
'CHEBI'
get_mappings()[source]

Get the mappings to external registries, if available.

Return type

Mapping[str, str]

get_miriam_curie(identifier)[source]

Get the MIRIAM-flavored CURIE.

Return type

Optional[str]

get_miriam_prefix()[source]

Get the MIRIAM/Identifiers.org prefix, if available.

get_miriam_uri_format(legacy_delimiter=False, legacy_protocol=False)[source]

Get the Identifiers.org URI format string for this entry, if possible.

Parameters
  • legacy_protocol (bool) – If true, uses HTTP

  • legacy_delimiter (bool) – If true, uses a slash delimiter for CURIEs instead of colon

Return type

Optional[str]

Returns

The Identifiers.org/MIRIAM URL format string, if available.

>>> from bioregistry import get_resource
>>> get_resource('ncbitaxon').get_miriam_uri_format()
'https://identifiers.org/taxonomy:$1'
>>> get_resource('go').get_miriam_uri_format()
'https://identifiers.org/GO:$1'
>>> assert get_resource('sty').get_miriam_uri_format() is None
get_miriam_uri_prefix(legacy_delimiter=False, legacy_protocol=False)[source]

Get the Identifiers.org URI prefix for this entry, if possible.

Parameters
  • legacy_protocol (bool) – If true, uses HTTP

  • legacy_delimiter (bool) – If true, uses a slash delimiter for CURIEs instead of colon

Return type

Optional[str]

Returns

The Identifiers.org/MIRIAM URI prefix, if available.

>>> from bioregistry import get_resource
>>> get_resource('ncbitaxon').get_miriam_uri_prefix()
'https://identifiers.org/taxonomy:'
>>> get_resource('go').get_miriam_uri_prefix()
'https://identifiers.org/GO:'
>>> assert get_resource('sty').get_miriam_uri_prefix() is None
get_n2t_uri_format(legacy_protocol=False)[source]

Get the Name-to-Thing URI format string, if available.

get_name()[source]

Get the name for the given prefix, it it’s available.

Return type

Optional[str]

get_namespace_in_lui()[source]

Check if the namespace should appear in the LUI.

Return type

Optional[bool]

get_nt2_uri_prefix(legacy_protocol=False)[source]

Get the Name-to-Thing URI prefix for this entry, if possible.

Return type

Optional[str]

get_obo_preferred_prefix()[source]

Get the OBO preferred prefix, if this resource is mapped to the OBO Foundry.

Return type

Optional[str]

get_obofoundry_prefix()[source]

Get the OBO Foundry prefix if available.

Return type

Optional[str]

Returns

The OBO prefix, if available.

>>> from bioregistry import get_resource
>>> get_resource("go").get_obofoundry_prefix()  # standard
'GO'
>>> get_resource("aao").get_obofoundry_prefix()  # standard but deprecated
'AAO'
>>> get_resource("ncbitaxon").get_obofoundry_prefix()  # mixed case
'NCBITaxon'
>>> assert get_resource("sty").get_obofoundry_prefix() is None
get_obofoundry_uri_format()[source]

Get the OBO Foundry URI format string for this entry, if possible.

Return type

Optional[str]

Returns

The OBO PURL format string, if available.

>>> from bioregistry import get_resource
>>> get_resource("go").get_obofoundry_uri_format()  # standard
'http://purl.obolibrary.org/obo/GO_$1'
>>> get_resource("ncbitaxon").get_obofoundry_uri_format()  # mixed case
'http://purl.obolibrary.org/obo/NCBITaxon_$1'
>>> assert get_resource("sty").get_obofoundry_uri_format() is None
get_obofoundry_uri_prefix()[source]

Get the OBO Foundry URI prefix for this entry, if possible.

Return type

Optional[str]

Returns

The OBO PURL URI prefix corresponding to the prefix, if mappable.

>>> from bioregistry import get_resource
>>> get_resource("go").get_obofoundry_uri_prefix()  # standard
'http://purl.obolibrary.org/obo/GO_'
>>> get_resource("ncbitaxon").get_obofoundry_uri_prefix()  # mixed case
'http://purl.obolibrary.org/obo/NCBITaxon_'
>>> assert get_resource("sty").get_obofoundry_uri_prefix() is None
get_ols_prefix()[source]

Get the OLS prefix if available.

Return type

Optional[str]

get_ols_uri_format()[source]

Get the OLS URI format string for this entry, if possible.

Return type

Optional[str]

Returns

The OLS format string, if available.

Warning

This doesn’t have a normal form, so it only works for OBO Foundry at the moment.

>>> from bioregistry import get_resource
>>> get_resource("go").get_ols_uri_format()  # standard
'https://www.ebi.ac.uk/ols/ontologies/go/terms?iri=http://purl.obolibrary.org/obo/GO_$1'
>>> get_resource("ncbitaxon").get_ols_uri_format()  # mixed case
'https://www.ebi.ac.uk/ols/ontologies/ncbitaxon/terms?iri=http://purl.obolibrary.org/obo/NCBITaxon_$1'
>>> assert get_resource("sty").get_ols_uri_format() is None
get_ols_uri_prefix()[source]

Get the OLS URI prefix for this entry, if possible.

Return type

Optional[str]

Returns

The OLS URI prefix, if available.

Warning

This doesn’t have a normal form, so it only works for OBO Foundry at the moment.

>>> from bioregistry import get_resource
>>> get_resource("go").get_ols_uri_prefix()  # standard
'https://www.ebi.ac.uk/ols/ontologies/go/terms?iri=http://purl.obolibrary.org/obo/GO_'
>>> get_resource("ncbitaxon").get_ols_uri_prefix()  # mixed case
'https://www.ebi.ac.uk/ols/ontologies/ncbitaxon/terms?iri=http://purl.obolibrary.org/obo/NCBITaxon_'
>>> assert get_resource("sty").get_ols_uri_prefix() is None
get_pattern()[source]

Get the pattern for the given prefix, if it’s available.

Return type

Optional[str]

Returns

The pattern for the prefix, if it is available, using the following order of preference: 1. Custom 2. MIRIAM 3. Wikidata

get_pattern_re()[source]

Get the compiled pattern for the given prefix, if it’s available.

get_pattern_re_with_banana(strict=True)[source]

Get the compiled pattern for the prefix including a banana if available.

Warning

This function is meant to mediate backwards compatibility with legacy MIRIAM/Identifiers.org standards. New projects should not use redundant prefixes in their local unique identifiers.

Parameters

strict (bool) – If True (default), and a banana exists for the prefix, the banana is required in the pattern. If False, the pattern will match the banana if present but will also match the identifier without the banana.

Returns

A compiled pattern for the prefix if available

>>> import bioregistry as br
>>> resource = br.get_resource("chebi")

Strict match requires banana >>> resource.get_pattern_re_with_banana().match(“1234”)

>>> resource.get_pattern_re_with_banana().match("CHEBI:1234")
<re.Match object; span=(0, 10), match='CHEBI:1234'>

Loose match does not require banana >>> resource.get_pattern_re_with_banana(strict=False).match(‘1234’) <re.Match object; span=(0, 4), match=’1234’> >>> resource.get_pattern_re_with_banana(strict=False).match(‘CHEBI:1234’) <re.Match object; span=(0, 10), match=’CHEBI:1234’>

get_pattern_with_banana(strict=True)[source]

Get the pattern for the prefix including a banana if available.

Warning

This function is meant to mediate backwards compatibility with legacy MIRIAM/Identifiers.org standards. New projects should not use redundant prefixes in their local unique identifiers.

Parameters

strict (bool) – If True (default), and a banana exists for the prefix, the banana is required in the pattern. If False, the pattern will match the banana if present but will also match the identifier without the banana.

Return type

Optional[str]

Returns

A pattern for the prefix if available

>>> import bioregistry as br
>>> resource = br.get_resource("chebi")

Strict match requires the banana to be present >>> resource.get_pattern_with_banana() ‘^CHEBI:\d+$’

Non-strict match allows the banana to be optionally present >>> resource.get_pattern_with_banana(strict=False) ‘^(CHEBI:)?\d+$’

get_preferred_prefix()[source]

Get the preferred prefix (e.g., with stylization) if it exists.

Return type

Optional[str]

Returns

The preferred prefix, if annotated in the Bioregistry or OBO Foundry.

No preferred prefix annotation, defaults to normalized prefix >>> from bioregistry import get_resource >>> get_resource(“rhea”).get_preferred_prefix() None

Preferred prefix defined in the Bioregistry >>> get_resource(“wb”).get_preferred_prefix() ‘WormBase’

Preferred prefix defined in the OBO Foundry >>> get_resource(“fbbt”).get_preferred_prefix() ‘FBbt’

Preferred prefix from the OBO Foundry overridden by the Bioregistry (see also https://github.com/OBOFoundry/OBOFoundry.github.io/issues/1559) >>> get_resource(“dpo”).get_preferred_prefix() ‘DPO’

get_prefix_key(key, metaprefixes)[source]

Get a key enriched by the given external resources’ data.

get_prefixcommons_uri_format()[source]

Get the Prefix Commons URI format string for this entry, if available.

Return type

Optional[str]

Returns

The Prefix Commons URI format string, if available.

>>> from bioregistry import get_resource
>>> get_resource("antweb").get_prefixcommons_uri_format()
'http://www.antweb.org/specimen.do?name=$1'
get_priority_prefix(priority=None)[source]

Get a prioritized prefix.

Parameters

priority (Union[None, str, Sequence[str]]) –

A metaprefix or list of metaprefixes used to choose a prioritized prefix. Some special values that are not themselves metaprefixes are allowed from the following list:

  • ”default”: corresponds to the bioregistry prefix

  • ”bioregistry.upper”: an uppercase transform of the canonical bioregistry prefix

  • ”preferred”: a preferred prefix, typically includes stylization in capitalization

  • ”obofoundry.preferred”: the preferred prefix annotated in OBO Foundry

Return type

str

Returns

The prioritized prefix for this record

get_publications()[source]

Get a list of publications.

Return type

List[Publication]

get_repository()[source]

Return the repository, if available.

Return type

Optional[str]

get_scholia_prefix()[source]

Get the Scholia prefix, if available.

get_short_description(use_markdown=False)[source]

Get a short description.

Return type

Optional[str]

get_synonyms()[source]

Get synonyms.

Return type

Set[str]

get_twitter()[source]

Get the Twitter handle for ther resource.

Return type

Optional[str]

get_uri_format(priority=None)[source]

Get the URI format string for the given prefix, if it’s available.

Parameters

priority (Optional[Sequence[str]]) –

The priority order of metaresources to use for format URI lookup. The default is:

  1. Default first party (from the Bioregistry, BioContext, or MIRIAM)

  2. OBO Foundry

  3. BioContext

  4. MIRIAM/Identifiers.org

  5. N2T

  6. OLS

  7. Prefix Commons

Return type

Optional[str]

Returns

The best URI format string, where the $1 should be replaced by a local unique identifier. $1 could potentially appear multiple times.

>>> from bioregistry import get_resource
>>> get_resource("chebi").get_uri_format()
'https://www.ebi.ac.uk/chebi/searchId.do?chebiId=CHEBI:$1'

If you want to specify a different priority order, you can do so with the priority keyword. This is of particular interest to ontologists and semantic web people who might want to use purl.obolibrary.org URL prefixes over the URL prefixes corresponding to the first-party providers for each resource (e.g., the ChEBI example above). Do so like:

>>> from bioregistry import get_resource
>>> priority = ['obofoundry', 'bioregistry', 'biocontext', 'miriam', 'ols']
>>> get_resource("chebi").get_uri_format(priority=priority)
'http://purl.obolibrary.org/obo/CHEBI_$1'
get_uri_formats()[source]

Get the set of all URI format strings.

Return type

Set[str]

get_uri_prefix(priority=None)[source]

Get a well-formed URI prefix, if available.

Parameters

priority (Optional[Sequence[str]]) – The prioirty order for get_format().

Return type

Optional[str]

Returns

The URI prefix. Similar to what’s returned by get_uri_format(), but it MUST have only one $1 and end with $1 to use the function.

>>> import bioregistry
>>> bioregistry.get_uri_prefix('chebi')
'https://www.ebi.ac.uk/chebi/searchId.do?chebiId=CHEBI:'
get_uri_prefixes()[source]

Get the set of all URI prefixes.

Return type

Set[str]

get_version()[source]

Get the version for the resource.

Return type

Optional[str]

has_download()[source]

Check if this resource can be downloaded.

Return type

bool

is_deprecated()[source]

Return if the given prefix corresponds to a deprecated resource.

Return type

bool

Returns

If the prefix has been explicitly marked as deprecated either by the Bioregistry, OBO Foundry, OLS, or MIRIAM. If no marks are present, assumed not to be deprecated.

>>> from bioregistry import get_resource
>>> assert get_resource("imr").is_deprecated()  # marked by OBO
>>> assert get_resource("iro").is_deprecated() # marked by Bioregistry
>>> assert get_resource("miriam.collection").is_deprecated() # marked by MIRIAM
is_standardizable_identifier(identifier)[source]

Check that a local unique identifier can be normalized and also matches a prefix’s pattern.

Return type

bool

is_valid_identifier(identifier)[source]

Check that a local unique identifier is canonical, meaning no bananas.

Return type

bool

miriam_standardize_identifier(identifier)[source]

Normalize the identifier for legacy usage with MIRIAM using the appropriate banana.

Parameters

identifier (str) – The identifier in the CURIE

Return type

Optional[str]

Returns

A normalize identifier, possibly with banana/redundant prefix added

Because identifiers.org used to have URIs in the form of https://identifiers.org/<prefix>/<prefix>:<identifier> for entries annotated with namespaceEmbeddedInLui as true

Examples with explicitly annotated bananas: >>> from bioregistry import get_resource >>> get_resource(“vario”).miriam_standardize_identifier(‘0376’) ‘VariO:0376’ >>> get_resource(“vario”).miriam_standardize_identifier(‘VariO:0376’) ‘VariO:0376’

Examples with bananas from OBO: >>> get_resource(“go”).miriam_standardize_identifier(‘0000001’) ‘GO:0000001’ >>> get_resource(“go”).miriam_standardize_identifier(’GO:0000001’) ‘GO:0000001

Examples from OBO Foundry: >>> get_resource(“chebi”).miriam_standardize_identifier(‘1234’) ‘CHEBI:1234’ >>> get_resource(“chebi”).miriam_standardize_identifier(‘CHEBI:1234’) ‘CHEBI:1234’

Examples from OBO Foundry that should not have a redundant prefix added: >>> get_resource(“ncit”).miriam_standardize_identifier(“C73192”) ‘C73192’ >>> get_resource(“ncbitaxon”).miriam_standardize_identifier(“9606”) ‘9606’

Standard: >>> get_resource(“pdb”).miriam_standardize_identifier(‘00000020’) ‘00000020’

standardize_identifier(identifier)[source]

Normalize the identifier to not have a redundant prefix or banana.

Parameters

identifier (str) – The identifier in the CURIE

Return type

str

Returns

A normalized identifier, possibly with banana/redundant prefix removed

Examples with explicitly annotated bananas: >>> from bioregistry import get_resource >>> get_resource(“vario”).standardize_identifier(‘0376’) ‘0376’ >>> get_resource(“vario”).standardize_identifier(‘VariO:0376’) ‘0376’ >>> get_resource(“swisslipid”).standardize_identifier(‘000000001’) ‘000000001’ >>> get_resource(“swisslipid”).standardize_identifier(‘SLM:000000001’) ‘000000001’

Examples with bananas from OBO: >>> get_resource(“fbbt”).standardize_identifier(‘00007294’) ‘00007294’ >>> get_resource(“chebi”).standardize_identifier(‘1234’) ‘1234’ >>> get_resource(“chebi”).standardize_identifier(‘CHEBI:1234’) ‘1234’

Examples from OBO Foundry that should not have a redundant prefix added: >>> get_resource(“ncit”).standardize_identifier(“C73192”) ‘C73192’ >>> get_resource(“ncbitaxon”).standardize_identifier(“9606”) ‘9606’

Standard: >>> get_resource(“pdb”).standardize_identifier(‘00000020’) ‘00000020’

DEFAULT_URI_FORMATTER_PRIORITY: ClassVar[Sequence[str]] = ('default', 'obofoundry', 'biocontext', 'miriam', 'n2t', 'ols', 'prefixcommons')
URI_FORMATTERS: ClassVar[Mapping[str, Callable[[Resource], Optional[str]]]] = {'biocontext': <function Resource.get_biocontext_uri_format>, 'default': <function Resource.get_default_format>, 'miriam': <function Resource.get_miriam_uri_format>, 'miriam.legacy': <function Resource.get_legacy_miriam_uri_format>, 'n2t': <function Resource.get_n2t_uri_format>, 'obofoundry': <function Resource.get_obofoundry_uri_format>, 'ols': <function Resource.get_ols_uri_format>, 'prefixcommons': <function Resource.get_prefixcommons_uri_format>}