Protein DRAFT Profile
Version: 0.5-DRAFT-2018_08_15 (15 August 2018)
Bioschemas specification describing a Protein (BioChemEntity profile) in Life Sciences.
If you spot any errors or omissions with this type, please file an issue in our GitHub.
Key to specification table
- Green properties/types are proposed by Bioschemas, or indicate proposed changes by Bioschemas to Schema.org
- Red properties/types exist in the core of Schema.org
- Blue properties/types exist in the pending area of Schema.org
- Black properties/types are reused from external vocabularies/ontologies
CD = Cardinality
Property | Expected Type | Description | CD | Controlled Vocabulary | Example |
---|---|---|---|---|---|
Marginality: Minimum. | |||||
@context | URL | Used to provide the context (namespaces) for the JSON-LD file. Not needed in other serialisations. |
ONE | ||
@type | Text | Schema.org/Bioschemas class for the resource declared using JSON-LD syntax. For other serialisations please use the appropriate mechanism. While it is permissible to provide multiple types, it is preferred to use a single type. |
MANY | Schema.org, Bioschemas | |
@id | IRI | Used to distinguish the resource being described in JSON-LD. For other serialisations use the appropriate approach. | ONE | ||
dct:conformsTo | IRI | Used to state the Bioschemas profile that the markup relates to. The versioned URL of the profile must be used. Note that we use a CURIE in the table here but the full URL for Dublin Core terms must be used in the markup (http://purl.org/dc/terms/conformsTo), see example. |
ONE | Bioschemas profile versioned URL | |
identifier |
PropertyValue Text URL |
Schema: The identifier property represents any kind of identifier for any kind of Thing, such as ISBNs, GTIN codes, UUIDs etc. Schema.org provides dedicated properties for representing many of these, either as textual strings or as URL (URI) links. See background notes for more details. |
ONE | ||
name |
Text |
Schema: The name of the item. |
ONE | ||
Marginality: Recommended. | |||||
associatedWith |
MedicalCondition URL |
Bioschemas: Disease associated to this protein, if any. |
MANY | ||
description |
Text |
Schema: A description of the item. Bioschemas: Protein function. We recommend to start the description with “Function: […]”. |
ONE | ||
image |
ImageObject URL |
Schema: An image of the item. This can be a URL or a fully described ImageObject. |
MANY | ||
isContainedIn |
BioChemEntity |
Bioschemas: Indicates a BioChemEntity that this BioChemEntity is (in some sense) part of this BioChemEntity. Inverse property: containedIn Bioschemas Protein: For proteins, it is recommended to at least specify the taxon/organism associated to the described protein. For taxon/organism, it is a good practice to use hasCategoryCode to point to a controlled vacabulary such as NCBI taxon or UniProt Taxonomy. Including as well the GO cellular locations is optional; for cellular locations it is a good practice to use hasCategorryCode to point to a GO Cellular Location term. |
MANY | Any suitable ontology |
|
isTranslatedFrom |
BioChemEntity Gene |
Bioschemas: SIO:010083 (is translated from). Gene(s) from which this protein was translated from. In addtion to the schema:BioChemEntity type, this property also expects a bioschemas:Gene profile. |
MANY | Any suitable ontology |
|
url |
URL |
Schema: URL of the item. Bioschemas: Link to the official webpage associated to this entity. |
ONE | ||
Marginality: Optional. | |||||
additionalProperty |
PropertyValue |
Schema: A property-value pair representing an additional characteristics of the entitity, e.g. a product feature or another characteristic for which there is no matching property in schema.org. Note: Publishers should be aware that applications designed to use specific schema.org properties (e.g. http://schema.org/width, http://schema.org/color, http://schema.org/gtin13, …) will typically expect such data to be provided using those properties, rather than using the generic property/value mechanism. Bioschemas: Whenever possible, please use a property coined in a third-party well-known vocabulary. For instance, you can directly use RO ObjectProperty: enables as a property to express how a protein or gene enables some GO molecular function. If you still want or need to use additionalProperty, please use (i) property name to specify the name of the property, (ii) additionalType (if possible) to better specify the nature of the property, and (iii) value to link to the object/range of this property. We recommed to look at the OBO Relations Ontology (RO) or the Semanticscience Integrated Ontology (SIO) as starting points. Bioschemas Protein: If no suitable property exists in this profile, use any ontology term coined as a property and suitable for your needs. For instance sio:SIO_000095 (is member of) could be used to model the relation between a protein and a protein clan. |
MANY | ||
additionalType |
URL |
Schema: An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. In RDFa syntax, it is better to use the native RDFa syntax - the ‘typeof’ attribute - for multiple types. Schema.org tools may have only weaker understanding of extra types, in particular those defined externally. Bioschemas: Any ontology term describing the protein concept. This is in addition to the official type used in Bioscheamas to describe a protein. The official type for the Protein profile is PR 000000001 |
MANY | For instance wikidata:protein SIO:010043 |
|
alternateName |
Text |
Schema: An alias for the item. |
MANY | ||
contains |
BioChemEntity ProteinAnnotation |
Bioschemas: Indicates a BioChemEntity that is (in some sense) a part of this BioChemEntity. Inverse property: isContainedIn. Bioschemas Protein: For proteins, it can be used to link to protein sequence annotations such as domains, sites, regions, etc. |
MANY | Any suitable ontology |
|
enablesMF |
CategoryCode PropertyValue |
Bioschemas: RO:0002327 (enables). GO molecular function enabled by the gene/protein. Recommended range: BioChemEntity or CategoryCode, ProteinAnnotation if evidence should be included. |
MANY | ||
hasCategoryCode |
CategoryCode |
Schema: A Category code contained in this code set. Bioschemas: A controlled vocabulary term equivalent to this entity. For instance, an organism coined in NCBI taxonomy can be represented as a BioChemEntity. As it also exists as a term in an ontology, it would be nice to capture that information via categoryCode. |
MANY | Any suitable controlled vocabulary |
|
hasRepresentation |
PropertyValue Text URL |
Bioschemas: A representation for this entity other than, for instance, an image (use image property for that) or the main web page/record (use mainEntityOfPage for that), and see background notes, for sameAs and url). Bioschemas Protein: This property could be used, for instance, to register a sequence protein as it is a representation of the protein. If you want to better define the nature of the representation, use a PropertyValue as described in additionalProperty. |
MANY | ||
involvedInBP |
CategoryCode PropertyValue |
Bioschemas: RO:0002331 (is involved in). GO biological process this gene/protein is involved in. Recommended range: BioChemEntity or CategoryCode, ProteinAnnotation if evidence should be included. |
MANY | ||
location |
Place PostalAddress PropertyValue Text URL |
Schema: The location of for example where the event is happening, an organization is located, or where an action takes place. Bioschemas: The location can be refer to a position in a chromosome or sequence or to a physical place where, for instance, a sample is stored. Using additionalType is advised to make the distinction. For instance, FALDO can be used for sequence coordinates. Note: The list of Expected Types has been extended as schema.org/location only has Place, PostalAddress and Text. |
MANY | ||
mainEntityOfPage |
CreativeWork URL |
Schema: Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See background notes for details. Inverse property: mainEntity. Bioschemas: Link via DataRecord to the main DataRecord representing this entity in a dataset. Bioschemas Protein: Currently not in use; use the mainEntity property from DataRecord instead. |
MANY | ||
sameAs |
URL |
Schema: URL of a reference Web page that unambiguously indicates the item’s identity. E.g. the URL of the item’s Wikipedia page, Wikidata entry, or official website. Bioschemas: Link to any resource other than the Record and the official webpage, for instance a Wikipedia page. |
MANY |