Difference between revisions of "User:Andreas Plank/Main Page"

From CETAF Identifiers Wiki
Jump to: navigation, search
m
m (rearrange Main Page and separate Handbook to another page)
Line 26: Line 26:
 
Additionally, the stable identifiers enable new applications in the semantic web domain. An example for this is the Biology Pilot. The [https://www.bgbm.org/ Botanic Garden and Botanical Museum Berlin], [https://www.plantentuinmeise.be/en/home/ Meise Botanic Garden] and other collections annotated thousands of specimens with the [https://kiki.huh.harvard.edu/databases/botanist_index.html HUH] and [https://www.wikidata.org/wiki/Wikidata:Main_Page WikiData] IDs of their collectors. The CETAF Stable Identifiers of the annotated specimens are available on [https://www.gbif.org/ GBIF] and a server is crawling the identifiers to organize the RDF information in a Blaze Graph triple store. This graph enables us to search for specimen by their collector {{abbr|ID}} of {{abbr|HUH}} or WikiData, which is invariant to the different spelling variants the individual institutions may be using. The query will return all relevant specimens available in the joined set of specimens regardless of their origin institution. If the number of institutions using stable identifiers grows and the amount of machine readable annotations increases, this technology could be used to basically create a “google for specimens”.
 
Additionally, the stable identifiers enable new applications in the semantic web domain. An example for this is the Biology Pilot. The [https://www.bgbm.org/ Botanic Garden and Botanical Museum Berlin], [https://www.plantentuinmeise.be/en/home/ Meise Botanic Garden] and other collections annotated thousands of specimens with the [https://kiki.huh.harvard.edu/databases/botanist_index.html HUH] and [https://www.wikidata.org/wiki/Wikidata:Main_Page WikiData] IDs of their collectors. The CETAF Stable Identifiers of the annotated specimens are available on [https://www.gbif.org/ GBIF] and a server is crawling the identifiers to organize the RDF information in a Blaze Graph triple store. This graph enables us to search for specimen by their collector {{abbr|ID}} of {{abbr|HUH}} or WikiData, which is invariant to the different spelling variants the individual institutions may be using. The query will return all relevant specimens available in the joined set of specimens regardless of their origin institution. If the number of institutions using stable identifiers grows and the amount of machine readable annotations increases, this technology could be used to basically create a “google for specimens”.
  
−
== How can I implement CETAF Stable Identifiers for my collection? ==
+
== Documentation and Handbook for CETAF Identifiers ==
−
The CETAF Stable Identifiers can be implemented in three levels. They are described in detail in [http://herbal.rbge.info/md.php?q=documentation herbal.rbge.info’s documentation]. Following conditions have to be met to reach the corresponding implementation levels:
+
  
−
'''Level 1'''
+
Please read [[User:Andreas Plank/CETAF Stable Identifier Handbook|<span style="color:red" title="Will be replaced later to the correct link (AP 20200601)">User:Andreas Plank/</span>CETAF Stable Identifier Handbook]]
−
* you assigned a stable URI to each object of your collection, which will be never changed and preferably follows the [https://wiki.pro-ibiosphere.eu/wiki/Best_practices_for_stable_URIs best practices for stable URIs]
+
−
* there exists a human-readable representation (web-page) for each of your collection objects
+
−
* a user trying to access a collection object by typing the stable URI of it into a web-browser will be redirected to the human-readable representation (web-page) of the object (you can test this by using the [http://herbal.rbge.info/search.php CETAF URI Tester])
+
−
'''Level 2'''
+
−
* you reached level 1
+
−
* there exists a machine-readable RDF metadata record for each of your collection objects
+
−
* a machine trying to access a collection object via its identifier with '<code>application/rdf+xml</code>' header will be redirected to the objects machine-readable RDF metadata record (you can test this by using the [http://herbal.rbge.info/search.php CETAF URI Tester])
+
−
'''Level 3'''
+
−
* you reached level 2
+
−
* the machine-readable RDF metadata record of each of your collection objects encodes application specific data (e.g. is compliant to the [[CSPP|CETAF Specimen Preview Profile—CSPP]])
+
−
 
+
−
=== HTTP vs. HTTPS versions of CETAF {{abbr|URIs}} ===
+
−
 
+
−
As far as the Semantic web is concerned ''<nowiki>http://xyz</nowiki>'' and ''http<b>s</b>://xyz'' are different things because they are different {{abbr|URIs}}. The recommendation for new implementations should be just to use HTTPS. If you have only HTTP or HTTPS versions, ''or'' want to change it you should take notice of the following:
+
−
 
+
−
{| class="booktable"
+
−
|-
+
−
! HTTP  !! HTTPS
+
−
|-
+
−
| You
+
−
* have issued ''only HTTP'' versions of CETAF URIs and want to keep it that way
+
−
* have nothing to add technically, just have the usual 303 HTTP redirect to RDF or HTML resources in place
+
−
|You
+
−
* have issued ''only HTTPS'' versions of CETAF URIs
+
−
* don’t need to resolve then HTTP if you have never issued any, because they aren’t out there to be resolved.
+
−
|-
+
−
! style="text-align:center;" colspan="2" | Want to change HTTP to HTTPS
+
−
|-
+
−
| colspan="2" | You
+
−
* have issued HTTP versions of CETAF URIs but want to change to HTTPS
+
−
* have to keep resolving with a 303 redirect to HTTPS of the RDF or HTML resources. The RDF should contain an <code>owl:sameAs</code> assertion linking the HTTP and HTTPS versions of the {{abbr|URI}}, therefore only minor configure stuff for providers and transparent for users.
+
−
* could change to telling people to cite HTTPS rather than HTTP for your specimens but it shouldn’t matter too much as these things are linked together. The recommendation would be to cite as HTTPS if you have it implemented as at some point in the future a client may refuse to trust even a redirect from an HTTP URI (which is a bit paranoid but may happen).
+
−
|}
+
−
 
+
−
== Publishing CETAF IDs to {{abbr|GBIF}} ==
+
−
If your institution is using CETAF IDs and yout want them (and potential Specimen RDF) to be included into the CETAF Specimen Catalogue, they need to be used as {{abbr|GUIDs}} in the specimen data fed to GBIF. As described in [[CETAF Specimen Catalogue]], the GBIF Index is used to discover CETAF IDs.
+
−
* If DarwinCore is used, the IDs must be mapped to [http://rs.tdwg.org/dwc/terms/occurrenceID occurrence ID].
+
−
* For {{abbr|ABCD}}, the concept [https://terms.tdwg.org/wiki/abcd2:UnitGUID UnitGUID] should be used.
+
−
 
+
−
== How can I discover specimens with CETAF IDs and corresponding {{abbr|LOD}}? ==
+
−
You can discover specimens of institutions of the Stable Identifiers Implementers Group by using the [[CETAF Specimen Catalogue]] maintained at the {{abbr|BGBM}}, which offers a web service for getting a list of valid CETAF IDs. For implementers of level 2, who provide {{abbr|RDF}} representations of their specimens, a cache triple store with a {{abbr|SPARQL}} access point will be available soon.
+
  
 
== Useful Links ==
 
== Useful Links ==
−
* [http://wiki.pro-ibiosphere.eu/wiki/Best_practices_for_stable_URIs Best practices for stable URIs]
+
* [https://wiki.pro-ibiosphere.eu/wiki/Best_practices_for_stable_URIs Best practices for stable URIs (wiki.pro-ibiosphere.eu)]
 
* [[CSPP|CETAF Specimen Preview Profile (CSPP)]]
 
* [[CSPP|CETAF Specimen Preview Profile (CSPP)]]
 
* [https://git.bgbm.org/cetaf/stableidentifiernegotiation Source code and example documents]
 
* [https://git.bgbm.org/cetaf/stableidentifiernegotiation Source code and example documents]
−
* [http://herbal.rbge.info/ CETAF URI Tester]
+
* [http://herbal.rbge.info/ CETAF URI Tester (herbal.rbge.info)]
 
* [[Standards_compliance_dashboard|The Standards Compliance Dashboard]]
 
* [[Standards_compliance_dashboard|The Standards Compliance Dashboard]]
  

Revision as of 14:41, 2 June 2020

CETAF ISTC Stable Identifier Initiative

The Stable Identifiers of the Consortium of European Taxonomic Facilities (CETAF) are globally unique, consistent and reliable identifiers for specimens in natural and botanical collections. These identifiers are used in the world wide web to redirect users and systems to images, websites and metadata of the physical objects and to integrate them with the semantic web.

Example for the syntax of a CETAF Stable Identifier.

How do CETAF Stable Identifier look like?

The CETAF identifier system is based on HTTP-URIs and Linked Data principles. It is simple and future-proof. Each collection object as well as its associated information resources (e.g. multimedia, RDF, webpages) are identified by stable HTTP-URIs that will never change. The URI Syntax for the objects is chosen and maintained by the institution owning them. This flexibility is one of the main advantages of the CETAF Stable Identifier system as it allows e.g. to include branding and local scope identifiers into the CETAF Stable Identifier URI. There are however some best practices for stable URIs. Examples are:

http://herbarium.bgbm.org/object/B100277113

http://www.botanicalcollections.be/specimen/BR0000005516339

http://data.rbge.org.uk/herb/E00421509

Resolving URI-based collection identifiers using standard HTTP-redirection mechanisms.

How are CETAF Stable Identifiers resolved?

A CETAF Stable Identifier allows the access of information about the corresponding collection object in various ways. If a human user tries to access a collection object by typing it’s CETAF Stable Identifier into a web-browser, he will be redirected to a human-readable representation (e.g. html web-page) of it. If a software-system tries to access the collection object via the same identifier, it will be redirected to a machine-processable RDF-encoded metadata record. The identifier is therefore integrated with the semantic web and can also be used in other RDF representations to link to the belonging collection object.

What can CETAF Stable Identifiers be used for?

As described above, CETAF Identifiers can first of all be used to redirect users and systems to images, websites and metadata of the physical objects they belong to. They can also be used to precisely reference specimens needed in scientific studies and serve as basis for data retrieval, integration and reproducibility of data experiments. Additionally, the stable identifiers enable new applications in the semantic web domain. An example for this is the Biology Pilot. The Botanic Garden and Botanical Museum Berlin, Meise Botanic Garden and other collections annotated thousands of specimens with the HUH and WikiData IDs of their collectors. The CETAF Stable Identifiers of the annotated specimens are available on GBIF and a server is crawling the identifiers to organize the RDF information in a Blaze Graph triple store. This graph enables us to search for specimen by their collector ID of HUH or WikiData, which is invariant to the different spelling variants the individual institutions may be using. The query will return all relevant specimens available in the joined set of specimens regardless of their origin institution. If the number of institutions using stable identifiers grows and the amount of machine readable annotations increases, this technology could be used to basically create a “google for specimens”.

Documentation and Handbook for CETAF Identifiers

Please read User:Andreas Plank/CETAF Stable Identifier Handbook

Useful Links

Further reading

Meetings

Retrieved from "https://cetafidentifiers.biowikifarm.net/id/index.php?title=User:Andreas_Plank/Main_Page&oldid=488"