Reports

This page contains information about the Reports data source in the Dimensions BigQuery project.

See also

Dimensions DSL API Documentation for this type is also available from here.

Reports Schema

Field

Type

Description

Example

abstract

Literal: String

Abstract of a report.

      "In order to validate distributed energy resource (DER) models operated with grid services in the GMLC 1.4.2 team\u2019s February (GMLC 2019a) and July (GMLC 2019b) reports, a test and measurement program using actual DER devices was conducted by national laboratories for three devices: (1) electric vehicles (EVs), (2) water heaters, and (3) commercial refrigeration. Test procedures were developed and carried out to identify the mathematical models and their parameters that describe the operational function, characterize the physics, and obey transient response of the devices. This report focuses on the experimental results obtained to develop and verify simulations of three specific EV models. This section summarizes elements of the mathematical model and shows the necessity data collected from the EVs while charging and discharging (driving). In the course of the study, we found it necessary to make some modifications to the model to deal with observed transient behavior. Section 1.2 details the model assumptions and equations, Section 1.3 provides details of the EVs tested, Section 1.4 outlines the test procedures developed for the projects, and Section 1.5 presents the experimental results obtained for the three different EVs tested and how these results compare to the models running the same test profiles.For further information about the model, how it is used in simulating larger subfleets, and how the generic \u201cbattery-equivalent model\u201d is used to generically describe a number of different DER types, see \u201cGrid Services from DER Device Fleets: Volume 1 \u2013 Battery Equivalent Models of Device and Fleets\u201d report (GMLC 2019a)."
  

authors

Array of < Entity: Author >

Ordered list of authors names and their affiliations, as they appear in the source.

      [{"first_name": "Charles", "last_name": "Booten", "researcher_id": null, "affiliations": []}, {"first_name": "Bethany", "last_name": "Sparn", "researcher_id": null, "affiliations": []}, {"first_name": "Jeffrey", "last_name": "Maguire", "researcher_id": null, "affiliations": []}, {"first_name": "Sivasathya  Pradha", "last_name": "Balamurugan", "researcher_id": null, "affiliations": []}, {"first_name": "Michael", "last_name": "Duoba", "researcher_id": null, "affiliations": []}, {"first_name": "Alejandro  Fernandez", "last_name": "Canosa", "researcher_id": null, "affiliations": []}, {"first_name": "Jeffrey", "last_name": "Munk", "researcher_id": null, "affiliations": []}, {"first_name": "Teja", "last_name": "Kuruganti", "researcher_id": null, "affiliations": []}, {"first_name": "Jian", "last_name": "Sun", "researcher_id": null, "affiliations": []}, {"first_name": "Borui", "last_name": "Cui", "researcher_id": null, "affiliations": []}, {"first_name": "Jin", "last_name": "Dong", "researcher_id": null, "affiliations": []}]
  

categories

Entity: VersionedCategories

Versioned categorisations.

      {"bra_v1": {"values": ["Basic Science"], "full": [{"id": "4000", "value": "Basic Science"}]}, "for_v1": {"first_level": {"codes": ["01"], "full": [{"id": "2201", "code": "01", "name": "Mathematical Sciences"}]}, "second_level": {"codes": ["0102"], "full": [{"id": "2344", "code": "0102", "name": "Applied Mathematics"}]}}, "hra_v1": {"values": ["Population & Society"], "full": [{"id": "3903", "value": "Population & Society"}]}, "hrcs_hc_v1": {"values": ["Reproductive health and childbirth"], "full": [{"id": "908", "value": "Reproductive health and childbirth"}]}, "hrcs_rac_v1": {"codes": ["4.1"], "full": [{"id": "10401", "code": "4.1", "name": "Discovery and preclinical testing of markers and technologies"}]}, "icrp_cso_v1": {"codes": ["5.3"], "full": [{"id": "3767", "code": "5.3", "name": "Systemic Therapies - Discovery and Development"}]}, "icrp_ct_v1": {"values": ["Not Site-Specific Cancer"], "full": [{"id": "3816", "value": "Not Site-Specific Cancer"}]}, "rcdc_v1": {"values": ["Bioengineering"], "full": [{"id": "337", "value": "Bioengineering"}]}, "sdg_v1": {"codes": ["7"], "full": [{"id": "40007", "code": "7", "name": "Affordable and Clean Energy"}]}, "uoa_v1": {"codes": ["B12"], "full": [{"id": "30012", "code": "B12", "name": "Engineering"}]}}
  

category_bra

Entity: SimpleCategorization

Broad Research Areas

      {"values": ["Basic Science"], "full": [{"id": "4000", "value": "Basic Science"}]}
  

category_for

Entity: ComplexSystematicCategorization

ANZSRC Fields of Research classification

      {"first_level": {"codes": ["01"], "full": [{"id": "2201", "code": "01", "name": "Mathematical Sciences"}]}, "second_level": {"codes": ["0102"], "full": [{"id": "2344", "code": "0102", "name": "Applied Mathematics"}]}}
  

category_hra

Entity: SimpleCategorization

Health Research Areas

      {"values": ["Population & Society"], "full": [{"id": "3903", "value": "Population & Society"}]}
  

category_hrcs_hc

Entity: SimpleCategorization

HRCS - Health Categories

      {"values": ["Reproductive health and childbirth"], "full": [{"id": "908", "value": "Reproductive health and childbirth"}]}
  

category_hrcs_rac

Entity: SystematicCategorization

HRCS – Research Activity Codes

      {"codes": ["4.1"], "full": [{"id": "10401", "code": "4.1", "name": "Discovery and preclinical testing of markers and technologies"}]}
  

category_icrp_cso

Entity: SystematicCategorization

ICRP Common Scientific Outline

      {"codes": ["5.3"], "full": [{"id": "3767", "code": "5.3", "name": "Systemic Therapies - Discovery and Development"}]}
  

category_icrp_ct

Entity: SimpleCategorization

ICRP Cancer Types

      {"values": ["Not Site-Specific Cancer"], "full": [{"id": "3816", "value": "Not Site-Specific Cancer"}]}
  

category_rcdc

Entity: SimpleCategorization

Research, Condition, and Disease Categorization

      {"values": ["Bioengineering"], "full": [{"id": "337", "value": "Bioengineering"}]}
  

category_sdg

Entity: SystematicCategorization

SDG - Sustainable Development Goals

      {"codes": ["7"], "full": [{"id": "40007", "code": "7", "name": "Affordable and Clean Energy"}]}
  

category_uoa

Entity: SystematicCategorization

Units of Assessment

      {"codes": ["B12"], "full": [{"id": "30012", "code": "B12", "name": "Engineering"}]}
  

concepts

Array of < Entity: Concept >

Concepts describing the main topics of the report (note: automatically derived from the text using machine learning).

      [{"concept": "development", "relevance": "0.26628911664654276"}, {"concept": "evaluation", "relevance": "0.2710876034740734"}, {"concept": "Energy Resource Device Models", "relevance": "0.0"}, {"concept": "Resource Device Models", "relevance": "0.0"}, {"concept": "device model", "relevance": "0.570640064136187"}, {"concept": "model", "relevance": "0.4109706663195108"}, {"concept": "electric vehicles", "relevance": "0.7547907403471568"}, {"concept": "vehicle", "relevance": "0.4868329113845936"}, {"concept": "electric water heaters", "relevance": "0.6536623840057999"}, {"concept": "water heater", "relevance": "0.7049286217687073"}, {"concept": "heater", "relevance": "0.5470482617684402"}, {"concept": "commercial refrigeration systems", "relevance": "0.6574239718842675"}, {"concept": "refrigeration system", "relevance": "0.6042454551691115"}, {"concept": "system", "relevance": "0.33518897500477013"}, {"concept": "order", "relevance": "0.333841322957182"}, {"concept": "energy resource (DER) models", "relevance": "0.0"}, {"concept": "resource model", "relevance": "0.3362276215501966"}, {"concept": "grid services", "relevance": "0.47164710897504664"}, {"concept": "services", "relevance": "0.18592443436106368"}, {"concept": "GMLC 1.4.2 team\u2019s February", "relevance": "0.0"}, {"concept": "team\u2019s February", "relevance": "0.0"}, {"concept": "Februaries", "relevance": "6.313762016171845E-5"}, {"concept": "July (GMLC 2019b) reports", "relevance": "0.0"}, {"concept": "report", "relevance": "0.15371876541523533"}, {"concept": "test", "relevance": "0.3369896686626745"}, {"concept": "measurement program", "relevance": "0.4823469994682483"}, {"concept": "program", "relevance": "0.19124689892824"}, {"concept": "actual DER devices", "relevance": "0.0"}, {"concept": "DER devices", "relevance": "0.5555464780611556"}, {"concept": "devices", "relevance": "0.5232875798379661"}, {"concept": "National Laboratory", "relevance": "0.5120073869677738"}, {"concept": "laboratory", "relevance": "0.29972888123657015"}, {"concept": "commercial refrigeration", "relevance": "0.5927237807862005"}, {"concept": "refrigeration", "relevance": "0.4338158013802282"}, {"concept": "test procedure", "relevance": "0.5694676889799669"}, {"concept": "procedure", "relevance": "0.3223883253141705"}, {"concept": "mathematical model", "relevance": "0.6190503114926685"}, {"concept": "parameters", "relevance": "0.3647301335812178"}, {"concept": "operational functions", "relevance": "0.4941431721206317"}, {"concept": "function", "relevance": "0.23382287321614015"}, {"concept": "physics", "relevance": "0.32186302017100255"}, {"concept": "transient response", "relevance": "0.5504116307249057"}, {"concept": "response", "relevance": "0.23031470166956564"}, {"concept": "experimental results", "relevance": "0.585539241584029"}, {"concept": "results", "relevance": "0.374220378564753"}, {"concept": "simulations", "relevance": "0.41111909405618774"}, {"concept": "specific EV models", "relevance": "0.0"}, {"concept": "EV model", "relevance": "0.5525458520849019"}, {"concept": "sections", "relevance": "0.29625605609389444"}, {"concept": "elements", "relevance": "0.32692761480329124"}, {"concept": "necessity data", "relevance": "0.0"}, {"concept": "data", "relevance": "0.24560326977684285"}, {"concept": "discharging", "relevance": "0.4501254711401416"}, {"concept": "course", "relevance": "0.12167929532101111"}, {"concept": "study", "relevance": "0.2370577657728906"}, {"concept": "modification", "relevance": "0.3122768200927192"}, {"concept": "observed transient behavior", "relevance": "0.6054403242481229"}, {"concept": "transient behavior", "relevance": "0.5656272264501966"}, {"concept": "behavior", "relevance": "0.3600895472094239"}, {"concept": "Section 1.2 details", "relevance": "0.0"}, {"concept": "detail", "relevance": "0.38412120953743895"}, {"concept": "model assumptions", "relevance": "0.38928566450851326"}, {"concept": "assumption", "relevance": "0.27950397706239277"}, {"concept": "equations", "relevance": "0.3733652447694147"}, {"concept": "Section 1.3", "relevance": "0.26158335735450816"}, {"concept": "Section 1.4", "relevance": "0.2015596350468468"}, {"concept": "project", "relevance": "0.2829426937536693"}, {"concept": "Section 1.5", "relevance": "0.14524086230287098"}, {"concept": "different electric vehicles", "relevance": "0.6590786233451151"}, {"concept": "same test profiles", "relevance": "0.0"}, {"concept": "test profiles", "relevance": "0.41705753856571415"}, {"concept": "profile", "relevance": "0.30373608208265473"}, {"concept": "further information", "relevance": "0.24061669420052023"}, {"concept": "information", "relevance": "0.2289315169946224"}, {"concept": "larger subfleets", "relevance": "0.0"}, {"concept": "subfleet", "relevance": "0.12083971719158676"}, {"concept": "battery-equivalent model", "relevance": "0.0"}, {"concept": "number", "relevance": "0.24208117828186693"}, {"concept": "different DER types", "relevance": "0.0"}, {"concept": "DER types", "relevance": "0.5861858315259131"}, {"concept": "types", "relevance": "0.2763371135572357"}, {"concept": "DER Device Fleets", "relevance": "0.0"}, {"concept": "Device Fleets", "relevance": "0.0"}, {"concept": "fleet", "relevance": "0.46298417503242534"}, {"concept": "volume", "relevance": "0.3145713604839298"}, {"concept": "equivalent model", "relevance": "0.5376481620490179"}]
  

date

Literal: String

Date of publication for report.

      "2020-07-28"
  

date_imported_gbq

Literal: Timestamp

Timestamp when the report was last imported into BigQuery. Incremental changes can be determined using this field. Note, however at certain times all records may be reimported.

      "2021-03-25 23:43:27 UTC"
  

date_inserted

Literal: Timestamp

Date when the record was inserted into Dimensions.

      "2021-02-20 17:02:28 UTC"
  

date_normal

Literal: Date

The report 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’).

      "2020-07-28"
  

doi

Literal: String

Digital object identifier.

      "10.2172/1660063"
  

external_ids

Array of < Entity: DocumentNumber >

External identifiers available from the report publisher (e.g. OSTI ID).

      [{"name": "Report Number", "value": "NREL/TP-5500-75323"}, {"name": "DOE Contract Number", "value": "DE-AC36-08GO28308"}, {"name": "DOI", "value": "10.2172/1660063"}, {"name": "osti_id", "value": "1660063"}]
  

funder_details

Array of < Entity: Organization >

Sponsors/funders of the research/report, as they appear in the source.

      [{"raw_name": "USDOE Grid Modernization Laboratory Consortium", "grid_ids": [], "cities": [], "countries_territories": [], "states": []}]
  

funder_org_countries

Array of < Literal: String >

Countries of the organizations funding the report.

      []
  

funder_orgs

Array of < Literal: String >

GRID organizations funding the report (only disambiguated).

      []
  

id

Literal: String

Dimensions report ID.

      "report.4908458"
  

keywords

Array of < Literal: String >

Keywords, as provided by the source.

      ["70 DOE/EERE Other", "buildings", "GMLC", "grid", "grid services", "distributed energy resource"]
  

linkout

Literal: String

Original URL for the report.

      "https://www.osti.gov/biblio/1660063"
  

publisher_details

Array of < Entity: Organization >

Organizations publishing the report, as they appear in the source.

      [{"raw_name": "Office of Scientific and Technical Information", "grid_ids": ["grid.483387.3"], "cities": [4646571], "countries_territories": ["US"], "states": ["US-TN"]}]
  

publisher_org_countries

Array of < Literal: String >

Countries of the organizations publishing the report.

      ["US"]
  

publisher_orgs

Array of < Literal: String >

GRID organizations publishing the report (only disambiguated).

      ["grid.483387.3"]
  

research_org_cities

Array of < Literal: Integer >

Cities of the organisations associated with the report, expressed as GeoNames ID and name.

      [5423294]
  

research_org_countries

Array of < Literal: String >

Countries of the organisations associated with the report, expressed as GeoNames code and name.

      ["US"]
  

research_org_state_codes

Array of < Literal: String >

States of the organisations associated with the report, expressed as GeoNames codes (ISO‌-3166-2).

      ["US-CO"]
  

research_orgs

Array of < Literal: String >

Combined list of GRID organisations associated with the report, because the source marks them as responsible for it, or because they appear as authors affiliations.

      ["grid.419357.d"]
  

responsible_org_cities

Array of < Literal: Integer >

Cities of the organisations responsible for the report, expressed as GeoNames ID

      [5423294]
  

responsible_org_countries

Array of < Literal: String >

Countries of the organisations responsible for the report, expressed as ISO-3166 alpha-2 codes.

      ["US"]
  

responsible_org_details

Array of < Entity: Organization >

Organizations responsible for the report, as they appear in the source.

      [{"raw_name": "National Renewable Energy Lab. (NREL), Golden, CO (United States)", "grid_ids": ["grid.419357.d"], "cities": [5423294], "countries_territories": ["US"], "states": ["US-CO"]}]
  

responsible_org_state_codes

Array of < Literal: String >

States of the organisations responsbile for the report, expressed as GeoNames codes (ISO‌-3166-2).

      ["US-CO"]
  

responsible_orgs

Array of < Literal: String >

GRID organizations responsible for the report.

      ["grid.419357.d"]
  

title

Literal: String

Title of a report.

      "Development and Evaluation of Distributed Energy Resource Device Models: Electric Vehicles, Electric Water Heaters, and Commercial Refrigeration Systems"
  

year

Literal: Integer

Year of publication for report.

      2020
  

Auxiliary Entities

Affiliation

Field

Type

Description

affiliation

Literal: String

The raw affiliation string as seen on the source type.

cities

Array of < Literal: Integer >

The cities identified in the affiliation, as geoname IDs.

countries_territories

Array of < Literal: String >

The country/territories identified in the affiliation, as ISO-3166 alpha-2 codes.

grid_ids

Array of < Literal: String >

The assigned GRID IDs based on this affiliation.

states

Array of < Literal: String >

The states/regions identified in the affiliation, as ISO 3166-2 codes.

Author

Field

Type

Description

affiliations

Array of < Entity: Affiliation >

Affiliation details associated with the report author.

first_name

Literal: String

last_name

Literal: String

researcher_id

Literal: String

The Dimensions assigned researcher ID.

ComplexSystematicCategorization

Field

Type

Description

first_level

Entity: SystematicCategoryLevel

First level of categorisation within the classification scheme.

second_level

Entity: SystematicCategoryLevel

Second level of categorisation within the classification scheme.

Concept

Field

Type

Description

concept

Literal: String

Normalized noun phrase describing a main topic within the document. Automatically derived using machine learning techniques.

relevance

Literal: Float

Relevance ranking of the normalized noun phrase within the document’s field of study.

DocumentNumber

Field

Type

Description

name

Literal: String

The name of a document number - for reports.

value

Literal: String

The value of the document number

Organization

Field

Type

Description

cities

Array of < Literal: Integer >

The cities identified in the raw organisation name, as geoname IDs.

countries_territories

Array of < Literal: String >

The country/territories identified in the raw organisation name, as ISO-3166 alpha-2 codes.

grid_ids

Array of < Literal: String >

The assigned GRID IDs based on the raw organisation name.

raw_name

Literal: String

The organisation name as collected from the source.

states

Array of < Literal: String >

The states/regions identified in the raw organisation name, as ISO 3166-2 codes.

SimpleCategorization

Field

Type

Description

full

Array of < Entity: SimpleCategory >

A complete listing of category values, assigned to this particular record, including the unique Dimensions identifiers associated with each catergory value.

values

Array of < Literal: String >

Listing of all catergory values assigned to this particular record.

SimpleCategory

Field

Type

Description

id

Literal: String

Dimensions specific identifier assigned to the category value.

value

Literal: String

Category value associated with the simple classification scheme.

SystematicCategorization

Field

Type

Description

codes

Array of < Literal: String >

Listing of all catergory specific codes assigned to this particular record.

full

Array of < Entity: SystematicCategory >

A complete listing of category values, assigned to this particular record, including the unique Dimensions identifiers associated with each catergory value.

SystematicCategory

Field

Type

Description

code

Literal: String

Numeric or non-numeric category value code. Value is classification scheme specific.

id

Literal: String

Dimensions specific identifier assigned to the category value.

name

Literal: String

Individual category value description, excluding the classification scheme specific code prefix.

SystematicCategoryLevel

Field

Type

Description

codes

Array of < Literal: String >

A consolidated list of all category-specific codes at a particular classification level, assigned to this record.

full

Array of < Entity: SystematicCategory >

A listing of category values at a specific classification level, assigned to this particular record, including the unique Dimensions identifiers associated with each category value.

VersionedCategories

Field

Type

Description

bra_v2020

Entity: SimpleCategorization

for_2020_v2022

Entity: ComplexSystematicCategorization

hra_v1

Entity: SimpleCategorization

hrcs_hc_v2020

Entity: SimpleCategorization

hrcs_rac_v2020

Entity: SystematicCategorization

icrp_cso_v2020

Entity: SystematicCategorization

icrp_ct_v2020

Entity: SimpleCategorization

rcdc_v2023

Entity: SimpleCategorization

sdg_v2021

Entity: SystematicCategorization

uoa_v1

Entity: SystematicCategorization

uoa_v2023

Entity: SystematicCategorization

deprecated bra_v1

Entity: SimpleCategorization

Deprecated in favor of: bra_v2020

deprecated for_v1

Entity: ComplexSystematicCategorization

Deprecated in favor of: for_2020_v2022

deprecated for_v2020

Entity: ComplexSystematicCategorization

Deprecated in favor of: for_2020_v2022

deprecated hrcs_hc_v1

Entity: SimpleCategorization

Deprecated in favor of: hrcs_hc_v2020

deprecated hrcs_rac_v1

Entity: SystematicCategorization

Deprecated in favor of: hrcs_rac_v2020

deprecated icrp_cso_v1

Entity: SystematicCategorization

Deprecated in favor of: icrp_cso_v2020

deprecated icrp_ct_v1

Entity: SimpleCategorization

Deprecated in favor of: icrp_ct_v2020

deprecated rcdc_v1

Entity: SimpleCategorization

Deprecated in favor of: category_rcdc

deprecated sdg_v1

Entity: SystematicCategorization

Deprecated in favor of: sdg_v2021