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 or country: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 logical OR 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.