Skip to content

Latest commit

 

History

History
126 lines (81 loc) · 7.99 KB

glossary.md

File metadata and controls

126 lines (81 loc) · 7.99 KB
layout title nav_order published
default
Glossary
11
true

Glossary of Common Terms

{: .no_toc} This page contains a selection of key terms important to understanding the structure of data within Data Commons.

Term List

{: .no_toc}

  • TOC {:toc}

{: #cohort}

A group of entities sharing some characteristic. Interchangeably referred to in a Data Commons context as Cohort and CohortSet. Examples include the CDC's list of the United States' 500 largest cities.

info Note: The type [`Cohort`](https://datacommons.org/browser/Cohort) is a legacy type not used by the Sheets method `DCCOHORTMEMBERS()`.

{: #date}

The date of measurement. Specified in ISO 8601 format. Examples include 2011 (the year 2011), 2019-06 (the month of June in the year 2019), and 2019-06-05T17:21:00-06:00 (5:17PM on June 5, 2019, in CST).

DCID

{: #dcid}

Short for 'Data Commons Identifier', a DCID is a distinct identifier for a node in the knowledge graph. These can represent variables or entities. For example, Austin, Texas, has a DCID of geoId/4805000, while the plant species Austrobaileya scandens has a DCID of dc/bsmvthtq89217.

Entity

{: #entity}

An entity represented by a node in the Data Commons knowledge graph. These can represent a wide range of concepts, including cities, countries, elections, schools, plants, or even the Earth itself.

Facet

{: #facet}

Metadata on properties of the data and its provenance. For example, multiple sources might provide data on the same variable, but use different measurement methods, cover data spanning different time spans, or use different underlying predictive models. Data Commons uses "facet" to refer to a data's source and its associated metadata.

{: #measurement-denominator}

The denominator of a fractional measurement.

{: #measurement-method}

The technique used for measuring a variable. Describes how a measurement is made, whether by count or estimate or some other approach. May name the group making the measurement to indicate a certain organizational method of measurement is used. Examples include the American Community Survey and WorldHealthOrganizationEstimates. Multiple measurement methods may be specified for any given node.

{: #observation}

A measurement of a variable for a particular place and time. For example, a StatVarObservation of the StatisticalVariable Median_Income_Person for Brookmont, Maryland, in the year 2018 would be $126,199. A complete list of properties of statistical variable observations can be found in the graph browser.

{: #observation-period}

The time period over which an observation is made. Specified in ISO 8601 formatting for durations.

Place

{: #place}

Entities that describe specific geographic locations.

Preferred Facet

{: #preferred-facet}

When a variable has values from multiple facets, one facet is designated the preferred facet. The preferred facet is selected by an internal ranking system which prioritizes the completeness and quality of the data. Unless otherwise specified, endpoints will default to returning values from preferred facets.

Property

{: #property}

Attributes of the entities in the Data Common knowledge graph. Instead of statistical values, properties describe unchanging characteristics of entities, like scientific name.

{: #scaling-factor}

Property of variables that measure proportions, used in conjunction with the measurementDenominator property to indicate the multiplication factor applied to the proportion's denominator (with the measurement value as the final result of the multiplication) when the numerator and denominator are not equal.

As an example, in 1999, approximately 36% of Canadians were Internet users. Here the measured value of Count_Person_IsInternetUser_PerCapita is 36, and the scaling factor or denominator for this per capita measurement is 100. Without the scaling factor, we would interpret the value to be 36/1, or 3600%.

A complete list of properties can be found in the graph browser.

Triple

{: #triple}

A three-part grouping describing node and edge objects in the Data Commons graph.

Given tabular data such as the following:

country_id country_name continent_id
USA United States of America northamerica
IND India asia

You can represent this data as a graph via subject-predicate-object "triples" that describe the node and edge relationships.

USA -- typeOf ------------> Country
USA -- name --------------> United States of America
USA -- containedInPlace --> northamerica

{: #unit}

The unit of measurement. Examples include kilowatt hours, inches, and Indian Rupees. A complete list of properties can be found in the graph browser.

{: #variable}

Any type of metric, statistic, or measure that can be measured at a place and time. Examples include median income of persons older than 16, number of female high school graduates aged 18 to 24, unemployment rate, or percentage of persons with diabetes. A complete list of variables can be found in the graph browser.

{: #variable-group}

Represents a grouping of variables that are conceptually related. For example, variable group Person With Gender = Female consists of variables like Female Median Age, Female Median Income and etc. A variable group could also have child variable groups, which describe a subset of the parent variable group. For example, variable group Person With Age, Gender = Female is a child of Person With Gender = Female. It contains variables that have age constraints.