Release Notes and Deprecations¶
Versions History¶
Release — 2024/11¶
- New field:
patents.npc_references
(array).Description: Non-patent citation references determined from the patent document. - Removed field:
patents.categories.bra_v1
. - Removed field:
patents.categories.for_v1
. - Removed field:
patents.categories.for_v2020
. - Removed field:
patents.categories.hrcs_hc_v1
. - Removed field:
patents.categories.hrcs_rac_v1
. - Removed field:
patents.categories.icrp_cso_v1
. - Removed field:
patents.categories.icrp_ct_v1
. - Removed field:
patents.categories.sdg_v1
. - Removed field:
patents.categories.uoa_v1
.
Release — 2024/07¶
- New field:
clinical_trials.results_first_available_date
(string).Description: The date on which summary results information was first available. - New field:
clinical_trials.secondary_id_details
(array).Description: Details about additional identifier, other than the organization’s Unique Protocol Identification Number that is assigned to the clinical study. - New field:
clinical_trials.study_exclusion_criteria
(string).Description: Eligibility criteria for a person to not participate in clinical study. - New field:
clinical_trials.study_inclusion_criteria
(string).Description: Eligibility criteria for a person to participate in clinical study. - Removed field:
clinical_trials.categories.bra_v1
. - Removed field:
clinical_trials.categories.for_v1
. - Removed field:
clinical_trials.categories.for_v2020
. - Removed field:
clinical_trials.categories.hrcs_hc_v1
. - Removed field:
clinical_trials.categories.hrcs_rac_v1
. - Removed field:
clinical_trials.categories.icrp_cso_v1
. - Removed field:
clinical_trials.categories.icrp_ct_v1
. - Removed field:
clinical_trials.categories.sdg_v1
. - Removed field:
clinical_trials.categories.uoa_v1
.
Release — 2023/12¶
- New field:
datasets.categories.rcdc_v2023
(structure).Description: Versioned category Research, Condition, and Disease Categorization (model version 2023). - Removed field:
datasets.categories.rcdc_v2020
.
Release — 2023/11¶
- New field:
patents.application_reference_id
(string).Description: The identifier of the referenced patent application. - New field:
patents.document_category
(string).Description: Present for US only. Categories are derived from kind codes and include: Defensive, Design, Plant, Reissue, Statutory, Utility. - New field:
patents.inventors
(array).Description: List of details of the people who invented the patent. - New field:
patents.categories.rcdc_v2023
(structure).Description: Versioned category Research, Condition, and Disease Categorization (model version 2023). - Modification: auxiliary structure
Assignee
extended with new fields.Description: Original and current assignee structures extended to include:city
,country_code
,state
andstreet
(where available). - Removed field:
patents.categories.rcdc_v2020
. - New field:
publications.pubmed.keywords
(array).Description: Keywords for the PubMed publication, if present. - New field:
publications.source
(structure).Description: The source title this publication belongs to, this may be a journal, a book series or a preprint platform.
Release — 2023/10¶
- New field:
publications.categories.rcdc_v2023
(structure).Description: Versioned category Research, Condition, and Disease Categorization (model version 2023). - New field:
publications.categories.uoa_v2023
(structure).Description: Versioned category Units of Assessment (model version 2023). - New field:
publications.pubmed
(structure).Description: PubMed related details of a publication (MeSH terms, publication types etc.).Note: this new structure includesmesh
andpublication_types
. - New field:
publications.pubmed.publication_types
(array).Description: PubMed publication types, if known. - New field:
publications.pubmed.mesh.ui
(array).Description: The MeSH unique identifiers, if known, including unique identifiers of subheadings. - Deprecated field:
publications.mesh_terms
(please usepublications.pubmed.mesh.terms
). - Deprecated field:
publications.mesh_headings
(please usepublications.pubmed.mesh.headings
). - Removed field:
publications.categories.rcdc_v2020
. - Removed field:
publications.categories.for_v2020
. - Removed field:
publications.document_type.versions
. - Process change: the field
publications.journal
is now populated with details from the associated source title regardless of the publication’s output type.
Release — 2023/09¶
- Removed field:
reports.categories.rcdc_v2020
. - New field:
reports.categories.rcdc_v2023
(structure).Description: Versioned category Research, Condition, and Disease Categorization (model version 2023). - New field:
reports.concepts
(array).Description: Concepts describing the main topics of the report (note: automatically derived from the text using machine learning).
Release — 2023/08¶
- New field:
policy_documents.categories.sdg_v2021
(structure).Description: Versioned category SDG - Sustainable Development Goals (model version 2021).
Release — 2023/07¶
- New field:
grants.activity_code
(string).Description: The NIH activity code for the grant, as provided by the source. - New field:
policy_documents.categories.rcdc_v2023
(structure).Description: Versioned category Research, Condition, and Disease Categorization (model version 2023). - Removed field:
policy_documents.categories.rcdc_v2020
. - Deprecated field:
clinical_trials.category_uoa
. - Deprecated field:
clinical_trials.categories.uoa_v1
. - Deprecated field:
datasets.category_uoa
. - Deprecated field:
datasets.categories.uoa_v1
. - Deprecated field:
patents.category_uoa
. - Deprecated field:
patents.categories.uoa_v1
. - Deprecated field:
policy_documents.category_uoa
. - Deprecated field:
policy_documents.categories.uoa_v1
.
Release — 2023/06¶
- New field:
patents.figures_amount
(integer).Description: The number of figures provided with a patent. - New field:
clinical_trials.primary_completion_date
(string).Description: Primary completion date provided by trial, year-month or just year. - New field:
clinical_trials.primary_completion_year
(integer).Description: Primary completion year provided by trial. - New field:
clinical_trials.categories.rcdc_v2023
(structure).Description: Versioned category Research, Condition, and Disease Categorization (model version 2023). - Deprecated field:
clinical_trials.categories.rcdc_v2020
.
Release — 2023/05¶
- New field:
patents.claims_amount
(integer).Description: The number of claims associated with a patent.
Release — 2023/04¶
- New field:
grants.project_numbers
(array).Description: Grant identifiers, as provided by the source (e.g., funder, aggregator) the grant was derived from. - Deprecated field:
grants.grant_number
with replacement fieldgrants.project_numbers
. - Removed field:
grants.categories.rcdc_v2020
.
Release — 2023/03¶
- New source:
org_groups
Description: The organisation groups data source is a curated set of research and funder groups (such as NSF - National Science Foundation, US Federal Funders).
Release — 2023/01¶
- New field:
clinical_trials.secondary_ids
(array).Description: Identifiers, other than parent registry identification number, assigned to the study such as grant, contract numbers or an identification number assigned by another registry. - New field:
clinical_trials.organisation_details.type
(string).Description: The type of organisation associated with the clinical trial (sponsor
,collaborator
,facility
oraffiliated
). - Modified field:
patents.orange_book
(array).Note: The structure of this field has changed to better reflect the layout of the source data.
Release — 2022/10¶
- New field:
datasets.categories.sdg_v2021
(structure).Description: Versioned category SDG - Sustainable Development Goals (model version 2021). - New field:
datasets.concepts
(array).Description: Concepts describing the main topics of a data set (note: automatically derived from the dataset text using machine learning). - New field:
grants.categories.sdg_v2021
(structure).Description: Versioned category SDG - Sustainable Development Goals (model version 2021). - New field:
patents.concepts
(array).Description: Concepts describing the main topics of a patent (note: automatically derived from the patent text using machine learning). - New field:
patents.orange_book
(structure).Description: Data added from the FDA Orange Book Data Files. - New field:
publications.categories.sdg_v2021
(structure).Description: Versioned category SDG - Sustainable Development Goals (model version 2021). - New field:
reports.categories.sdg_v2021
(structure).Description: Versioned category SDG - Sustainable Development Goals (model version 2021). - New field:
*.categories.for_2020_v2022
(structure).Description: Versioned category ANZSRC Field of Research 2020 (model version 2022).
Note
The versioned category fields –
categories.bra_v1
,categories.for_v1
,categories.for_v2020
,categories.hrcs_hc_v1
,categories.hrcs_rac_v1
,categories.icrp_cso_v1
,categories.icrp_ct_v1
andcategories.sdg_v1
have been deprecated in this release for all primary data source types – clinical trials, datasets, grants, patents, policy documents, publications and reports . The replacement versioned categories arecategories.bra_v2020
,categories.for_2020_v2022
,categories.hrcs_hc_v2020
,categories.hrcs_rac_v2020
,categories.icrp_cso_v2020
,categories.icrp_ct_v2020
andcategories.sdg_v2021
. Please see the documentation for the individual source type for details. These fields still remain in the data schema, but it we recommend changing any existing usage of these fields to instead use the provided replacement field.Usage of the top-level category fields such as
category_for
orcategory_uoa
is recommended unless a specific versioned category model is required.
Release — 2022/08¶
- New field:
clinical_trials.study_type
(string).Description: The type of study associated to the clinical trial e.g. ‘Interventional’, ‘Observational’, etc. - New field:
clinical_trials.study_arms
(array).Description: The groups or subgroups of participants that receives specific a set of interventions/treatments, or no intervention, according to the trial’s protocol. - New field:
clinical_trials.study_designs
(array).Description: Details regarding the design of a clinical trial. - New field:
clinical_trials.study_outcome_measures
(array).Description: List of measures of outcome associated to the clinical trial. - New field:
clinical_trials.study_participants
(integer).Description: The actual or estimated target number of participants. - New field:
clinical_trials.study_eligibility_criteria
(string).Description: Criteria for participation in the trial. - New field:
clinical_trials.study_minimum_age
(string).Description: Minimum age eligible for the study. - New field:
clinical_trials.study_maximum_age
(string).Description: Maximum age eligible for the study. - New field:
publications.copyright_statement
(string).Description: The copyright status as found in the source document. - New field:
publications.document_type
(structure).Description: The automated document type classification. - New field:
publications.funding_section
(structure).Description: The funding section text as found in the source document. - New field:
publications.repository_dois
(array).Description: Identified DOIs based on DOI prefixes from Figshare and DataCite. - New field:
*.categories.bra_v2020
(structure).Description: Versioned category BRA (model version 2020). - New field:
*.categories.for_v2020
(structure).Description: Versioned category ANZSRC Field of Research 2008 (model version 2020). - New field:
*.categories.hrcs_hc_v2020
(structure).Description: Versioned category Health Research Classification System (HRCS) – Health Categories (model version 2020). - New field:
*.categories.hrcs_rac_v2020
(structure).Description: Versioned category Health Research Classification System (HRCS) – Research Activity Codes (model version 2020). - New field:
*.categories.icrp_cso_v2020
(structure).Description: Versioned category International Cancer Research Partnership – Common Scientific Outline (CSO) (model version 2020). - New field:
*.categories.icrp_ct_v2020
(structure).Description: Versioned category International Cancer Research Partnership – Cancer Types (CT) (model version 2020). - New field:
*.categories.rcdc_v2020
(structure).Description: Versioned category Research, Condition, and Disease Categorization (RCDC) System (model version 2020).
Note
The
v2020
categories detailed above (items 13 through 19) are for all primary data source types – clinical trials, datasets, grants, patents, policy documents, publications and reports. Top level categories such ascategory_for
, will contain the current model version matching the version used within the DSL API and Dimensions web application.
Release — 2022/03¶
- New source:
source_titles
Description: The Source Titles table is a curated database of publications ‘containers’, for example journals, preprint servers, book series and others. - New field:
publications.source_id
(string).Description: The source title for the publication. - New field:
publications.authors.orcid
(array).Description: ORCiD identifiers identified for the author. - New field:
grants.funding_cny
(float).Description: Funding amount awarded in CNY.
Release — 2021/07¶
- New source:
policy_documents
Description: The policy document data includes sources that are designed to change or otherwise influence guidelines, policy or practice. Tracked policy sources and document types range from government guidelines, reports or white papers; independent policy institute publications; advisory committees on specific topics; research institutes; and international development organisations. - New field:
clinical_trials.concepts
(array).Description: Concepts describing the main topics of a clinical trial (note: automatically derived from the publication text using machine learning). - New field:
clinical_trials.date_inserted
(timestamp).Description: Date when the record was inserted into Dimensions. - New field:
clinical_trials.interventions
(array).Description: Information about the clinical trial’s interventions according to the research plan or protocol created by the investigators. - New field:
clinical_trials.mesh_terms
(array).Description: Medical Subject Heading terms as used in PubMed. - New field
grants.concepts
(array).Description: Concepts describing the main topics of a grant (note: automatically derived from the grant text using machine learning). - New field:
grants.funder_org_acronyms
(array).Description: List of acronyms for the funding organisation. - New field
grants.language
(string).Description: Grant original language, as ISO 639-1 language codes. - New field
grants.original_abstract
(structure).Description: Abstract of the grant in its original language. - New field:
grants.original_title
(structure).Description: Title of the grant in its original language.
Release — 2021/06¶
- New field
publications.arxiv_id
(string).Description: The publications arXiv identifier (e.g. ‘arXiv:2102.02477’). - New field
publications.parent_id
(string).Description: For supported publication type, the Dimensions publication identifier of a record considered to be the parent item of this publication (ie. parent book of a book chapter). - New field:
datasets.license.name
(string).Description: The dataset licence name, e.g. ‘CC BY 4.0’. - New field:
datasets.license.url
(string).Description: The dataset licence URL, e.g. ‘https://creativecommons.org/licenses/by/4.0/’.
Release — 2021/05¶
- New field:
grants.funder_org_cities
(array).Description: List of cities linked to the organisation funding the grant, expressed as GeoNames codes. - New field:
grants.funder_org_countries
(array).Description: List of countries linked to the organisation funding the grant, expressed as GeoNames codes. - New field:
grants.funder_org_state_codes
(array).Description: List of state codes linked to the organisation funding the grant, expressed as GeoName codes (ISO-3166-2). - New field:
grants.research_org_cities
(array).Description: List of cities of the research organisations receiving the grant, expressed as GeoNames identifiers - New field:
grants.research_org_countries
(array).Description: List of countries of the research organisations receiving the grant, expressed as GeoName codes. - New field:
grants.research_org_state_codes
(array).Description: List of state codes of the organisations receiving the grant, expressed as GeoName codes (ISO-3166-2). - New field:
datasets.repository_name
(string).Description: The name of the repository of the dataset.
Release — 2021/04¶
- New source:
reports
Description: A technical report is a document that describes the process, progress, or results of technical or scientific research or the state of a technical or scientific research problem. It might also include recommendations and conclusions of the research. - New field:
patents.assignee_countries
(array).Description: List of countries of the assignees of the patent, expressed as GeoNames codes (note: this is the combination of thecurrent_assignee_countries
andoriginal_assignee_countries
fields). - New field:
patents.current_assignee_countries
(array).Description: List of countries of the assignees who currently own the rights of the patent, expressed as GeoNames codes (note: this value is extracted independently from GRID). - New field:
patents.original_assignee_countries
(array).Description: List of countries of the assignees who have owned the rights of the patent, expressed as GeoNames codes (note: this value is extracted independently from GRID). - New field:
patents.current_assignee.country
.Description: Country of the assignee (note: this value can be extracted independently from GRID). - New field:
patents.original_assignee.country
.Description: Country of the assignee (note: this value can be extracted independently from GRID).
Release — 2021/03¶
- New field:
publications.open_access_categories_v2
.Description: Implementing recategorization of Open Access across Dimensions services. This is to align more closely with Unpaywall. Details here.Note: the old fieldpublications.open_access_categories
is being deprecated and should no longer be used.Details of deprecated publication fields can be found here. - Deprecated field:
publications.open_access_categories
- New field
publications.subtitles
(array).Description: Publication subtitle, when available. - New field
publications.date_online
Description: The publication online date. - New field
publications.date_print
Description: The publication print date. - New field
publications.date_normal
(date)Description: The publication date for the version of record of a document, normalised for partial dates which do not include a month/day value (ie. ‘2020’ converts to ‘2020-01-01’). Feature: Documentation – schema descriptions can now be found within the BigQuery Web UI (see publications as an example), as well as in our documentation.
Release — 2020/09¶
Initial release
Deprecations History¶
Release — 2023/04¶
- Deprecated field:
grants.grant_number
with replacement fieldgrants.project_numbers
.
Release — 2022/11¶
- Deprecated field:
policy_documents.category_sdg
with no replacement. - Deprecated field:
policy_documents.categories.sdg_v1
with no replacement.
Release — 2022/10¶
- Deprecated field:
*.categories.bra_v1
with replacement field*.categories.bra_v2020
. - Deprecated field:
*.categories.for_v1
with replacement field*.categories.for_2020_v2022
. - Deprecated field:
*.categories.for_v2020
with replacement field*.categories.for_2020_v2022
. - Deprecated field:
*.categories.hrcs_hc_v1
with replacement field*.categories.hrcs_hc_v2020
. - Deprecated field:
*.categories.hrcs_rac_v1
with replacement field*.categories.hrcs_rac_v2020
. - Deprecated field:
*.categories.icrp_cso_v1
with replacement field*.categories.icrp_cso_v2020
. - Deprecated field:
*.categories.icrp_ct_v1
with replacement field*.categories.icrp_ct_v2020
. - Deprecated field:
*.categories.sdg_v1
with replacement field*.categories.sdg_v2021
. - Deprecated field:
patents.category_sdg
with no replacement. - Deprecated field:
patents.categories.sdg_v1
with no replacement.
Release — 2021/03¶
- Deprecated field:
publications.open_access_categories
with replacement of fieldpublications.open_access_categories_v2
.