Search - SCOAP3/scoap3-next GitHub Wiki
The search tool available on the repository website is a user-friendly interface for the API search and is based on ElasticSerach 6.2.4. Here a summary is provided for the most frequent queries.
Facets
The website provides the possibility to filter for date, country, and journal through facets. These are visible before entering a search query and after it as well. On the results page the following facets can be found:
- Year: filters for the publication date. It is possible to select a single year or a range.
- Country: filters for the affiliations of the authors. Only articles with at least one author having an affiliation with the selected country will be displayed. Note that there is an AND relation between the selected countries.
- Journal: filters for the journal in which the article was published.
Queries using a query string
It is possible to use a query string along with the facets. This will result in an AND logical connection between the query text and the selected facets. For more advanced usage consulting the ElasticSearch Query String documentation can prove useful.
Frequently used queries
Search by journal
- Select a journal name from the list of journals on the main page, or
- On the search results page, select a
Journal
filter from the facet on the left hand side,or - Enter the name of the journal as a query using
journal
keyword:journal:"Acta Physica Polonica B"
,- or using abbreviation
journal:APPB
.
Search by year
- Enter the desired year as a query using
year
keyword:year:2019
,- or a range search:
year:>=2017
- all articles published in 2017 or later
- On the search results page, use a
Year
filter from the facet on the left hand side - this supports a single year or a range.
Search by date
- Enter the desired date as a query using
date
keyword:date:2019-01-02
,- or a range search:
date:>2018-01-01
- all articles after 1st of January 2018
Note: date:2019
is equivalent to date:2019-01-01
.
Search by country
- On the main page, select tab SCOAP3 partner countries and select one of the countries on the list, or
- on the results page, use a Country filter from the facet on the left hand side - this supports multiple selections.
- Enter the desired country as a query using
country
field:country:Hungary
orcountry:USA
Note: only articles that have affiliation with all selected countries will be displayed. The list of available countries (visible in facets) always depends on the current results, so if there is no article associated with a country that country won't be displayed in the filter.
Search by author
Enter the desired author as a query using author
field: author:"John Doe"
.
Search by author affiliation
Enter the desired affiliation as a query using affiliation
field: affiliation:"University of Oklahoma"
.
Search by DOI
Enter the desired DOI as a query using doi
field: doi:"10.1016/j.physletb.2018.01.002"
.
Search by arXiv
Search directly with the arXiv ID, without additional fields: 1808.02380
.
Multiple filters
If there is more than one phrase in the search text, those will be connected with logical AND
.
Example:
- articles that are affiliated with Hungary and China.
country:Hungary country:China
country:Hungary AND country:China
country:(Hungary AND China)
It is also possible to use the logicalOR
field if needed.
- articles that are affiliated with Hungary or China:
country:Hungary OR country:China
country:(Hungary OR China)
Negation
It's also possible to negate something, with the NOT
keyword.
Example: articles that are affiliated with China but NOT with Hungary (following three queries are identical in their meaning):
country:(NOT Hungary) country:China
country:(NOT Hungary) AND country:China
country:((NOT Hungary) AND China)
Usable fields
journal
: contains the journal in which the article was published.author
: contains all the full names of the authors.country
: contains all the countries from the affiliations.affiliation
: contains all the affiliations from the authors. Note that the affiliations are as they were sent by the publishers, so the same institute can have different representations.control_number
: contains the internal identifier assigned to the record (former recid).record_creation_date
: contains the date when the record was (first) added to the SCOAP3 repository.title
: contains the titles of the article.doi
: contains the dois of the article.date
: contains the date of publication.