Scholarly article on topic 'LSID Tester, a tool for testing Life Science Identifier resolution services'

LSID Tester, a tool for testing Life Science Identifier resolution services Academic research paper on "Biological sciences"

Share paper
Academic journal
Source Code Biol Med
OECD Field of science

Academic research paper on topic "LSID Tester, a tool for testing Life Science Identifier resolution services"

Source Code for Biology and

Medidne BioMed Central

Open Access

Software review

LSID Tester, a tool for testing Life Science Identifier resolution services

Roderic DM Page

Address: Division of Environmental and Evolutionary Biology, Institute of Biomedical and Life Sciences, Graham Kerr Building, University of Glasgow, Glasgow G12 8QQ, UK

Email: Roderic DM Page -

Published: 18 February 2008

Source Code for Biology and Medicine 2008, 3:2 doi:I0.II 86/1751-0473-3-2

This article is available from: http://www.scfbm.Org/content/3/I/2

© 2008 Page; licensee BioMed Central Ltd. This is an Open Access article distributed under the terms of the Creative Commons Attribution License (, which permits unrestricted use, distribution, and reproduction in any medium, provided the original work is properly cited.

Received: 18 January 2008 Accepted: 18 February 2008


Background: Life Science Identifiers (LSIDs) are persistent, globally unique identifiers for biological objects. The decentralised nature of LSIDs makes them attractive for identifying distributed resources. Data of interest to biodiversity researchers (including specimen records, images, taxonomic names, and DNA sequences) are distributed over many different providers, and this community has adopted LSIDs as the identifier of choice.

Results: LSID Tester is a web application written in PHP. Given a LSID the application performs seven tests, reporting the results at each step. If all tests are successful the metadata associated with the LSID is displayed, and can be viewed in a range of formats.

Conclusion: The software provides a tool for testing a LSID resolution service.


A key prerequisite for integrating biological information from diverse sources is the use of globally unique identifiers (GUIDs) to consistently identify objects [1]. One approach to deploying GUIDs is to provide a central authority for assigning and resolving identifiers. This is the strategy adopted by many academic publishers through CrossRef [2], which manages Digital Object Identifiers (DOIs) [3] for journal articles. In some cases a field may be dominated by a single data provider which issues de-facto GUIDs, for example the genomics community uses GenBank accession numbers to identify molecular sequences. However, neither approach works well for the biodiversity community [4], which has large numbers of globally distributed data providers serving diverse kinds of information such as taxonomic names, specimen records, images, and DNA sequences. At the time of writing the Global Biodiversity Information Facility (GBIF) [5] lists some 214 biodiversity data providers, serving a

total of 41,139,985 records, mostly of museum specimens. After reviewing various options for GUIDs, the Biodiversity Information Standards (TDWG) organisation [6] has recommended the use of LSIDs.

Life Science Identifiers (LSIDs) were developed to provide globally unique identifiers for objects in biological databases [1]. Although within mainstream bioinformatics relatively few "early adopters" have deployed LSIDs [7], the biodiversity informatics community has adopted LSIDs as its GUID of choice [6]. Among the attractions are the distributed nature of the identifier (no central authority is required for registering or resolving identifiers), the low cost, and the convention that resolving a LSID returns metadata as RDF [8]. The later facilitates integrating information from multiple sources using tools being developed for the Semantic Web [9].

Figure 1 shows an example LSID. Each LSID is prefixed by "urn" indicating that the LSID is a Uniform Resource name (URN), "lsid" indicates that the identifier is resolved using the LSID protocol, then follow the authority, namespace, and identifier components. There may also be an optional revision component to indicate the version of the resource. The authority is a domain name that can be resolved by the Internet DNS (typically a domain name owned by the data provider), the namespace and identifier are specific to the data source which provides the resource. In this example the LSID is a taxo-nomic name in the uBio database [10]. Note that the uniqueness of the LSID is in part guaranteed by the use of Internet domain names, which are globally unique. Providing that the data source ensures that each combination of namespace and identifier is unique within that data source, the LSID itself will be a globally unique identifier. Given a LSID, client software can retrieve metadata and/or data identified by that LSID. Figure 2 shows the metadata corresponding to the LSID, which identifies a record in the uBio database for the taxonomic name Pternistis leucoscepus.

The widely distributed nature of biodiversity data has implications for deploying global identifiers. Providers are unlikely to run a single type of web server, nor are they likely to all use the same web application software. Consequently, there are multiple versions of LSID server software available, including Java, Perl, and .NET implementations [11]. Developers porting servers to new computer programming languages would benefit from having a tool available to test their implementation. Data providers implementing a LSID server would benefit from having a tool to test whether their installation is functioning correctly. The LSID Tester was developed with these two audiences in mind. It is a simple web-based applica-

tion that tests a LSID service and provides a detailed report on how well the service conforms to the LSID specification [12].


The LSID Tester is written in the PHP programming language, and makes use of the PEAR Net_DNS module [13] written by Eric Kilfoil for LSID resolution discovery. The application caches authority WSDL files and metadata for 24 hours. Metadata is displayed in alternative formats using XSL style sheets, including Oliver Becker's XML to HTML Verbatim Formatter [14]. Graphical displays of metadata use a RDF parser from ARC [15] and require GraphViz [16] to generate the graphs.

Results and Discussion LSID Resolution

A LSID client, such as LSID Tester, resolves a LSID in four steps. Firstly the client discovers the location of the service that can resolve the LSID, for example by querying the DNS service records to find the hostname and TCP/IP service port for the LSID authority. Given the LSID, querying the DNS for the SRV record for returns as the location of the LSID service.

Knowing the location of the LSID service, the client appends '/authority/' to the service location, and retrieves the authority WSDL file [17]. This file defines the LSID resolution service, including location and bindings. The LSID standard [12] defines bindings for SOAP, HTTP GET, and FTP. The HTTP GET binding is the mostly widely used, and is the only one the LSID Tester supports at present. For the LSID the HTTP GET binding is

Figure 1

A Life Science identifier. A LSID is prefixed with "urn:lsid", then follows the authority, namespace, and identifier components.


<rdf:Description rdf:about=""> <dc:identifier><:/dc:identifier> <dc:creator rdf:resource="" /> <dc:subject>Pternistis leucoscepus (Gray, GR) 1867</dc:subject> <ubio:taxonomicGroup>Aves</ubio:taxonomicGroup> <ubio:recordVersion>4</ubio:recordVersion> <ubio:canonicalName>Pternistis leucoscepus</ubio:canonicalName> <dc:title>Pternistis leucoscepus</dc:title> <dc:type>Scientific Name</dc:type> <ubio:lexicalStatus>Unknown (Default)</ubio:lexicalStatus> <gla:rank>Species</gla:rank>

<gla:vernacularName rdf:resource="" /> <gla:vernacularName rdf:resource="" /> <gla:vernacularName rdf:resource="" /> <gla:vernacularName rdf:resource="" /> <gla:vernacularName rdf:resource="" /> <gla:mapping rdf:resource="" />

<gla:mapping rdf:resource=";taxa=&amp;p_format=&amp;p_ifx=cbif&amp;p_lang=" />

<gla:hasBasionym rdf:resource="" />

<gla:objectiveSynonym rdf:resource="" />

<gla:objectiveSynonym rdf:resource="" />

<gla:objectiveSynonym rdf:resource="" />

<gla:objectiveSynonym rdf:resource="" />

<gla:objectiveSynonym rdf:resource="" />

<ubio:hasCAVConcept rdf:resource="" />

<ubio:hasCAVConcept rdf:resource="" />

<ubio:hasCAVConcept rdf:resource="" />

<ubio:hasCAVConcept rdf:resource="" />

<ubio:hasCAVConcept rdf:resource="" />

<ubio:hasCAVConcept rdf:resource="" />

<ubio:hasCAVConcept rdf:resource="" />

<ubio:hasCAVConcept rdf:resource="" />

<ubio:hasCAVConcept rdf:resource="" />

<ubio:hasCAVConcept rdf:resource="" />

<dcterms:bibliographicCitation>Sclater, W.L., Systema Avium ®thiopicarum, p. 91</dcterms:bibliographicCitation> </rdf:Description> </rdf:RDF>


LSID metadata. The metadata returned when the LSID is resolved. This LSID identifies a record in the uBio database for the taxonomic name Pternistis leucoscepus. Note that the RDF shown has been simplified by removing the namespace declarations, and abbreviating some URLs.

Given the authority WSDL, a LSID client uses its preferred protocol (SOAP, HTTP GET, FTP) to retrieve a second WSDL file (the service WSDL) that specifies how the metadata and/or data corresponding to the LSID can be retrieved. For the LSID 11815 metadata can be obtained via HTTP GET from

The client can now retrieve the metadata associated with the LSID by appending ? to this URL.

The LSID Tester performs seven main tests: 1. Is the LSID correctly formed?

2. Is the resolution service discoverable?

3. Can it retrieve the authority WSDL?

4. Does the authority WSDL define a HTTP GET binding for the service WSDL?

5. Can it retrieve the service WSDL?

6. Does the service WSDL define a HTTP GET binding for the metadata?

7. Can it retrieve the metadata for the LSID?

In addition, at step 5 it performs two additional tests. The LSID specification [12] lists error codes a LSID service should use. At test 5 the LSID Tester determines whether

Test 3: Authority WSDL

Tost Sa. Error handling


LSID Tester screenshot. An instance of LSID Tester resolving the LSID

the LSID service returns code 200 (MALFORMED_LSID) if supplied with a syntactically invalid LSID, and 201 (UNKNOWN_LSID) if supplied with a syntactically valid LSID with a different authority (i.e., a LSID for which the service is not the authority). At each step (unless a fatal error is encountered) the LSID Tester web page displays the result of the test (Fig. 3). For each HTTP GET call the HTTP headers can be viewed, which can provide useful debugging information (for example, the user can see the HTTP status codes returned by the LSID service). If test 7 succeeds, the metadata associated with the LSID is displayed. Several alternative views are available, such as a formatted XML dump, a raw XML dump, and a graphical display of the metadata. The application also displays a link to the W3C RDF Validation Service [18] so that the user can validate the RDF metadata.


LSID Tester is a web application for testing LSID resolution services. Given a LSID the application performs seven tests, reporting the results at each step. If all tests are successful the metadata associated with the LSID is displayed, and can be viewed in a range of formats.

Availability and requirements

Project Name: LSID Tester

Project Home Page: Source code is available from http://, and an instance of the application can be viewed at http://linnaeus.zool

3. The Digital Object Identifier system []

4. Sarkar IN: Biodiversity informatics: organizing and linking information across the spectrum of life. Briefings in Bioinformat-ics 2007, 8:347-357.

5. Global Biodiversity Information Facility []

6. Biodiversity Information Standards (TDWG) [http://]

7. Martin S, Hohman MM, Liefeld T: The impact of Life Science Identifier on informatics data. Drug Discovery Today 2005, 10:1566-1572.

8. Resource Description Framework (RDF) [ RDF/]

9. Page RDM: Taxonomic names, metadata, and the Semantic

Web. Biodiversity Informatics 2006, 3: [ index.php/jbi/article/view/25].

10. Universal Biological Indexer and Organizer [http://]

11. The LSID (Life Sciences Identifier) Project [http://]

12. The Object Management Group: Life Sciences Identifiers Specification, Version 1.0 2004 [ doc?formal/04-l 2-01 ].

13. PEAR Net_DNS [ DNS]

14. Oliver's XSLT page [ ~obecker/XSLT/]

15. ARC: RDF classes for PHP []

16. Graphviz - Graph Visualization Software [http://www.graph]

17. Web Services Description Language (WSDL) 1.1 [http:// R/wsdl]

18. W3C RDF Validation Service [ tor/]

Operating System: Mac OS X, Linux Programming Language: PHP Other Requirements: Web server, GraphViz License: GNU General Public License version 2 Any restrictions to use by non-academics: None Competing interests

The author(s) declare that they have no competing interests.


This work was partly funded by BBSRC grant BB/C0043I0/I. I thank early users of the LSID Tester for feedback, especially Damian Barnier and Nicky Nicolson, and the two anonymous reviewers for catching some errors in the original text.


1. Clark T, Martin S, Liefeld T: Globally distributed object identification for biological knowledgebases. Briefings in Bioinformatics 2004, 5(l):59-70.

2. CrossRef []

Publish with BioMecl Central and every scientist can read your work free of charge

"BioMed Central will be the most significant development for disseminating the results of biomedical research in our lifetime." Sir Paul Nurse, Cancer Research UK

Your research papers will be:

• available free of charge to the entire biomedical community

• peer reviewed and published immediately upon acceptance

• cited in PubMed and archived on PubMed Central

• yours — you keep the copyright

Submit your manuscript here: f BioMedcentral ^