{"id":10972,"date":"2013-07-31T10:51:29","date_gmt":"2013-07-31T09:51:29","guid":{"rendered":"http:\/\/www.ch.imperial.ac.uk\/rzepa\/blog\/?p=10972"},"modified":"2013-07-31T10:51:29","modified_gmt":"2013-07-31T09:51:29","slug":"the-amsterdam-manifesto-on-data-citation-principles","status":"publish","type":"post","link":"https:\/\/www.rzepa.net\/blog\/?p=10972","title":{"rendered":"The Amsterdam Manifesto on Data Citation Principles"},"content":{"rendered":"
\n

The Amsterdam manifesto<\/a>\u00a0espouses the principles of citable open data. It is a short document, and it is worth re-stating its eight points here:<\/p>\n

    \n
  1. Data should be considered citable products of research.<\/em><\/li>\n
  2. Such data should be held in persistent public repositories.<\/em><\/li>\n
  3. If a publication is based on data not included with the article, those data should be cited in the publication.<\/em><\/li>\n
  4. A data citation in a publication should resemble a bibliographic citation and be located in the publication\u2019s reference list.<\/em><\/li>\n
  5. Such a data citation should include a unique persistent identifier (a DataCite DOI recommended, or other persistent identifiers already in use within the community).<\/em><\/li>\n
  6. The identifier should resolve to a page that either provides direct access to the data or information concerning its accessibility. Ideally, that landing page should be machine-actionable to promote interoperability of the data.<\/em><\/li>\n
  7. If the data are available in different versions, the identifier should provide a method to access the previous or related versions.<\/em><\/li>\n
  8. Data citation should facilitate\u00a0attribution of credit to all contributors.<\/em><\/li>\n<\/ol>\n

    The manifesto itself is dated\u00a0\u00a020 March 2013, but the principles above go back far earlier, and most of the articles above have been implemented in this blog for a little while now. But its best illustrated with an example[1]<\/a><\/span>. Here I have used the excellent wordpress extension Kcite<\/a>\u00a0to adhere to points 1-5 and 8<\/strong> above. Point 6<\/strong> is the most interesting perhaps, and it is illustrated below. If you click on the graphic, it will load the log file associated with the calculation described in the previous post<\/a> to convert the data to a rotatable 3D model, using Jmol.<\/p>\n

    \"Click

    Click to load from Figshare<\/p><\/div>\n

    This actually represents a departure from how I normally invoke data on this blog. I have hitherto done it by uploading the data to the WordPress uploads directory (it is thus in effect a local copy of the data). Here in this post I have not done that; it’s coming directly from the citable data repository, using e.g.<\/em><\/p>\n

    onclick=\"jmolInitialize('..\/Jmol\/',true);jmolSetAppletColor('white');jmolApplet([500,500],'load http:\/\/files.figshare.com\/1134372\/logfile.log;frame 27;vectors on;vectors 4;vectors scale 5.0; color vectors orange; vibration 10;animation mode loop;');\"<\/code><\/p>\n

    Well, almost. The URL of the actual dataset (http:\/\/files.figshare.com\/1134372\/logfile.log<\/code>) is derived from the doi (10.6084\/m9.figshare.757728) by an internal process which has no exposed algorithm. As it happens, the DSpace digital repository[2]<\/a><\/span> is a bit better in this regard.<\/p>\n

    \"Click

    Click to load from DSpace<\/p><\/div>\n

    This is loaded using<\/p>\n

    https:\/\/spectradspace.lib.imperial.ac.uk:8443\/dspace\/bitstream\/handle\/10042\/24916\/logfile.log;<\/code><\/p>\n

    which is directly derived from the handle itself (although again that algorithm has to be worked out by a human).<\/p>\n

    Point 7<\/strong> above is also implemented (sort of). If you look at the Figshare repository, you will notice an additional link there which points to the Dspace repository. As it happens, the two datasets are identical (they are not different versions) and these semantics are currently NOT handled well. You could probably work this out from the date stamps of the two depositions (which are respectively\u00a0Published on\u00a029 Jul 2013 – 05:58 (GMT)<\/strong> and\u00a02013-07-29T05:58:11Z<\/strong> for Figshare and DSpace respectively).\u00a0<\/p>\n

    Whereas the Amsterdam manifesto is here implemented on a blog post, I think the grander aspiration is that the principles are to be followed in ALL scientific publications. We are some way away yet from achieving this. But watch this space for an upcoming example!\u00a0<\/p>\n

    So can I urge all scientists who care about data to promulgate the principles of the Amsterdam manifesto, and wherever possible to practice what they preach!\u00a0<\/p>\n

    References<\/h2>\n
    1. H.S. Rzepa, \"Gaussian Job Archive for ClF3\", 2013. https:\/\/doi.org\/10.6084\/m9.figshare.757728<\/a>\n\n<\/li>\n
    2. \"Cl 1 F 3\", 2013. http:\/\/hdl.handle.net\/10042\/24916<\/a>\n\n<\/li>\n<\/ol>\n\n<\/div> ","protected":false},"excerpt":{"rendered":"

      The Amsterdam manifesto\u00a0espouses the principles of citable open data. It is a short document, and it is worth re-stating its eight points here: Data should be considered citable products of research. Such data should be held in persistent public repositories. If a publication is based on data not included with the article, those data should […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[3],"tags":[1111,1116,1102,1117,1118],"class_list":["post-10972","post","type-post","status-publish","format-standard","hentry","category-chemical-it","tag-amsterdam","tag-exposed-algorithm","tag-opendata","tag-rotatable-3d-model","tag-using-jmol"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/p1gPyz-2QY","jetpack_likes_enabled":true,"_links":{"self":[{"href":"https:\/\/www.rzepa.net\/blog\/index.php?rest_route=\/wp\/v2\/posts\/10972","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.rzepa.net\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.rzepa.net\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.rzepa.net\/blog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.rzepa.net\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=10972"}],"version-history":[{"count":0,"href":"https:\/\/www.rzepa.net\/blog\/index.php?rest_route=\/wp\/v2\/posts\/10972\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.rzepa.net\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=10972"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.rzepa.net\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=10972"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.rzepa.net\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=10972"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}