{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.tr.chemical-database","code":"thing-q2881060","url":"https://ver.cy/models/thing/q2881060/","name":"chemical database","alternateNames":["biochemical database","crystallographic database","nucleic acid database"],"kind":"thing","status":"published","version":"0.1.0-research.1","language":"en","classifiers":{"family":"Thing Registry","category":"Information and virtual systems","entryKind":"thing","plane":"INF","domain":["INF.MED"],"industry":[],"navPath":"","tags":[],"facets":{}},"whatItIs":"A chemical database is an organized collection of electronically retrievable records describing chemical entities, their structures, properties, reactions or associated evidence, with mechanisms for identifying and searching those records.","purpose":"Enable an agent to recognise a chemical database, assess whether its chemical records support an intended use, and determine which retrieval, comparison, reuse or update actions are appropriate.","scope":{"in":["Database identity, stewardship, intended audience and chemical coverage","Chemical record types and rules for distinguishing or grouping chemical entities","Representation of chemical structures, properties and associated evidence","Chemical search, record linking, export and retrieval capabilities","Curation state, release history, access conditions and permitted reuse"],"out":["Physical chemical substances, mixtures, specimens and their intrinsic states","Laboratory experiments and instruments that generate source measurements","Database engines, hosting infrastructure and application source code","Research articles and other source works as independently managed publications","Chemical inventory holdings, procurement and physical stock movements","Clinical, toxicological or regulatory decisions made using retrieved information"],"boundaries":[]},"distinguishingFeatures":["Its organising subjects are chemical entities or chemically characterised materials, rather than documents that merely mention chemistry.","It exposes chemical records through explicit identifiers, names, structures or composition descriptions that support repeatable retrieval.","It has an ascertainable convention for what a record denotes, such as a compound identity, depositor substance description or mixture.","It associates chemical entities with structured information or links; a standalone molecular drawing or unindexed document collection does not meet this test.","Its identity is distinguishable from both a particular downloaded release and the web interface or software used to access it."],"structure":{"bundles":[{"id":"chemical-coverage-and-record-boundaries","name":"Chemical coverage and record boundaries","description":"Establishes which chemical subjects the resource covers and what each kind of record denotes.","layers":[{"id":"chemical-collection-remit","name":"Chemical collection remit","description":"Captures the resource's inclusion rules and intended chemical uses.","findings":[{"id":"declared-chemical-coverage","name":"Declared chemical coverage","description":"Record the stated inclusion and exclusion criteria without interpreting catalogue size as completeness.","questions":[{"text":"Which chemical classes, material types and application domains does this database explicitly include or exclude?","id":"declared-chemical-coverage-q01","kind":"boundary"},{"text":"What evidence supports any claim that its coverage is complete for a particular chemical population?","id":"declared-chemical-coverage-q02","kind":"provenance"}]}]},{"id":"chemical-record-referents","name":"Chemical record referents","description":"Distinguishes chemical identities from submitted substance descriptions and multicomponent materials.","findings":[{"id":"record-denotation","name":"Record denotation","description":"Make explicit whether a record denotes a defined chemical identity, a submitted description, a mixture or another chemically described subject.","questions":[{"text":"What does each record type denote, and can several depositor records refer to one chemical identity?","id":"record-denotation-q01","kind":"definition"},{"text":"How are mixtures, polymers and materials with incomplete or variable composition represented or excluded?","id":"record-denotation-q02","kind":"boundary"}]}]}]},{"id":"chemical-identity-and-representation","name":"Chemical identity and representation","description":"Describes how chemical distinctions are encoded, normalised and linked.","layers":[{"id":"structure-identity-rules","name":"Structure identity rules","description":"Records which structural differences create separate identities and which are normalised.","findings":[{"id":"normalisation-and-distinction-policy","name":"Normalisation and distinction policy","description":"Capture the treatment of stereochemistry, isotopes, charge, protonation, tautomers and salt components, including information lost during normalisation.","questions":[{"text":"Which differences in stereochemistry, isotope specification, protonation, tautomerism or salt composition create separate records?","id":"normalisation-and-distinction-policy-q01","kind":"boundary"},{"text":"Which transformations are applied to submitted structures, and is the original representation retained?","id":"normalisation-and-distinction-policy-q02","kind":"provenance"}]}]},{"id":"chemical-names-and-cross-references","name":"Chemical names and cross-references","description":"Connects chemical records to names and external identifiers without assuming every link expresses exact identity.","findings":[{"id":"identifier-equivalence","name":"Identifier equivalence","description":"Record identifier authority, mapping provenance and whether a cross-reference means exact identity, a broader relationship or an unresolved candidate match.","questions":[{"text":"Which names and identifiers are preferred, supplied by depositors or mapped from external resources?","id":"identifier-equivalence-q01","kind":"provenance"},{"text":"How can an agent distinguish exact chemical equivalence from parent-compound, component or ambiguous-name links?","id":"identifier-equivalence-q02","kind":"action"}]}]}]},{"id":"chemical-assertions-and-evidence","name":"Chemical assertions and evidence","description":"Qualifies chemical properties and associated claims by their origin, conditions and uncertainty.","layers":[{"id":"property-meaning-and-conditions","name":"Property meaning and conditions","description":"Preserves the meaning of chemical measurements and computed descriptors.","findings":[{"id":"qualified-property-values","name":"Qualified property values","description":"Associate values with units, methods and relevant conditions such as temperature, pressure, solvent, pH or material form.","questions":[{"text":"For a retrieved property, which units, experimental conditions and chemical or material form are recorded?","id":"qualified-property-values-q01","kind":"measurement"},{"text":"Does the record distinguish measured values from calculations or predictions and identify the relevant method or model version?","id":"qualified-property-values-q02","kind":"provenance"}]}]},{"id":"assertion-lineage-and-conflict","name":"Assertion lineage and conflict","description":"Makes supporting evidence and disagreements inspectable at the chemical assertion level.","findings":[{"id":"traceable-and-contested-claims","name":"Traceable and contested claims","description":"Retain source attribution, extraction or transformation history, and unresolved disagreement rather than silently treating one value as definitive.","questions":[{"text":"Can each chemical assertion be traced to an inspected source, depositor submission or documented computation?","id":"traceable-and-contested-claims-q01","kind":"provenance"},{"text":"When values disagree, does the database preserve alternatives and explain any preferred-value selection?","id":"traceable-and-contested-claims-q02","kind":"definition"}]}]}]},{"id":"chemical-search-and-data-transfer","name":"Chemical search and data transfer","description":"Defines what chemical queries mean and what survives retrieval and export.","layers":[{"id":"chemical-query-semantics","name":"Chemical query semantics","description":"Qualifies name, structure, substructure and similarity searches by their actual matching rules.","findings":[{"id":"interpretable-chemical-matches","name":"Interpretable chemical matches","description":"Record supported query modes and the parameters that determine inclusion, ranking and chemical equivalence.","questions":[{"text":"How do exact-structure and substructure searches handle unspecified stereochemistry, aromaticity, tautomers and disconnected components?","id":"interpretable-chemical-matches-q01","kind":"definition"},{"text":"For similarity search, which representation, metric and threshold define a match, and are those settings exposed?","id":"interpretable-chemical-matches-q02","kind":"measurement"}]}]},{"id":"chemical-export-fidelity","name":"Chemical export fidelity","description":"Assesses whether exported chemical records preserve identity and evidence needed for downstream use.","findings":[{"id":"transferable-chemical-context","name":"Transferable chemical context","description":"Identify whether exports preserve structural distinctions, property qualifications, provenance and stable references.","questions":[{"text":"Which export formats preserve stereochemistry, isotope labels, component relationships and uncertain structural information?","id":"transferable-chemical-context-q01","kind":"boundary"},{"text":"How can an agent retrieve a complete result set with property conditions, evidence links and release information intact?","id":"transferable-chemical-context-q02","kind":"action"}]}]}]},{"id":"chemical-curation-and-permitted-use","name":"Chemical curation and permitted use","description":"Tracks chemical record changes and the conditions under which chemical content may be accessed or reused.","layers":[{"id":"chemical-record-lifecycle","name":"Chemical record lifecycle","description":"Preserves continuity when structures, identities or property assertions change.","findings":[{"id":"chemical-corrections-and-release-history","name":"Chemical corrections and release history","description":"Track record merges, splits, withdrawals and corrected structures or values with sufficient history to reproduce prior use.","questions":[{"text":"What happens to identifiers and incoming links when chemical records are merged, split or withdrawn?","id":"chemical-corrections-and-release-history-q01","kind":"definition"},{"text":"How can an agent identify the exact chemical record version used and submit a suspected structure or property error?","id":"chemical-corrections-and-release-history-q02","kind":"action"}]}]},{"id":"chemical-content-access-and-rights","name":"Chemical content access and rights","description":"Connects retrieval and reuse actions to terms covering the relevant chemical records and contributed data.","findings":[{"id":"permitted-chemical-data-operations","name":"Permitted chemical data operations","description":"Record access constraints and applicable terms for structure collections, property tables and contributed annotations.","questions":[{"text":"Do chemical structures, property values and third-party annotations share the same reuse terms, or are exceptions identified?","id":"permitted-chemical-data-operations-q01","kind":"boundary"},{"text":"Which conditions apply to automated retrieval, local caching, bulk export and redistribution of the intended chemical dataset?","id":"permitted-chemical-data-operations-q02","kind":"action"}]}]}]},{"id":"evidence-and-external-alignment","name":"Evidence and external alignment","description":"What the world already says about this thing, gathered so the model can be checked against it.","layers":[{"id":"reported-evidence","name":"Reported evidence","description":"Findings from the breadth pass, kept separate from the structural claims.","findings":[{"id":"evidence-confidence-notes","name":"Check these first","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these check these first hold for the sense of chemical database this model covers, and on what evidence?","id":"evidence-confidence-notes-q01","kind":"provenance"}]},{"id":"evidence-kinds","name":"Kinds and varieties","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these kinds and varieties hold for the sense of chemical database this model covers, and on what evidence?","id":"evidence-kinds-q01","kind":"provenance"}]},{"id":"evidence-identifiers","name":"Identifiers and schemes","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these identifiers and schemes hold for the sense of chemical database this model covers, and on what evidence?","id":"evidence-identifiers-q01","kind":"provenance"}]},{"id":"evidence-standards-and-regulation","name":"Standards and regulation","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these standards and regulation hold for the sense of chemical database this model covers, and on what evidence?","id":"evidence-standards-and-regulation-q01","kind":"provenance"}]},{"id":"evidence-real-world-use","name":"Real-world use","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these real-world use hold for the sense of chemical database this model covers, and on what evidence?","id":"evidence-real-world-use-q01","kind":"provenance"}]},{"id":"evidence-failure-modes-and-hazards","name":"Failure modes and hazards","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these failure modes and hazards hold for the sense of chemical database this model covers, and on what evidence?","id":"evidence-failure-modes-and-hazards-q01","kind":"provenance"}]},{"id":"evidence-regional-variation","name":"Regional variation","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these regional variation hold for the sense of chemical database this model covers, and on what evidence?","id":"evidence-regional-variation-q01","kind":"provenance"}]},{"id":"evidence-neighbours","name":"Neighbouring kinds and how to tell them apart","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these neighbouring kinds and how to tell them apart hold for the sense of chemical database this model covers, and on what evidence?","id":"evidence-neighbours-q01","kind":"provenance"}]}]}]}]},"agentConduct":{"may":["Search, cite and summarize records from chemical databases it is authorized to use, naming the source and version.","Flag inconsistent or missing data, such as conflicting identifiers or properties."],"mustNot":["Use database records to help anyone make chemical weapons, explosives or illicit drugs.","Present predicted or unverified values as measured data.","Scrape or redistribute database content against its licence.","Alter records in a shared database without authorization."],"requiresHuman":["Publishing data on hazardous substances beyond its existing audience.","Correcting or removing records in a shared database."]},"ethics":{"considerations":["Chemical databases support safety and research but can also aid misuse.","Errors spread quickly into safety data sheets and models that people rely on."],"affectedParties":["Laboratory workers","Researchers","The public exposed to chemicals"]},"owners":{"steward":"The organization that curates the database.","roles":[],"masterSystems":[]},"relations":[{"target":"Q1391125","type":"parent","note":"registry parent class"}],"interaction":{"identity":{"applicability":"required","items":["Vercy registry: vr.tr.chemical-database","Wikidata: Q2881060 (https://www.wikidata.org/wiki/Q2881060)"]},"properties":{"applicability":"not-applicable","items":["Chemical coverage: Declared included and excluded chemical classes, material types and application domains","Record referent: Compound identity; depositor substance; mixture; material; other declared referent","Chemical identity policy: Declared handling of stereochemistry, isotopes, charge, protonation, tautomers, salts and components","Structure representation support: Supported encodings and their treatment of connectivity, stereochemistry, coordinates and uncertain structure","Chemical record count: Records, qualified by referent type, release and counting rule","Evidence traceability: Per-assertion provenance; record-level provenance only; mixed; undocumented","Property evidence type: Measured; calculated; predicted; depositor-asserted; mixed; unspecified, recorded per assertion","Chemical retrieval capabilities: Name; identifier; exact structure; substructure; similarity; formula; property filtering, as supported","Release and maintenance state: Release identifier or retrieval timestamp, with active, frozen, archived, unavailable or unknown maintenance state","Chemical data reuse conditions: Applicable terms linked to the database, contributed datasets and restricted record fields"]},"recognition":{"applicability":"not-applicable","items":[]},"capabilities":{"applicability":"required","items":["Resolve a chemical name, identifier or structure to candidate records while preserving unresolved identity ambiguity.","Retrieve chemical properties with units, conditions, evidence types and source attribution.","Search for exact structures, substructures or similar structures where supported and retain the search semantics.","Compare chemical records across resources using explicit equivalence criteria.","Export or cite a reproducible set of chemical records subject to applicable access and reuse conditions.","Flag suspected chemical identity errors, conflicting values or obsolete links through supported curation channels."]},"hazards":{"applicability":"required","items":["Wrong structures or identifiers lead to mistaken handling of hazardous substances.","Data errors spread through copies and models that reuse the records."]},"interfaces":{"applicability":"required","items":["The International Chemical Identifier standard, issued by the International Union of Pure and Applied Chemistry, supports chemical structure identification in databases that implement it.","The SQL standard ISO/IEC 9075, issued by the International Organization for Standardization and the International Electrotechnical Commission, applies to relational database implementations using SQL."]},"context":{"applicability":"required","items":["Chemical databases support retrieval and comparison of chemical structures, properties, reactions and supporting evidence.","They are used in research, substance identification, laboratory informatics and regulatory information management."]}},"sources":[{"title":"Wikidata item Q2881060: chemical database","url":"https://www.wikidata.org/wiki/Q2881060","note":"identity and sense of the item"},{"title":"Wikipedia: Chemical database","url":"https://en.wikipedia.org/wiki/Chemical_database","note":"general description of the item"}],"openQuestions":["Does the registry intend chemical database to include reaction-centred and spectral databases, or should those be neighbouring specialisations?","Which existing Vercy information-resource or database model should supply inherited concepts without duplicating this chemical specialisation?","What minimum chemical organisation distinguishes a chemical database from a searchable collection of chemistry documents?","Which identity-policy and evidence fields can be established consistently across representative chemical databases, and which must remain explicitly unknown?","Should archived chemical dataset releases instantiate this model directly or be modelled as manifestations of a continuing database resource?"],"resources":{"spec":"/models/things/publications/thing-q2881060/spec.json"},"provenance":{"origin":"thing registry research (pass 2)","builtFrom":["models/things/publications/thing-q2881060/spec.json"],"providers":["Codex"],"researchStatus":"unreviewed","generatedAt":"2026-09-12T08:35:14Z","builder":"tools/build_cards.py@1.0.0"},"completeness":{"sections":{"classifiers":"filled","whatItIs":"filled","purpose":"filled","distinguishingFeatures":"filled","structure":"filled","agentConduct":"filled","ethics":"filled","owners":"filled","relations":"filled","interaction.identity":"filled","interaction.properties":"not-applicable","interaction.recognition":"not-applicable","interaction.capabilities":"filled","interaction.hazards":"filled","interaction.interfaces":"filled","interaction.context":"filled","sources":"filled"},"notes":{"_gate":"Published through the thing publication gate 1.0 on 2026-10-07T10:10:29+00:00: completeness 1.00; sense: Wikidata description; 2 live sources; review by codex: pass","interaction.properties":"Plane INF: no invented physical properties.","interaction.recognition":"A chemical database is an organized information collection whose identity and scope require examination of its records and schema rather than visual appearance."},"score":1.0}}