Here is a list of the terms that have special meanings within the DSL and its documentation, most of which are taken from the larger Dimensions ecosystem.
A record of special interest.
Differs from a source insofar as it does not have textual data to be searched, but instead only stores metadata about the object it represents. Examples: funder, research org., category, country, etc.
See Data Sources for a comprehensive list of supported entities.
Entities can only be considered in the context of the source with which they are associated, and cannot be queried independently from that source. For example, we can retrieve funders of publications, or funders of research grants, but we can’t search through the set of all funders generally.
A type of named field on a source record which can be used for faceting, i.e. aggregation of a certain indicator over the result set returned (with aggregations being calculated after any filters have been applied and scoring by search term similarity has been computed).
Examples of facets for grants:
A facet may correspond to an entity, i.e. a record, as is the case with e.g. the
fundersfacet. Alternatively, a facet may correspond simply to a literal value, as is the case with the
A property of a record, corresponding to a piece of information about the record or entity which that record represents. Loosely corresponds to the notion of a column if the record is considered as a database row.
- Function Expression
Type of query useful for performing non-search requests. It allows calling functions with arguments. Arguments can be either named or not-named. Named arguments must come last and any non-named arguments must come first, in the proper order.
funding(sum of USD funding amounts),
A complete expression in the DSL query language, which corresponds to a request for Dimensions data.
search grants about "HIV" return funders
An entry (document).
- Search Index
A full text search index that can be used to perform keyword search operations. For example,
full_dataas specified in the “search in” syntax section.
- Search Term
"malaria in Africa"
A member of the set of Dimensions record types which can be searched (as opposed to an entity record, which cannot be searched directly.)
See Data Sources for a comprehensive list of supported sources.
A short piece of text data, which begins and ends with double quotes (
"Universität des Saarlandes"
May appear in various phrases of a query, such as
As the double quote character (
") is used to indicate the start and end of a string, if the string’s text itself contains this character, it must be escaped with a preceding backslash (
"a so-called \"superbug\" virus"is a valid string, but
"a so-called "superbug" virus"is not a valid string (it would be interpreted by the parser as the string
"a so-called ", the unknown name
superbug, and the string
" virus", resulting in an error).