Sample DRAFT Profile
Version: 0.2-DRAFT-2018_11_10 (10 November 2018)
Bioschemas profile for describing Samples in the life-science
If you spot any errors or omissions with this type, please file an issue in our GitHub.
You can read the release version of this specification here.
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. Bioschemas: Unique sample IDs. Where possible this should be an identifiers.org compliant prefixed id e.g. a BioSamples ID biosample:SAME12345. |
MANY | ||
| rdf:type |
URL |
Bioschemas: This is used by validation tools to indentify the profile used. You must use the value specified in the Controlled Vocabulary column. |
ONE | ||
| Marginality: Recommended. | |||||
| url |
URL |
Schema: URL of the item. Bioschemas: An access URL for this sample, e.g., in BioSamples or in a Biobank or elsewhere. |
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: A property-value pair representing an additional characteristics of the entity, e.g. “Organism: Homo sapiens” or “tissue type: leaf”. For details of how to use PropertyValue see below. |
MANY | ||
| description |
Text |
Schema: A description of the item. Bioschemas: A description of the sample in free text. This should not contain information that could be better expressed as key/value pairs. These should be expressed using additionalProperty. |
ONE | ||
| name |
Text |
Schema: The name of the item. Bioschemas: A human readable name for the sample. This should not be an additional identifier. Additional identifiers should be added to the identifier field. |
MANY | ||
| subjectOf |
CreativeWork Event |
Schema: A CreativeWork or Event about this Thing.. Inverse property: about. Bioschemas: Provides a link to a dataset that contains data about this sample record. |
MANY | ||
PropertyValue
| Property | Expected Type | Description | CD | Controlled Vocabulary |
|---|---|---|---|---|
| Marginality: Minimum | ||||
| name | Text |
Schema: The name of the item. Bioschemas: The name of the additional property. Otherwise known as a key or attribute. | ONE | |
| value |
Boolean Number Text |
Schema: The value of the quantitative value or property value node.
Bioschemas: Attribute value. Note: Bioschemas have removed StructuredValue from the Expected Types. ONE |
| |
| Marginality: Recommended | ||||
| valueReference | CategoryCode |
Schema: A pointer to a secondary value that provides additional information on the original value, e.g. a reference temperature. Bioschemas: Catagory code to enhance the value this could be a link to an ontology term in the Ontology Lookup Service. Note: Bioschemas has added CategoryCode to the ExpectedTypes (of valueReference) and removed Enumeration, PropertyValue, QualitativeValue QuantitativeValue, and StructuredValue. |
MANY | |
| Marginality: Optional | ||||
| unitCode |
Text URL |
Schema: The unit of measurement given using the UN/CEFACT Common Code (3 characters) or a URL. Other codes than the UN/CEFACT Common Code may be used with a prefix followed by a colon. | ONE | |
| unitText | Text | Schema: A string or text indicating the unit of measurement. Useful if you cannot provide a standard unit code for unitCode. | ONE | |
CategoryCode
| Property | Expected Type | Description | CD | Controlled Vocabulary |
|---|---|---|---|---|
| Marginality: Minimum | ||||
| name | Text |
Schema: The name of the item. Bioschemas: A human readable label. | MANY | |
| codeValue | Text | Schema: A short textual code that uniquely identifies the value. | MANY | |
| url | URL |
Schema: URL of the item. Bioschemas: The URI for the vocabulary code. |
MANY | |