RIS (file format)

RIS is a standardized tag format developed by Research Information Systems, Incorporated (the format name refers to the company) to enable citation programs to exchange data.[1] It is supported by a number of reference managers. Many digital libraries, like IEEE Xplore, Scopus, the ACM Portal, Scopemed, ScienceDirect, SpringerLink, Rayyan, Accordance Bible Software,[2] and online library catalogs can export citations in this format. Citation management applications can export and import citations in this format.

RIS
Filename extension
.ris
Internet media type
application/x-research-info-systems
Type of formatBibliography

Format

The RIS file format—two letters, two spaces and a hyphen—is a tagged format for expressing bibliographic citations. According to the specifications,[3][4][5] the lines must end with the ASCII carriage return and line feed characters. Note that this is the convention on Microsoft Windows, while in other contemporary operating systems, particularly Unix, the end of line is typically marked by line feed only.

Multiple citation records can be present in a single RIS file. A record ends with an "end record" tag ER - with no additional blank lines between records.

Example record

This is an example of how the article "Claude E. Shannon. A mathematical theory of communication. Bell System Technical Journal, 27:379–423, July 1948" would be expressed in the RIS file format:

TY  - JOUR
AU  - Shannon, Claude E.
PY  - 1948
DA  - July
TI  - A Mathematical Theory of Communication
T2  - Bell System Technical Journal
SP  - 379
EP  - 423
VL  - 27
ER  - 

Example multi-record format

This is an example of how two citation records would be expressed in a single RIS file. Note the first record ends with ER - and the second record begins with TY - JOUR:

TY  - JOUR
AU  - Shannon, Claude E.
PY  - 1948
DA  - July
TI  - A Mathematical Theory of Communication
T2  - Bell System Technical Journal
SP  - 379
EP  - 423
VL  - 27
ER  - 
TY  - JOUR
T1  - On computable numbers, with an application to the Entscheidungsproblem
A1  - Turing, Alan Mathison
JO  - Proc. of London Mathematical Society
VL  - 47
IS  - 1
SP  - 230
EP  - 265
Y1  - 1937
ER  - 

Tags

The TY - tag must appear first and the ER - tag must appear last.[6][7][8] Most tags must appear at most once, but the author, keyword, and URL tags can be repeated.[6]

Each name must be formatted as a comma-separated list of last name, first name (including middle names, can be initials), and suffix, in that order, and must not be longer than 255 characters.[6][9][10][8] Unless otherwise specified, each date must be formatted as a slash-separated list of 4-digit year, 2-digit month, 2-digit day, and other info (e.g. season); unused fields may be omitted if they are at the end.[6][11][8]

Many strings have limits on what characters they can contain (e.g. any ASCII character, just alphanumerics, or just digits) or their length (often limited to 255 characters). These are only sometimes noted in the table below; see the linked sources to double-check, particularly [9] and the pages in RIS Format Specifications.

There are two major versions of the RIS specification, one from 2001, and one from the end of 2011 with different lists of tags for each type of record, sometimes with different meanings.[4][5][12][13] Below is an excerpt of the main RIS tags, from both versions. Except for TY - and ER -, order of tags is free and their inclusion is optional.

 Tag Meaning (see linked references for more details, such as which types have which interpretations)
A1 Interviewee.[14] (Primary) author.[9][10][15][16][17][18] Synonym of AU.[8]
A2 Secondary author/editor/translator, e.g. editor, performers, sponsor, series editor, reporter, institution, name of file, producer, series director, department, interviewer, issuing organization, recipient, or narrator. The tag must be repeated for each person. Synonym of ED.[6][9][10][14][8][15][16][18][19][20]
A3 Tertiary author/editor/translator, e.g. series editor/author, illustrator, editor, higher court, producer, director, international author, publisher, or advisor. The tag must be repeated for each person.[6][9][10][14][8][15][18][19][20] Collaborators.[16][17]
A4 Subsidiary/quaternary author/editor/translator, e.g. translator, counsel, sponsor, funding agency, performers, producer, department/division, or volume editor. The tag must be repeated for each person.[6][14][15][18][20]
A5 Quinary author / compiler.[15]
A6 Website editor.[15]
AB Abstract or synopsis.[6][14][8][15][17][18][19] Notes.[11][20] Synonym of N2.[8]
AD (Author/editor/inventor) address, e.g. postal address, email address, phone number, and/or fax number.[6][14][9][21][8][15][18][19] Institution.[20]
AN Accession number.[6][14][15][20]
AU (Primary) author/editor/translator, e.g. author, artist, created by, attribution, programmer, investigators, editor, director, interviewee, cartographer, composer, reporter, inventor, or institution. The tag must be repeated for each person. Synonym of A1.[6][10][14][8][16][17][18][19][20]
AV Notes.[14] Availability (description of where to find it).[9][22][8][15] Location in archives.
BT Primary/secondary title.[8][23][16][18][19] For Whole Book (BOOK) and Unpublished Work (UNPB) references, this maps to T1 or TI; for all other types, this maps to T2.[8][23] Subtitle.[16] Book title.[17]
C1 Custom 1, e.g. legal note, cast, author affiliation, section, place published, time period, term, year cited, government body, contact name, scale, format of music, column, or sender's e-mail.[6][14][18][20]
C2 Custom 2, e.g. PMCID, credits, year published, unit of observation, date cited, congress number, contact address, area, form of composition, issue, issue date, recieipients e-mail, or report number.[6][14][18][20]
C3 Custom 3, e.g. size/length, title prefix, proceedings title, data type, PMCID, congress session, contact phone, size, music parts, or designated states.[6][14][18][20]
C4 Custom 4, e.g. reviewer, dataset(s), genre, contact fax, target audience, or attorney/agent.[6][14][18][20]
C5 Custom 5, e.g. format, packaging method, issue title, last update date, funding number, accompanying matter, format/length, references, or publisher.[6][14][18][20]
C6 Custom 6, e.g. NIHMSID, CFDA number, legal status, issue, or volume.[6][14][18][20]
C7 Custom 7, e.g. article number or PMCID.[6][14][18][20]
C8 Custom 8, not used by any of the standard types.[6][14][18][20]
CA Caption.[6][14][18][19][20]
CL Classification.[15]
CN Call number.[6][14][15][16][18][19][20]
CP City/place of publication.[9][16] Issue.[21][18]
CR Cited references.[15]
CT Caption.[14] Primary title.[23][16] Address.[18] Title of unpublished reference.
CY Place published, e.g. city, conference location, country, or activity location.[6][14][21][8][16][18][19][20]
DA Date, e.g. date accessed, last update date, date decided, date of collection, date released, deadline, date of code edition, or date enacted.[6][14][18][20]
DB Name of database.[6][14][15][18][20]
DI Digital Object Identifier (DOI).[18]
DO Digital Object Identifier (DOI).[6][14][15][16][18][19][20] This used to be documented as "Document Object Index".[24]
DOI Digital Object Identifier (DOI).[17]
DP Database provider.[6][14][18][20]
DS Data source.[15]
ED Secondary author.[10] Editor.[17][18][19] Synonym of A2.[8][16] Edition.[15]
EP Pages.[14] End page.[9][21][8][16][17][18][19]
ER End of reference. Must be the last tag.[6][7][9][23][8][17]
ET Edition, e.g. epub (electronic publication?) date, date published, session, action of higher court, version, requirement, description of material, international patent classification, or description.[6][14][16][18][19][20]
FD Free-form publication data.[15]
H1 Location (library).[16]
H2 Location (call number).[16]
ID Reference identifier, may be limited to 20 alphanumeric characters.[9][23][8][15][18][19]
IP Identifying phrase.[15]
IS Number, e.g. issue or number of volumes.[6][14][9][21][8][15][16][17][18][19][20]
J1 Notes.[14] User abbreviation 1 of journal/periodical name.[9][25][8][13][18]
J2 Alternate title, e.g. alternate journal, abbreviated publication, abbreviation, or alternate magazine. If possible, it should be a standard abbreviation, preferably using the Index Medicus style including periods. This field is used for the abbreviated title of a book or journal name, the latter mapped to T2.[6][14][13][18][20]

User abbreviation 2 of journal/periodical name.[9][25][8][13]

JA Standard abbreviation for journal/periodical name.[25][13][16][17][18]
JF Full name of journal/periodical.[9][25][8][13][15][16][17][18][20]
JO Abbreviation (for journal/periodical name).[14][8][13][15][16][17][18][19] "Periodical name: full format. This is an alphanumeric field of up to 255 characters."[9][25]
K1 Keyword.[15]
KW Keyword/phrase. Must be at most 255 characters long. May be repeated any number of times to add multiple keywords.[6][14][9][26][8][16][17][18][19][20]
L1 File attachments, e.g. figure.[6][14][18][19][20] "Link to PDF. There is no practical length limit to this field. URL addresses can be entered individually, one per tag or multiple addresses can be entered on one line using a semi-colon as a separator. These links should end with a file name, and not simply a landing page. Use the UR tag for URL links."[9][22] Internet link.[16] Local file.[18]
L2 URL.[14] "Link to Full-text. There is no practical length limit to this field. URL addresses can be entered individually, one per tag or multiple addresses can be entered on one line using a semi-colon as a separator."[9][22] Internet link.[16]
L3 DOI.[14] Related records.[9][22] Internet link.[16]
L4 Figure, e.g. URL or file attachments.[6][14][18][19][20] Images.[9][22] Internet link.[16] Local file.[18]
LA Language.[6][14][15][18][19][20]
LB Label.[6][14][18][20]
LK Links.[15]
LL Sponsoring library location.[15]
M1 Number, publication number, text number, size, bill number, series volume, computer, issue, chapter, status, document number, start page, issue number, folio number, number of screens, application number, number of pages, public law number, or access date.[14][18][20] Miscellaneous 1.[9][22][8][17][18] A good place for type or genre information.[8]
M2 Start page, notes, or number of pages.[14][20] Miscellaneous 2.[9][22][17][18]
M3 Type of work, e.g. type (of work/article/medium/image); citation of reversal; medium; funding, patent, or thesis type; format; or form of item.[6][14][18][20] Miscellaneous 3.[9][22][8][17][18] Suitable to hold the medium.[8]
N1 Notes.[6][14][9][11][8][16][17][18][19][20]
N2 Abstract.[14][9][11][8][16][18] Synonym of AB.[8]
NO Notes.[15]
NV Number of volumes, e.g. extent of work, reporter abbreviation, catalog number, study number, document number, version, amount received, session number, frequency, manuscript number, US patent classification, communication number, series volume, or statute number. Ignored for Press Release (PRESS).[6][14][18][19][20]
OL Output language (using one of the documented numeric codes).[15]
OP Original publication, e.g. contents, history, content, version history, original grant number, or priority numbers.[6][14][18] Other pages.[15][20] Original foreign title.[15]
PA Personal notes.[15]
PB Publisher, e.g. court, distributor, sponsoring agency, library/archive, assignee, institution, source, or university / degree grantor.[6][14][9][21][8][15][16][17][18][19][20]
PMCID PMCID.[15]
PMID PMID.[15]
PP Place of publication.[15]
PY (Primary) (publication) year/date, e.g. year decided, year of conference, or year released.[6][14][11][8][16][17][18][20] Must always use 4 digits, with leading zeros if before 1000.[6] Synonym of Y1.[8]
RD Retrieved date.[15]
RI Reviewed item, geographic coverage, or article number.[14][18][20]
RN Research notes.[14][18][20]
RP Reprint status, e.g. reprint edition, review date, or notes. Has three possible values: "IN FILE", "NOT IN FILE", or "ON REQUEST". "ON REQUEST" must be followed by an MM/DD/YY date in parentheses.[6][14][9][26][8][17][18][20]
RT Reference type.[15]
SE Section, screens, code section, message number, pages, chapter, filed date, number of pages, original release date, version, e-pub date, duration of grant, section number, start page, international patent number, or running time.[14][18][20]
SF Subfile/database.[15]
SL Sponsoring library.[15]
SN ISSN, ISBN, or report/document/patent number.[14][9][21][8][15][16][17][18][19][20]
SP Pages, description, code pages, number of pages, first/start page, or running time.[14][9][21][8][15][16][17][18][19][20]
SR Source type: Print(0) or Electronic(1).[15]
ST Short title or abbreviated case name.[14][15][18][20]
SV Series volume.[14]
T1 (Primary) title.[14][9][23][13][15][16][17][18]
T2 Secondary title, journal, periodical, publication title, code, title of weblog, series title, book title, image source program, conference name, dictionary title, periodical title, encyclopedia title, committee, program, title number, magazine, collection title, album title, newspaper, published source, title of show, section title, academic department, or full journal name.[6][14][9][23][8][13][15][16][18][19][20] Subtitle.[16]
T3 Tertiary title, volume title, series title, legislative body, institution, decision, website title, location of work, supplement no., international title, paper number, international source, or department.[14][9][23][8][15][16][18][19][20]
TA Translated author.[14][20]
TI (Primary) title, e.g. title of entry/grant/podcast/work, case name, or name of act.[14][23][8][13][16][17][18][19][20]
TT Translated title.[14][18][20]
TY Type of reference. Must be the first tag.[6][7][9][23][8][17][20]
U1 Notes.[14][18] User definable 1.[9][22][8][15][16][17] Thesis-type hint.[27][19]
U2–U5 Notes.[14][18] User definable 2–5.[9][22][8][15][16][17]
U6–U15 User definable 6–15.[15]
UR Web/URL. Can be repeated for multiple tags, or multiple URLs can be entered in the same tag as a semicolon-separated list.[6][9][22][8][15][16][17][18][19][20]
VL Volume, code volume, access year, reporter volume, image size, edition, amount requested, rule number, volume/storage container, number, patent version number, code number, or degree.[14][9][21][8][16][17][18][19][20]
VO Volume.[15][18] Published Standard number.
WP Date of electronic publication.[15]
WT Website title.[15]
WV Website version.[15]
Y1 "Year///Date".[14] Primary date/year.[9][11][16][17][18] Synonym of PY.[8]
Y2 Access date or date enacted.[14][18][20] Secondary date.[9][11][8][16] Date of publication.[17]
YR Publication year.[15]

Type of reference

The type of reference preceded by the TY - tag must abbreviated as:

RIS reference types
Abbreviation ("Field Label")Type ("Ref Type") Category[14]
ABSTAbstract[6][9][28][8][16][18][19] Journal Article
ADVSAudiovisual (material)[6][14][9][28][8][16] Audiovisual Material
AGGRAggregated database[6][14] Aggregated Database
ANCIENTAncient text[6][14] Ancient Text
ARTArtwork[6][14][9][28][8][16] Artwork
BILLBill/resolution[6][14][9][28][8][16] Bill (was Bill, Unenacted Bill)
BLOGBlog[6][14] Blog
BOOKBook (whole)[6][14][9][28][8][16][18][19] Book
CASELegal case and case notes[6][14][9][28][8][16][18][19] Case
CHAPBook section/chapter[6][14][9][28][8][16][18] Book Section
CHARTChart[6][14] Chart
CLSWKClassical work[6][14] Classical Work
COMPComputer program[6][14][9][28][8][16][18][19] Computer Program
CONFConference proceedings[6][14][9][28][8][16][18] Conference Proceedings
CPAPERConference paper[6][14] Conference Paper
CTLGCatalog[6][14][9][28][8][16] Catalog
DATAData file / dataset[6][14][9][28][8][16] Dataset (was Data File) AND Computer Program
DBASEOnline database[6][14] Online Database
DICTDictionary[6][14] Dictionary
EBOOKElectronic book[6][14] Electronic Book
ECHAPElectronic book section[6][14] Electronic Book Section
EDBOOKEdited book[6][14] Edited Book
EJOURElectronic article[6][14] Electronic Article
ELEC Web page / electronic citation[14][9][28][8][16][18][19] Web Page
ENCYCEncyclopedia[6][14] Encyclopedia
EQUAEquation[6][14] Equation
FIGUREFigure[6][14] Figure
GENGeneric[6][14][9][28][8][16][18] Generic
GOVDOCGovernment document[6][14] Government Document
GRNTGrant[6][14] Grant
HEARHearing[6][14][9][28][8][16][18][19] Hearing
ICOMMInternet communication[6][9][28][8][16] Personal Communication
INPRIn press article[6][9][28][8][16] Journal Article
INTV Interview[6][14] Interview
JFULLJournal/periodical (full)[6][9][28][8][16] Journal Article
JOURJournal/periodical (article)[6][14][9][28][8][16][18][19] Journal Article
LEGALLegal rule (or regulation)[6][14] Legal Rule
MANSCPTManuscript[6][14] Manuscript
MAPMap or cartographic data[6][14][9][28][8][16][18][19] Map
MGZNMagazine (article)[6][14][9][28][8][16][18][19] Magazine Article
MPCTFilm or broadcast / motion picture[6][14][9][28][8][16] Film or Broadcast
MULTIOnline multimedia[6][14] Online Multimedia
MUSICMusic (score)[6][14][9][28][8][16] Music
NEWSNewspaper (article)[6][14][9][28][8][16][18][19] Newspaper Article
PAMPPamphlet[6][14][9][28][8][16][18][19] Pamphlet
PATPatent[6][14][9][28][8][16][18][19] Patent
PCOMMPersonal communication[6][14][9][28][8][16][18][19] Personal Communication
POD Podcast[6][14] Podcast
PRESS Press release[6][14] Press Release
RPRTReport[6][14][9][28][8][16][18][19] Report
SERSerial (book, monograph)[6][14][9][28][8][16] Serial
SLIDESlide[6][9][28][8][16] Audiovisual Material
SOUNDSound recording[6][9][28][8][16] Audiovisual Material
STANDStandard[6][14] Standard
STATStatute[6][14][9][28][8][16][18][19] Statute
STD Generic[18]
THESThesis/dissertation[6][14][9][28][8][16][18][19] Thesis
UNBILLUnenacted bill/resolution[6][9][28][8][16] Bill (was Bill, Unenacted Bill)
UNPB Unpublished work[14][9][28][8][16][18][19] Unpublished Work
UNPDUnpublished work[6]
VIDEOVideo recording[6][9][28][8][16] Audiovisual Material
WEBWeb page[6]

See also

  • BIBFRAME—bibliographic framework, an emerging standard to replace MARC
  • Bibliographic record—general concept
  • BibTeX—a text-based data format used by LaTeX
  • EndNote—a text-based data scheme used by the EndNote program
  • MARC—machine-readable cataloging standards
  • refer—an aging text-based data scheme supported on UNIX-like systems

References

  1. The origin of the name RIS was obtained via email from Henry Johnson, a Customer Technical Representative at Scientific Thomson Reuters. Research Information Systems was acquired by the Institute for Scientific Information (ISI) in 1994, a division of Thomson Business Information (later Thomson Reuters and then Clarivate). Thomson subsequently acquired ProCite from Personal Bibliographic Software Inc, as well as Niles software, the creators of EndNote. The result of the merger was the creation of ISI ResearchSoft, a subsidiary of Thomson Reuters, which produces Reference Manager, EndNote and ProCite. Email date 7/3/08.
  2. "New Features in 11.2". www.accordancebible.com. Archived from the original on 2016-06-05.
  3. "RIS File Format". ResearcherID.com. Thomson Reuters. 2012. Archived from the original on 2017-07-07.
  4. "RIS Format Specifications". Reference Manager. The Thomson Corporation. 2001-02-14. Archived from the original on 2011-09-30.
  5. "RIS Format Specifications". Reference Manager. The Thomson Corporation. 2011-10-06. Archived from the original on 2012-05-26.
  6. "EndNote: Directions for implementing EndNote Direct Export". Knowledge. Support - Clarivate. June 28, 2022. Archived from the original on September 30, 2023.
  7. "Field Types and Tags: Page 2 of 2". RIS Format Specifications. February 14, 2001. p. 2. Archived from the original on July 26, 2010.
  8. "7.1. Writing RIS datasets". refdb handbook: covers version 0.9.6, Chapter 7. Data input. November 14, 2005. Retrieved 2023-10-01.
  9. Biblioteca Universitaria / Unibertsitateko Biblioteka; llzrimem (January 31, 2011). "ACCESS A RIS / Instrucciones para pasar registros de Access 2007 a RIS" (PDF). Universidad del País Vasco / Euskal Herriko Unibertsitatea (in English and Spanish). pp. 10–13. Archived (PDF) from the original on October 1, 2023.
  10. "Tag Definitions: Authors". RIS Format Specifications. July 7, 2004. p. 4. Archived from the original on July 26, 2010.
  11. "Tag Definitions: Year and Free Text Fields". RIS Format Specifications. July 7, 2004. p. 5. Archived from the original on July 26, 2010.
  12. larsgw (April 12, 2021). "RIS specification". Zotero Forums. Retrieved October 1, 2023.
  13. Eaton, Alf (July 18, 2013) [July 15, 2013]. "ris-tags.md: Reference Manager RIS file format". Retrieved October 1, 2023 via GitHub Gist.
  14. Melinn, Jennifer; Rodriguez, Cheryl (July 10, 2013). "EndNote: Directions for implementing EndNote Direct Export - EN RIS Documentation.xls". EndNote Desktop, Exporting. Thomson Scientific (published June 28, 2022). Archived from the original on October 1, 2023. Retrieved September 30, 2023 via Clarivate, hosted by Salesforce. Summarized at https://docs.google.com/spreadsheets/d/e/2PACX-1vTOqwg_HALSlMz_ykEJmhQ9Jrqld7MkjVvQ5CQSPRqm5RCudguZnlP3t3N2ax0DeTTI-CmtJ_tOw60n/pubhtml. Old version available in https://web.archive.org/web/20120717122530/http://refman.com/support/direct%20export.zip; the differences are: the "Bill" sheet was named "Bill, Unenacted Bill"; the "Dataset" sheet was named "Data File"; the "Interview", "Podcast", "Press Release", and "Sheet1" (a list of the type abbreviations and full names) sheets did not yet exist; and "M1" meaning "Issue" was not yet in the "Conference Paper" sheet. {{cite web}}: External link in |postscript= (help)CS1 maint: postscript (link)
  15. "RefWorks Tagged Format". RefWorks. n.d. [It was first archived on March 12, 2004, but has had some changes since then.] Archived from the original on October 22, 2019.
  16. "Importing a RIS File". Citavi 6 Manual. April 11, 2019. Retrieved October 1, 2023.
  17. "Comparison of the Medline (txt), Medline (xml), and RIS format". JabRef v5 GitBook. May 11, 2022. Retrieved October 1, 2023.
  18. Putnam, Chris (November 12, 2021). "lib/ristypes.c". Bibutils version 7.2. Archived from the original on October 1, 2023 via SourceForge.
  19. Putnam, Chris (November 12, 2021). "lib/risout.c". Bibutils version 7.2. Archived from the original on October 1, 2023 via SourceForge.
  20. Posthumus, Etienne (October 15, 2018). "bibserver/parserscrapers_plugins/RISParser.py". BibServer. Open Knowledge Foundation. Archived from the original on October 1, 2023 via GitHub.
  21. "Tag Definitions: Periodical and Publisher Tags". RIS Format Specifications. July 7, 2004. p. 8. Archived from the original on July 26, 2010.
  22. "Tag Definitions: Misc. Tags". RIS Format Specifications. July 7, 2004. p. 9. Archived from the original on July 26, 2010.
  23. "Tag Definitions: Title and Reference Type Tags". RIS Format Specifications. July 7, 2004. p. 3. Archived from the original on July 26, 2010.
  24. "RefWorks Tagged Format". RefWorks. Archived from the original on March 12, 2004.{{cite web}}: CS1 maint: unfit URL (link)
  25. "Tag Definitions: Periodical Tags". RIS Format Specifications. July 7, 2004. p. 7. Archived from the original on July 26, 2010.
  26. "Tag Definitions: Keywords and Reprint Status". RIS Format Specifications. July 7, 2004. p. 6. Archived from the original on July 26, 2010.
  27. Putnam, Chris (November 12, 2021). "lib/risin.c". Bibutils version 7.2. Archived from the original on October 1, 2023 via SourceForge.
  28. "Reference Type Field Names". RIS Format Specifications. February 14, 2001. p. 10. Archived from the original on July 26, 2010.
This article is issued from Wikipedia. The text is licensed under Creative Commons - Attribution - Sharealike. Additional terms may apply for the media files.