Technical Specifications

General Overview

The Publication Facts Label presents information alongside a Reviewable Article. It contrasts the article's statistics against those for other reviewable articles, in order to inform the reader about norms and how this article compares to them.

Terminology

• Reviewable Article: A published scholarly work that is suitable for peer review. Examples of reviewable articles:

  1. A journal article that is published in the "Articles" section of an academic journal and has undergone peer review.
  2. A journal article that is published in the "Articles" section of an academic journal, but has not undergone peer review.

  Examples of pieces of content that are not reviewable articles:

  1. A journal article that is published in the "Literature Reviews" section of an academic journal. Review articles are typically not subject to peer review.
  2. A note from the editors published alongside peer-reviewed content. Notes from the editors are typically not subject to peer review.

  The Publication Facts Label should only be displayed on a Reviewable Article.

• Repository: The stand-alone collection of published scholarly content to which the Publication Facts Label is being applied. This is the collection of content for which statistics may be contributed upstream to the Integrity Initiative; see Contributing to Statistics for details.

Fields & Calculations

1. Peer reviewers: After this text, indicate the total number of peer reviewers who have provided reviews for this article. (If a single reviewer has reviewed the article in multiple rounds, they are only counted once.)
2. Reviewer profiles: If the platform provides information about reviewer profiles, this text should be followed by "Yes", which should be a link to where the profiles can be viewed. If not, use the text "Reviewer profiles: N/A" to indicate "not applicable".
3. Data availability: If the platform provides author data availability statements, this text should be followed by "Yes", which should be a link to where the statements can be found. If not, use the text "Data availability: N/A" to indicate "not applicable".

4. External funding: This area indicates whether funding data is supported by the platform, and if so, whether it is available for this article. It can appear as follows:

   • If the platform does not support information about external funders, it should read External funding: N/A.
   • If the platform supports funding information and it has been entered for this article, it should read External funding: Yes, and the "Yes" should link to where the funding data is presented.
   • If the platform supports funding information but none has been entered for this article, it should read External funding: No.

5. Competing interests: After this text, indicate whether Competing Interests are available for at least one of the article's authors. It can appear as follows:

   • If the platform does not support author Competing Interest statements, it should read Competing interests: N/A (for Not Applicable).
   • If the platform supports author Competing Interest statements but none have been provided for this article, it should read Competing interests: No.
   • If the platform supports author Competing Interest statements and at least one has been proviuded, it should read Competing Interests: Yes, and the "Yes" should link to where the competing interest statement(s) are presented.
6. Articles accepted: After this text, include the percentage of reviewable articles in this repository that are accepted for publication.
7. Days to publication: After this text, include number of days between the author's initial submission of this work in its current form and the date it was first published online.
8. Indexed in: After this text, list (in as brief a form as possible) the major indexes in which this content appears. Each entry in the list should be a link to the article's record in the index. If that is not possible, link as closely as possible to the individual resource -- for example, to search results by the article's DOI or title.
9. Editor & editorial board: After this text, link to a page listing the editorial board's profiles. If the platform supports verified ORCID identifiers for the editorial board, include the ORCID icon in compliance with ORCID's brand guidelines.
10. Society: After this text, include the name of the academic society (if any) involved in the publication of this journal. If possible, link this text to the society's website. If the platform does not support designating an academic society, use the text "N/A" to indicate Not Available.
11. Publisher: After this text, include the name of the journal's publisher. If possible, link this text to the publisher's website. If the platform does not support designating a publisher, use the text "N/A" to indicate Not Available.

Getting "Other articles" Statistics

Current statistics can be downloaded from https://pkp.sfu.ca/ojs/pflStatistics.json. We recommend downloading on e.g. a daily or weekly basis and caching locally. Statistics from your repository can be provided upstream when downloading these statistics; see the Contributing to Statistics section for details.

The JSON file's elements can be interpreted as follows:

• pflNumAcceptedClass: The acceptance rate, in percent, of comparable journals. Example: 18 to indicate an 18% acceptance rate.
• pflReviewerCountClass: Average number of peer reviewers per comparable articles. Example: 2.5 to indicate that comparable articles have been reviewed by an average of 2.5 individual peer reviewers.
• pflCompetingInterestsPercentClass: Percentage of comparable articles that provide at least one author Competing Interest statement with the published content. Example: 25 to indicate that 25% of comparable articles provided at least one author Competing Interest statement.
• pflDataAvailabilityPercentClass: Percentage of comparable articles that provide a Data Availability statement with the published content. Example: 40 to indicate that 40% of comparable articles provided at least one Competing Interest statement.
• pflNumHaveFundersClass: Percentage of comparable articles that provide funding data with the published content. Example: 20 to indicate that 20% of comparable articles indicated at least one funding source.
• pflDaysToPublicationClass: The average number of days between initial submission and first publication for comparable articles. Example: 240 to indicate that the average comparable submission took 240 days between submission and publication.

Contributing to Statistics

Statistics from your repository can be provided upstream for inclusion in the "Other statistics" data by adding URL parameters when fetching the statistics.

Base URL: https://pkp.sfu.ca/ojs/pflStatistics.json

Additional parameters:

• platform: A unique name for the platform. Example: ojs to indicate Open Journal Systems.
• version: Version indicator for the Publication Facts Label integration. This indicator should adhere to semver conventions.
• journalUrl: A URL to the Repository's homepage.
• pflNumAcceptedClass: The number of published Reviewable Articles in the Repository. For example, 153 would indicate that 153 Reviewable Articles were published.
• pflReviewerCountClass: The average number of completed peer reviews per published Reviewable Article in the Repository.
• pflCompetingInterestsClass: The number of published Reviewable Articles in the Repository that have at least one author Competing Interest statement available. For example, 123 would indicate that there are 123 published Reviewable Articles with at least one author Competing Interest statement for each article with details available via the website. Platforms not supporting this metric should supply the text "N/A" for Not Applicable.
• pflDataAvailabilityClass: The number of published Reviewable Articles in the Repository that have a published data availability statement. For example, 58 would indicate that there are 58 published Reviewable Articles with posted Data Availability statements. Platforms not supporting this metric should supply the text "N/A" for Not Applicable.
• pflNumHaveFundersClass: The number of published Reviewable Articles in the Repository that have at least one grand funder identified. For example, 141 would indicate that there are 141 published Reviewable Articles with at least one grant funder for each article with details available via the website. Platforms not supporting this metric should supply the text "N/A" for Not Applicable.
• pflDaysToPublicationClass: The average number of days between submission and publication for the published Reviewable Articles in the Repository. For example, a value of 150 indicates that on average, it took 150 days from the article submission to publication.
• reviewableSubmissionsCount: The number of Reviewable Articles in the Repository. Note that these are not necessarily published. For example, the Acceptance Rate for the Repository may be calculated as the ratio of pflNumAcceptedClass to reviewableSubmissionsCount.
• issn: The International Standard Serial Number for the journal. Online ISSNs are preferred to print ISSNs if both are available. This value is used to help disambiguate between participants in the Publication Facts Label.

Example

    curl -G \
    -d "platform=ojs" \
    -d "version=1.0.0.1" \
    -d "journalUrl=https://publisher.test/journal" \
    -d "pflNumAcceptedClass=153" \
    -d "pflReviewerCountClass=2.5" \
    -d "pflCompetingInterestsClass=123" \
    -d "pflDataAvailabilityClass=58" \
    -d "pflNumHaveFundersClass=141" \
    -d "pflDaysToPublicationClass=150" \
    -d "reviewableSubmissionsCount=192" \
    -d "issn=1234-5678" \
    https://pkp.sfu.ca/ojs/pflStatistics.json