Serial TitleΒΆ

SerialTitle() implements the Serial Title API. It provides basic information on registered serials (also called sources), like publisher and identifiers, but also metrics.

You initialize the class with an ISSN or an E-ISSN (works with and without hyphen, but leading zeros are mandatory):

>>> from pybliometrics.scopus import SerialTitle
>>> source = SerialTitle("00368075")

There is an optional parameter, years. By default, SerialTitle() retrieves only the most recent metrics. If you provide a year or a range of years, SerialTitle() will retrieve information for these years:

>>> from pybliometrics.scopus import SerialTitle
>>> source = SerialTitle("00368075", years="2017-2019")

You can obtain basic information just by printing the object:

>>> print(source)
'Science', journal published by 'American Association for the
Advancement of Science', is active in Multidisciplinary
Metrics as of 2021-01-28:
    SJR:  year value
          2017 14.142
          2018 13.251
          2019 13.110
    SNIP: year value
          2017 7.366
          2018 7.529
          2019 7.521
    ISSN: 0036-8075, E-ISSN: 1095-9203, Scopus ID: 23571

The object has a number of attributes but no methods. For example, information regarding the source itself:

>>> source.title
'Science'
>>> source.publisher
'American Association for the Advancement of Science'
>>> source.issn
'0036-8075'
>>> source.eissn
'1095-9203'
>>> source.source_id
'23571'

Perhaps most importantly the SCImago Journal Rank (SJR) indicator and the Source-normalized Impact per Paper (SNIP). The information is stored in lists of 2-element tuples with the first element indicating the year the metric was evaluated.

>>> source.sjrlist
[('2017', '14.142'), ('2018', '13.251'), ('2019', '13.110')]
>>> source.sniplist
[('2017', '7.366'), ('2018', '7.529'), ('2019', '7.521')]

The fields associated with the source are stored as a list of namedtuples:

>>> source.subject_area
[Subjectarea(area='Multidisciplinary', abbreviation='MULT', code='1000')]

Additionally there are many bits of information on Open Access status which are often empty however.

Downloaded results are cached to speed up subsequent analysis. This information may become outdated. To refresh the cached results if they exist, set refresh=True, or provide an integer that will be interpreted as maximum allowed number of days since the last modification date. For example, if you want to refresh all cached results older than 100 days, set refresh=100. If years is provided, SerialSearch() will always refresh.

Use source.get_cache_file_mdate() to get the date of last modification, and source.get_cache_file_age() the number of days since the last modification.