Grants

This section provides information about the Grants source , listing each field available for Grants, with details about the field value type, including whether it may be used as a facet and whether it is a multi-value field. The table also contains information about whether the field may be used in the where section and whether the field the field may be used in the entity fields filter. The page also lists the fields included in each fieldset available for Grants, and each aggregation indicator available.

Grants Fields

Fields are used to perform searches on the source they belong to.

Field

Type

Multi?

Filter?

Facet?

Description

abstract

Literal: string

Abstract or summary from a grant proposal.

active_year

Literal: integer

List of active years for a grant.

category_bra

Entity: categories

Broad Research Areas

category_for

Entity: categories

ANZSRC Fields of Research classification

category_hra

Entity: categories

Health Research Areas

category_hrcs_hc

Entity: categories

HRCS - Health Categories .

category_hrcs_rac

Entity: categories

HRCS – Research Activity Codes .

category_icrp_cso

Entity: categories

ICRP Common Scientific Outline

category_icrp_ct

Entity: categories

ICRP Cancer Types

category_rcdc

Entity: categories

Research, Condition, and Disease Categorization .

category_sdg

Entity: categories

SDG - Sustainable Development Goals

category_uoa

Entity: categories

Units of Assessment

concepts

Literal: json

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

concepts_scores

Literal: json

Relevancy scores for concepts. 1

date_inserted

Literal: date

Date when the record was inserted into Dimensions (note: this field does not support exact match on the data, only range filters e.g. <= or >=).

dimensions_url

Literal: string

Link pointing to the Dimensions web application

end_date

Literal: date

Date when the grant ends.

foa_number

Literal: string

The funding opportunity announcement (FOA) number, where available e.g. for grants from the US National Institute of Health (NIH) or from the National Science Foundation (NSF).

funder_countries

Entity: countries

The country linked to the organisation funding the grant, expressed as GeoNames codes.

funders

Entity: organizations

The organisation funding the grant. This is normally a GRID organisation, but in very few cases a Dimensions funder ID is used.

funding_aud

Literal: float

Funding amount awarded in AUD.

funding_cad

Literal: float

Funding amount awarded in CAD.

funding_chf

Literal: float

Funding amount awarded in CHF.

funding_currency

Literal: string

Original funding currency.

funding_eur

Literal: float

Funding amount awarded in EUR.

funding_gbp

Literal: float

Funding amount awarded in GBP.

funding_jpy

Literal: float

Funding amount awarded in JPY.

funding_nzd

Literal: float

Funding amount awarded in NZD.

funding_org_acronym

Literal: string

Acronym for funding organisation.

funding_org_city

Literal: string

City name for funding organisation.

funding_org_name

Literal: string

Name of funding organisation.

funding_usd

Literal: float

Funding amount awarded in USD.

grant_number

Literal: string

Grant identifier, as provided by the source (e.g., funder, aggregator) the grant was derived from.

id

Literal: string

Dimensions grant ID.

investigator_details

Literal: json

Additional details about investigators, including affiliations and roles e.g. ‘PI’ or ‘Co-PI’ (note: if the investigator has a Dimensions researcher ID, that is returned as well). 2

language

Literal: string

Grant original language, as ISO 639-1 language codes.

language_title

Literal: string

ISO 639-1 language code for the original grant title.

linkout

Literal: string

Original URL for the grant.

original_title

Literal: string

Title of the grant in its original language.

research_org_cities

Entity: cities

City of the research organisations receiving the grant, expressed as GeoNames id and name.

research_org_countries

Entity: countries

Country of the research organisations receiving the grant, expressed as GeoNames code and name.

research_org_names

Literal: string

Names of organizations investigators are affiliated to.

research_org_state_codes

Entity: states

State of the organisations receiving the grant, expressed as GeoNames codes (ISO‌-3166-2).

research_orgs

Entity: organizations

GRID organisations receiving the grant (note: identifiers are automatically extracted from the source text and can be missing in some cases).

researchers

Entity: researchers

Dimensions researchers IDs associated to the grant.

start_date

Literal: date

Date when the grant starts, in the format ‘YYYY-MM-DD’.

start_year

Literal: integer

Year when the grant starts.

title

Literal: string

Title of the grant in English (if the grant language is not English, this field contains a translation of the title).

1

Returned objects contain: concept, relevance.

For example:

{
    "concepts_scores": [
        {
          "concept": "professional relations",
          "relevance": 0.08789352253426701
        },
        {
          "concept": "relation",
          "relevance": 0.062333122509877006
        },
        {
          "concept": "representation",
          "relevance": 0.025851134800039
        },
        {
          "concept": "skald",
          "relevance": 6.984149644517923e-05
        },
        {
          "concept": "Representations of Skalds",
          "relevance": 0.0
        },
        {
          "concept": "Sagas 1",
          "relevance": 0.0
        }
    ]
}  
2

Returned objects contain: id, first_name, middle_name, last_name, role, affiliations

For example:

{
    "investigator_details":[
        {
            "id":"ur.012516501745.79",
            "first_name":"O.",
            "middle_name":"",
            "last_name":"Mitas",
            "role":"PI",
            "affiliations":[
                {
                    "id":"grid.5477.1",
                    "name":"Breda University of Applied Sciences",
                    "city":null,
                    "city_id":"2745912",
                    "state":null,
                    "state_code":null,
                    "country":null,
                    "country_code":"NL"
                }
            ]
        }
    ]
}

Grants Fieldsets

Fieldsets are used to specify fields groups in the context of a return statement.

Fieldset

Fields

extras

funder_countries funding_org_acronym funding_org_city linkout research_org_name researchers

categories

category_bra category_for category_hra category_hrcs_hc category_hrcs_rac category_icrp_cso category_icrp_ct category_rcdc category_uoa

basics

active_year end_date funders funding_org_name id language original_title project_num start_date start_year title title_language

Grants Indicators

Indicators are used to aggregate results in the context of a facet query.

Indicator

Description

funding

Total funding amount, in USD.

count

Total count

Grants Search Indexes

Search indexes are used to perform full-text searches on the source they belong to. The default search index, which is used if none other is specified, is full_data.

Search index

Supports multi-index search

Description

title_only

Search for keywords in title only.

title_abstract_only

The keywords will be searched for in the title and abstract fields only.

investigators

Search for name and surname combinations in the investigators list of this grant (note: see the researchers search section for more details).

full_data

The keyword will be searched for in all data fields that are found for that document. In cases where the full text is indexed in the background this will also be searched, even though the full text may not be available to see within Dimensions itself. This will mean that many results that are returned may not include mention of the searched keyword on the document page, but are returned in the search because the keyword can be found in the full text which cannot be read.

concepts

Search for keywords in the concepts list for this grant.

Grants Deprecations

This section lists fields and search fields that have been deprecated and should not be used.

Warning

This fields will be supported in versions 1.x and removed in the next major release. To ensure full compatibility with the upcoming major release, it is recommend to stop using deprecated fields as soon as possible.

Deprecated Fields

Field

Deprecation Note

FOR

Deprecated in favor of: category_for

FOR_first

Deprecated in favor of: category_for

HRCS_HC

Deprecated in favor of: category_hrcs_hc

HRCS_RAC

Deprecated in favor of: category_hrcs_rac

project_num

Deprecated in favor of: grant_number

RCDC

Deprecated in favor of: category_rcdc

research_org_name

Deprecated in favor of: research_orgs

researcher_details

Deprecated in favor of: investigator_details

resulting_publication_ids

Deprecated: use the Publications field supporting_grant_ids instead (see also: Grants Links section).

terms

Deprecated in favor of: concepts

title_language

Deprecated in favor of: language_title

Partially Deprecated Fields

Grants source has no partially deprecated fields.

Deprecated Search Indexes

Search Index

Deprecation Note

terms

Deprecated in favor of: concepts

researchers

Deprecated in favor of: investigators