Difference between revisions of "Talk:CETAF Specimen Preview Profile (CSPP)"

From CETAF Identifiers Wiki
Jump to: navigation, search
m (Example with commented CSPP elements)
m (remarks on the CSPP Mathias Dillen 20200604: Q:Why do we recommend dc:created and not dwc:eventDate? A:I don’t know for sure, but reading the definition of dwc:eventDate …)
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
{{Alert box|content=For nested discussion you can use the <code><nowiki>:</nowiki></code> as first character for indenting texts and mark your comments by your signature <code><nowiki>~~~~</nowiki></code> (becomes replaced by the Wiki). ''Recommendation:'' add new topics on the top, not on the bottom.}}
 +
 +
__TOC__
 +
 +
 +
== A few remarks on the CSPP{{anchor|remarks on the CSPP Mathias Dillen 20200604}} ==
 +
 +
Reading through the profile, I have a few remarks ([[User:Mathias Dillen|Mathias Dillen]] 13:32, 4 June 2020‎ (CET)):
 +
 +
* kindOfMaterial / type: Shouldn't we use Dublin Core's controlled vocabulary for type (e.g. PhysicalObject)? And use dwc:basisOfRecord for PreservedSpecimen. There is less consensus for how to define what kind of specimen it is (e.g. herbarium sheet), but in {{abbr|MIDS}} the recommendation is to use dwc:preparations.
 +
*: Short question of understanding, what is MIDS ? (I have trouble understanding some less common abbreviations ;-) --[[User:Andreas Plank|Andreas Plank]] ([[User talk:Andreas Plank|talk]]) 12:08, 11 June 2020 (CEST)
 +
*:: Apologies. Minimum Information for Digital Specimens. [https://docs.google.com/document/d/1GKLVXs_vDqeRiAPxfhOg0J7KaxNmTS_n5Znl_DU3eks/ More info]. --[[User:Mathias Dillen|Mathias Dillen]] ([[User talk:Mathias Dillen|talk]]) 13:02, 15 June 2020 (CEST)
 +
* Why do we recommend dwc:fieldNumber and not dwc:recordNumber?
 +
* Why do we recommend dc:created and not dwc:eventDate? The latter is much more strongly connected to the gathering event, rather than the digital object.
 +
*: I don’t know for sure, but reading the definition of <tt>dwc:eventDate</tt> and reading the meaning of event (in [https://www.etymonline.com/word/event#etymonline_v_11707 etymonline.com]: “that which happens”) one has to determine the event type, I guess; so <tt>dwc:eventDate</tt> can be any event. And  <tt>dc:created</tt> is per definition «Date of creation of the resource» which I would interpret more as to belong to the herbarium sheet of paper that has been created. --[[User:Andreas Plank|Andreas Plank]] ([[User talk:Andreas Plank|talk]]) 13:49, 7 January 2021 (CET)
 +
 
== Relations of CETAF Specimen Preview Profile (CSPP) and expressed RDF somewhat baffling ==
 
== Relations of CETAF Specimen Preview Profile (CSPP) and expressed RDF somewhat baffling ==
  
 
From analysing returned RDF (e.g. http://id.snsb.info/snsb/collection/97112/153455/93009 accessed on 26th November 2019) we get the RDF, e.g. on Linux by
 
From analysing returned RDF (e.g. http://id.snsb.info/snsb/collection/97112/153455/93009 accessed on 26th November 2019) we get the RDF, e.g. on Linux by
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
wget  --quiet --header='Accept: application/rdf+xml'  --header='Content: application/rdf+xml'  --output-document="id.snsb.info⁄snsb⁄collection⁄97112⁄153455⁄93009.rdf" "http://id.snsb.info/snsb/collection/97112/153455/93009"
+
wget  --quiet --header='Accept: application/rdf+xml'  --header='Content-Type: application/rdf+xml'  --output-document="id.snsb.info⁄snsb⁄collection⁄97112⁄153455⁄93009.rdf" "http://id.snsb.info/snsb/collection/97112/153455/93009"
 
</syntaxhighlight>
 
</syntaxhighlight>
 
… and find in the RDF file:
 
… and find in the RDF file:
Line 22: Line 38:
  
 
I myself have difficulties to understand the CSPP proposal on one side and the mapping to the equivalent (classical) RDF on the other side, given no further documentation (yet). We should more clarify by example the relation of CSPP and classical RDF; or I have not understood it yet. --[[User:Andreas Plank|Andreas Plank]] ([[User talk:Andreas Plank|talk]]) 13:09, 26 November 2019 (CET)
 
I myself have difficulties to understand the CSPP proposal on one side and the mapping to the equivalent (classical) RDF on the other side, given no further documentation (yet). We should more clarify by example the relation of CSPP and classical RDF; or I have not understood it yet. --[[User:Andreas Plank|Andreas Plank]] ([[User talk:Andreas Plank|talk]]) 13:09, 26 November 2019 (CET)
 +
: {{done|reason=Improved documentation --[[User:Andreas Plank|Andreas Plank]] ([[User talk:Andreas Plank|talk]]) 10:50, 24 June 2020 (CEST)}}
  
 
== Example with commented CSPP elements ==
 
== Example with commented CSPP elements ==
  
Perhaps provide a plain RDF example and a XML example. Plain RDF example (note that & is not escaped):
+
Perhaps provide a plain RDF example and [[#XML example|a XML example]]. Plain RDF example (note that & is not escaped):
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
 
<rdf:RDF>
 
<rdf:RDF>
Line 94: Line 111:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Same example as XML (note the escaped <code>&amp;amp;</code>, you can expand the box ''on the right'')
+
{{Anchor|XML example}}Same example as XML (note the escaped <code>&amp;amp;</code>, you can expand the box ''on the right'')
 
<div class="mw-collapsible mw-collapsed" data-expandtext="Expand XML example" data-collapsetext="Collapse XML example">
 
<div class="mw-collapsible mw-collapsed" data-expandtext="Expand XML example" data-collapsetext="Collapse XML example">
 
<syntaxhighlight lang="xml" class="mw-collapsible-content">
 
<syntaxhighlight lang="xml" class="mw-collapsible-content">
Line 169: Line 186:
 
</syntaxhighlight>
 
</syntaxhighlight>
 
</div>
 
</div>
 +
: {{done|reason=Corrected documentation --[[User:Andreas Plank|Andreas Plank]] ([[User talk:Andreas Plank|talk]]) 10:50, 24 June 2020 (CEST)}}
 +
 +
[[Category: Discussion]]

Latest revision as of 13:52, 7 January 2021

For nested discussion you can use the : as first character for indenting texts and mark your comments by your signature ~~~~ (becomes replaced by the Wiki). Recommendation: add new topics on the top, not on the bottom.


A few remarks on the CSPP

Reading through the profile, I have a few remarks (Mathias Dillen 13:32, 4 June 2020‎ (CET)):

  • kindOfMaterial / type: Shouldn't we use Dublin Core's controlled vocabulary for type (e.g. PhysicalObject)? And use dwc:basisOfRecord for PreservedSpecimen. There is less consensus for how to define what kind of specimen it is (e.g. herbarium sheet), but in MIDS the recommendation is to use dwc:preparations.
    Short question of understanding, what is MIDS ? (I have trouble understanding some less common abbreviations ;-) --Andreas Plank (talk) 12:08, 11 June 2020 (CEST)
    Apologies. Minimum Information for Digital Specimens. More info. --Mathias Dillen (talk) 13:02, 15 June 2020 (CEST)
  • Why do we recommend dwc:fieldNumber and not dwc:recordNumber?
  • Why do we recommend dc:created and not dwc:eventDate? The latter is much more strongly connected to the gathering event, rather than the digital object.
     I don’t know for sure, but reading the definition of dwc:eventDate and reading the meaning of event (in etymonline.com: “that which happens”) one has to determine the event type, I guess; so dwc:eventDate can be any event. And dc:created is per definition «Date of creation of the resource» which I would interpret more as to belong to the herbarium sheet of paper that has been created. --Andreas Plank (talk) 13:49, 7 January 2021 (CET)

Relations of CETAF Specimen Preview Profile (CSPP) and expressed RDF somewhat baffling

From analysing returned RDF (e.g. http://id.snsb.info/snsb/collection/97112/153455/93009 accessed on 26th November 2019) we get the RDF, e.g. on Linux by

wget  --quiet --header='Accept: application/rdf+xml'  --header='Content-Type: application/rdf+xml'  --output-document="id.snsb.info⁄snsb⁄collection⁄97112⁄153455⁄93009.rdf" "http://id.snsb.info/snsb/collection/97112/153455/93009"

… and find in the RDF file:

<!-- … -->
    <rdf:Description rdf:about="http://id.snsb.info/snsb/collection/97112/153455/93009"><!-- OK -->
        <dc:title>Erysiphe cruciferarum Opiz ex L. Junell</dc:title><!-- OK -->
        <dwc:collectionCode>BSMeryscoll</dwc:collectionCode><!-- OK -->
        <dwc:collectionID>3</dwc:collectionID><!-- OK -->
        <dwc:datasetName>The Erysiphales Collection at the Botanische Staatssammlung München</dwc:datasetName><!-- OK -->
        <dc:relation>http://www.botanischestaatssammlung.de/DatabaseClients/BSMeryscoll/About.cfm</dc:relation><!-- OK -->
        <dwc:kindOfMaterial>PreservedSpecimen</dwc:kindOfMaterial><!-- baffling: who defines dwc:kindOfMaterial ?-->
        <dc:type>PreservedSpecimen</dc:type><!-- ?OK -->
    </rdf:Description>    
<!-- … -->

… which contains baffling RDF, because there is no definition of <dwc:kindOfMaterial>PreservedSpecimen</dwc:kindOfMaterial>, I can find—is there or is it yet to be defined somewhere the dwc:kindOfMaterial?

I myself have difficulties to understand the CSPP proposal on one side and the mapping to the equivalent (classical) RDF on the other side, given no further documentation (yet). We should more clarify by example the relation of CSPP and classical RDF; or I have not understood it yet. --Andreas Plank (talk) 13:09, 26 November 2019 (CET)

 Done: Improved documentation --Andreas Plank (talk) 10:50, 24 June 2020 (CEST)

Example with commented CSPP elements

Perhaps provide a plain RDF example and a XML example. Plain RDF example (note that & is not escaped):

<rdf:RDF>
  <!--This is metadata about this metadata document-->
  <rdf:Description rdf:about="http://herbarium.bgbm.org/data/rdf/B100068798">
    <dc:subject rdf:resource="http://herbarium.bgbm.org/object/B100068798"/>
    <dc:created>2019-11-11T15:41:25+01:00</dc:created>
  </rdf:Description>
  <!--This is metadata about this specimen-->
  <rdf:Description rdf:about="http://herbarium.bgbm.org/object/B100068798">
    <!--   CSPP element: title   -->
    <dc:title>Erysimum salangense Polatschek & Rech.f.</dc:title>
    <dc:description>A herbarium specimen of Erysimum salangense Polatschek & Rech.f. collected by Rechinger,K.H.</dc:description>
    <dc:creator>Rechinger,K.H.</dc:creator>
    <!--   CSPP element: collectionDate   -->
    <dc:created>1967-07-14</dc:created>
    <!--   CSPP element: kindOfMaterial   -->
    <dc:type>Specimen</dc:type>
    <!--   CSPP element: sourceLink   -->
    <dc:publisher>BGBM</dc:publisher>
    <dwc:materialSampleID>http://herbarium.bgbm.org/object/B100068798</dwc:materialSampleID>
    <dwc:basisOfRecord>Specimen</dwc:basisOfRecord>
    <dwc:collectionCode>B</dwc:collectionCode>
    <dwc:catalogNumber>B 10 0068798</dwc:catalogNumber>
    <!--   CSPP element: scientificNameCurrent   -->
    <dwc:scientificName>Erysimum salangense Polatschek & Rech.f.</dwc:scientificName>
    <!--   CSPP element: scientifcNameOriginal   -->
    <dwc:previousIdentifications>Erysimum salangense Polatschek & Rech.f.</dwc:previousIdentifications>
    <dwc:family>CRUCIFERAE</dwc:family>
    <dwc:genus>Erysimum</dwc:genus>
    <dwc:specificEpithet>salangense</dwc:specificEpithet>
    <dwc:country>Afghanistan</dwc:country>
    <!--   CSPP element: isoCountry   -->
    <dwc:countryCode>AF</dwc:countryCode>
    <dwc:locality>
      Afghanistan: NE- Afghanistan, Kathagan. Sar-i Hauz, in declivibus borealibus jugi Salang. substr. granit. Alt.: 2600 m. 14.07.1967, Leg.: K. H. Rechinger 37047.
    </dwc:locality>
    <!--   CSPP element: longitude   -->
    <dwc:decimalLongitude>69.033332824707</dwc:decimalLongitude>
    <!--   CSPP element: latitude   -->
    <dwc:decimalLatitude>35.366664886475</dwc:decimalLatitude>
    <dwc:eventDate>1967-07-14</dwc:eventDate>
    <dwc:recordNumber>37047</dwc:recordNumber>
    <!--   CSPP element: collectorName   -->
    <dwc:recordedBy>Rechinger,K.H.</dwc:recordedBy>
    <!--   CSPP element: collectorNumber   -->
    <dwc:fieldNumber>37047</dwc:fieldNumber>
    <dwciri:recordedBy rdf:resource="http://www.wikidata.org/entity/Q78738"/>
    <!--   CSPP element: webscaledImageLink   -->
    <dwc:associatedMedia rdf:resource="http://ww2.bgbm.org/herbarium/images/B/10/00/68/79/B_10_0068798.jpg"/>
    <!-- Experimental: This is a link to iiif data (see https://iiif.io) -->
    <dc:relation>
      <rdf:Description rdf:about="http://herbarium.bgbm.org/iiif/B100068798">
        <dc:identifier rdf:resource="http://herbarium.bgbm.org/iiif/B100068798"/>
        <dc:type rdf:resource="http://iiif.io/api/presentation/3#Manifest"/>
        <dc:subject rdf:resource="http://herbarium.bgbm.org/object/B100068798"/>
        <dc:format>application/ld+json</dc:format>
        <dc:description xml:lang="en">A IIIF resource for this specimen.</dc:description>
          <dc:created/>
        </rdf:Description>
    </dc:relation>
  </rdf:Description>
  <rdf:Description rdf:about="http://www.wikidata.org/entity/Q78738">
    <owl:sameAs rdf:resource="http://purl.oclc.org/net/edu.harvard.huh/guid/uuid/d5fea488-5786-4106-af90-396ef452c3aa"/>
    <owl:sameAs rdf:resource="https://viaf.org/viaf/100383596/"/>
  </rdf:Description>
</rdf:RDF>

Same example as XML (note the escaped &amp;, you can expand the box on the right)

<?xml version="1.0" encoding="utf-8"?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
    xmlns:dwc="http://rs.tdwg.org/dwc/terms/"
    xmlns:dc="http://purl.org/dc/terms/"
    xmlns:owl="http://www.w3.org/2002/07/owl/">
<rdf:RDF>
  <!--This is metadata about this metadata document-->
  <rdf:Description rdf:about="http://herbarium.bgbm.org/data/rdf/B100068798">
    <dc:subject rdf:resource="http://herbarium.bgbm.org/object/B100068798"/>
    <dc:created>2019-11-11T15:41:25+01:00</dc:created>
  </rdf:Description>
  <!--This is metadata about this specimen-->
  <rdf:Description rdf:about="http://herbarium.bgbm.org/object/B100068798">
    <!--   CSPP element: title   -->
    <dc:title>Erysimum salangense Polatschek &amp; Rech.f.</dc:title>
    <dc:description>A herbarium specimen of Erysimum salangense Polatschek &amp; Rech.f. collected by Rechinger,K.H.</dc:description>
    <dc:creator>Rechinger,K.H.</dc:creator>
    <!--   CSPP element: collectionDate   -->
    <dc:created>1967-07-14</dc:created>
    <!--   CSPP element: kindOfMaterial   -->
    <dc:type>Specimen</dc:type>
    <!--   CSPP element: sourceLink   -->
    <dc:publisher>BGBM</dc:publisher>
    <dwc:materialSampleID>http://herbarium.bgbm.org/object/B100068798</dwc:materialSampleID>
    <dwc:basisOfRecord>Specimen</dwc:basisOfRecord>
    <dwc:collectionCode>B</dwc:collectionCode>
    <dwc:catalogNumber>B 10 0068798</dwc:catalogNumber>
    <!--   CSPP element: scientificNameCurrent   -->
    <dwc:scientificName>Erysimum salangense Polatschek &amp; Rech.f.</dwc:scientificName>
    <!--   CSPP element: scientifcNameOriginal   -->
    <dwc:previousIdentifications>Erysimum salangense Polatschek &amp; Rech.f.</dwc:previousIdentifications>
    <dwc:family>CRUCIFERAE</dwc:family>
    <dwc:genus>Erysimum</dwc:genus>
    <dwc:specificEpithet>salangense</dwc:specificEpithet>
    <dwc:country>Afghanistan</dwc:country>
    <!--   CSPP element: isoCountry   -->
    <dwc:countryCode>AF</dwc:countryCode>
    <dwc:locality>
      Afghanistan: NE- Afghanistan, Kathagan. Sar-i Hauz, in declivibus borealibus jugi Salang. substr. granit. Alt.: 2600 m. 14.07.1967, Leg.: K. H. Rechinger 37047.
    </dwc:locality>
    <!--   CSPP element: longitude   -->
    <dwc:decimalLongitude>69.033332824707</dwc:decimalLongitude>
    <!--   CSPP element: latitude   -->
    <dwc:decimalLatitude>35.366664886475</dwc:decimalLatitude>
    <dwc:eventDate>1967-07-14</dwc:eventDate>
    <dwc:recordNumber>37047</dwc:recordNumber>
    <!--   CSPP element: collectorName   -->
    <dwc:recordedBy>Rechinger,K.H.</dwc:recordedBy>
    <!--   CSPP element: collectorNumber   -->
    <dwc:fieldNumber>37047</dwc:fieldNumber>
    <dwciri:recordedBy rdf:resource="http://www.wikidata.org/entity/Q78738"/>
    <!--   CSPP element: webscaledImageLink   -->
    <dwc:associatedMedia rdf:resource="http://ww2.bgbm.org/herbarium/images/B/10/00/68/79/B_10_0068798.jpg"/>
    <!-- Experimental: This is a link to iiif data (see https://iiif.io) -->
    <dc:relation>
      <rdf:Description rdf:about="http://herbarium.bgbm.org/iiif/B100068798">
        <dc:identifier rdf:resource="http://herbarium.bgbm.org/iiif/B100068798"/>
        <dc:type rdf:resource="http://iiif.io/api/presentation/3#Manifest"/>
        <dc:subject rdf:resource="http://herbarium.bgbm.org/object/B100068798"/>
        <dc:format>application/ld+json</dc:format>
        <dc:description xml:lang="en">A IIIF resource for this specimen.</dc:description>
          <dc:created/>
        </rdf:Description>
    </dc:relation>
  </rdf:Description>
  <rdf:Description rdf:about="http://www.wikidata.org/entity/Q78738">
    <owl:sameAs rdf:resource="http://purl.oclc.org/net/edu.harvard.huh/guid/uuid/d5fea488-5786-4106-af90-396ef452c3aa"/>
    <owl:sameAs rdf:resource="https://viaf.org/viaf/100383596/"/>
  </rdf:Description>
</rdf:RDF>
 Done: Corrected documentation --Andreas Plank (talk) 10:50, 24 June 2020 (CEST)