DOI

From OSGeo
Revision as of 03:20, 19 March 2024 by Gisix (talk | contribs) (→‎GDAL)
Jump to navigation Jump to search

Digital Object Identifiers (DOI)

Scope

  • This wiki page summarises relevant facts about DOI and related persistent Identifiers (PID) for the OSGeo communities.
  • A DOI is a persistent identifier (PID).
  • More infomation about PID for OSGeo is available here in the wiki

Useful background information


Howto information for GitHub Repo maintainers (source Zenodo FAQ)

My organizational repository does not show up on the GitHub list

"In order to see and archive your organizational repositories on Zenodo you will need to have "Admin" permissions on said repository, either as an Admin of the organization or an Admin of one of your organization's repositories. Additionally, please make sure that the OAuth application on GitHub is granting permissions not only to your personal repositories but also to your organizational ones - to verify that go to your GitHub OAuth settings in your profile, and click on the Zenodo application to see more details. Make sure that Zenodo is given access (green tick) to your organization under "Organization access".

After that, navigate to your Zenodo GitHub settings page and click the "Sync now" button at the top."

I made a GitHub release, but it does not show up on Zenodo.

"Make sure the repository was enabled before the release was made, otherwise feel free to contact ZENODO."

Is it possible to archive a GitHub repository, before it was enabled on Zenodo?

"Only the repositories which were enabled before a release was made will be archived automatically. If you want to archive some of your old releases, you can always download a release ZIP from GitHub and upload it to Zenodo using our web interface as a regular upload."

How to change the default metadata for my GitHub releases?

"You can include metadata in a .zenodo.json file at the root of your GitHub repository. This file's contents should be in line with the Zenodo deposit metadata schema and will be used to update the metadata from future GitHub releases. For more information on how to create a .zenodo.json file, you can have a look at our GitHub integration documenation."

Do you support other software metadata files, like CITATION.cff or codemeta.json?

"Part of our plans and ongoing work is to take into account or improve our integration of other software metadata schemas such as the Citation File Format (CFF) and CodeMeta. We are working closely with our users and scholarly software and citation communities to figure out exactly when, in what form, and how all these different metadata schemas and their files will be integrated into Zenodo."

How does a CITATION.cff file affect the metadata of my GitHub release?

"When we find a CITATION.cff file in your GitHub repository's root folder, we make a best-effort attempt at parsing Zenodo-compatible metadata from it. For backwards-compatibility, if you have a .zenodo.json file in the repository, only the .zenodo.json's metadata will be taken into account. Of course, any existing valid CITATION.cff file will still be used to display the citation box on the GitHub repository page, but will not affect in any way the metadata we extract for your published release Zenodo record."

Do you support versioning for already existing records?

"Yes. However, for uploads published before the 30th of May 2017, you have to first upgrade your record to support versioning. This is done by clicking the “Upgrade to versioned record” button on the record page.

IMPORTANT If you have previously uploaded multiple versions of an upload as individual records on Zenodo, then DO NOT click the button to upgrade your record with versioning support. Please contact us so we can link the records under one versioning scheme.

Clicking the “Upgrade to versioned record” button on any of the records you would like to link, will irreversibly register them as individually-versioned records.

If you used the GitHub integration to archive your software on Zenodo, then we have already migrated and linked your records to support versioning."

Usage examples for people writing articles

DOI

How to include a DOI-based reference to a LaTEX/Overleaf document.

BEWARE: As of now (20230327) it remains to be confirmed that DOI-tags in citations work without the https://doi.org-header. This might (just) reuslt in human readable information, but not machine-readable.

Publication DOI

@article{Chen_2003_Giants, title={On the Shoulders of Giants}, url={\url{https://doi.org/10.1007/978-1-4471-0051-5_5}}, DOI={10.1007/978-1-4471-0051-5_5}, journal={Mapping Scientific Frontiers: The Quest for Knowledge Visualization}, publisher={Springer London}, author={Chen, Chaomei}, year={2003}, pages={135–166} }

Video DOI

@article{Inman_1987, title={GRASS}, url={https://av.tib.eu/media/12963}, DOI={10.5446/12963}, abstractNote={Video presentation explaining the features and capabilities of this computer-based mapping system.}, publisher={Moving Pictures, US Army Construction Engineering Research Laboratory}, author={Inman, Roger J.}, year={1987}, language={en} }

Software Concept DOI (a reference to a software project as a whole)

@article{GRASS_CONCEPT_DOI, title={OSGeo/grass: GRASS GIS 8.2.0}, url={https://zenodo.org/record/5176030}, DOI={10.5281/ZENODO.5176030}, abstractNote={ .. CONTENT OMMITTED FOR BREVITY ..}, year={2022}, month={Jun} }

Software Version DOI (a reference to a particular software release)

@article{QGIS_Contributors_2022, title={QGIS}, url={https://doi.org/10.5281/zenodo.5869837}, DOI={10.5281/ZENODO.5869837}, publisher={Zenodo}, author={QGIS Contributors}, year={2022}, month={Jan} }



Added-value services based on DOI


DOI available for OSGeo Projects

OSGeo Project DOI First minted Citation example Integration Status
actinia https://doi.org/10.5281/zenodo.5879231 2022 Springer Handbook of Geographic Information (2022) automated
GDAL https://doi.org/10.5281/zenodo.5884351 2022 Nature: Scientific data (2023) automated
GeoMoose https://doi.org/10.5281/zenodo.7976084 2023 tbd tbd
Geopaparazzi https://doi.org/10.5281/ZENODO.5881915 2022 Springer Handbook of Geographic Information (2022) tbd
GeoServer https://doi.org/10.5281/zenodo.5854561 2022 Springer Handbook of Geographic Information (2022) tbd
GeoTools https://doi.org/10.5281/zenodo.5854653 2022 Springer Handbook of Geographic Information (2022) tbd
GMT https://doi.org/10.5281/zenodo.3407865 2019 Springer Handbook of Geographic Information (2022) tbd
GRASS GIS https://doi.org/10.5281/zenodo.5176030 2021 Springer Handbook of Geographic Information (2022) automated
gvSIG https://doi.org/10.5281/zenodo.5849091 2022 Springer Handbook of Geographic Information (2022) manual upload
Hortonmachine https://doi.org/10.5281/ZENODO.5881778 2022 Springer Handbook of Geographic Information (2022) tbd
istSOS https://doi.org/10.5281/zenodo.5888498 2022 tbd manual
Mapbender https://doi.org/10.5281/zenodo.5887014 2022 tbd tbd
MapServer https://doi.org/10.5281/zenodo.5842012 2021 Springer Handbook of Geographic Information (2022) tbd
MOSS https://doi.org/10.5281/zenodo.5140318 2022 Springer Handbook of Geographic Information (2022) automated
OSGeoLive https://doi.org/10.5281/zenodo.5884641 2022 Springer Handbook of Geographic Information (2022) tbd
OSGeoLive Documentation https://doi.org/10.5281/zenodo.5884859 2022 Springer Handbook of Geographic Information (2022) tbd
PostGIS https://doi.org/10.5281/zenodo.5879631 2021 Springer Handbook of Geographic Information (2022) manual upload
PROJ https://doi.org/10.5281/zenodo.5884394 2022 MDPI: Remote sensing (2022) automated
pycsw https://doi.org/10.5281/zenodo.7839119 2023 tbd automated
pygeoapi https://doi.org/10.5281/zenodo.7602922 2022 tbd automated
QGIS https://doi.org/10.5281/zenodo.5869837 2022 AGU:Geochemistry, Geophysics, Geosystems (2022) manual upload
rasdaman https://doi.org/10.5281/zenodo.1040170 2017 Springer Handbook of Geographic Information (2022) manual upload
SMASH https://doi.org/10.5281/zenodo.5882070 2022 Springer Handbook of Geographic Information (2022) tbd
OSGeo projects with DOI 23


<Add your project DOI here, while maintaining alphabetical order>

DOI-based Citations of OSGeo Projects in Scientific Literature

The following citation listings for OSGeo projects are curated both manually and using automated data-harvesting from CrossRef. The list is currently updated annually. This listing is not complete. The total number of scientific publications referencing OSGeo projects by their DOI is most likely much larger. Publications such as FOSS4G Proceedings in the The International Archives of the Photogrammetry, Remote Sensing and Spatial Information Sciences are currently not referenced by CrossRef and must be added manually.

actinia

2022

GDAL

Gdal DOI-based Citations
Date Type Publisher Journal Title DOI Source
2024-01-23 journal_article American Geophysical Union (AGU) Earth and Space Science Mapping Daily Air Temperature Over the Hawaiian Islands From 1990 to 2021 via an Optimized Piecewise Linear Regression Technique https://doi.org/10.1029/2023EA002851 Source: Crossref
2024-01-02 journal_article Elsevier BV Ecological Indicators New approach to assess forest fragmentation based on multiscale similarity index https://doi.org/10.1016/j.ecolind.2023.111530 Source: Crossref
2024-01-02 journal_article American Geophysical Union (AGU) GeoHealth Premature Deaths Due To Heat Exposure: The Potential Effects of Neighborhood‐Level Versus City‐Level Acclimatization Within US Cities https://doi.org/10.1029/2023GH000970 Source: Crossref
2023-12-19 journal_article American Geophysical Union (AGU) Earth and Space Science High‐Resolution Maps of Near‐Surface Permafrost for Three Watersheds on the Seward Peninsula, Alaska Derived From Machine Learning https://doi.org/10.1029/2023EA003015 Source: Crossref
2023-10-20 journal_article MDPI AG Sensors Comparing NISAR (Using Sentinel-1), USDA/NASS CDL, and Ground Truth Crop/Non-Crop Areas in an Urban Agricultural Region https://doi.org/10.3390/s23208595 Source: Crossref
2023-07-29 journal_article Springer Science and Business Media LLC Scientific Reports First estimates of fine root production in tropical peat swamp and terra firme forests of the central Congo Basin https://doi.org/10.1038/s41598-023-38409-x Source: Crossref
2022-06-24 book_content Springer Science and Business Media LLC Springer Handbook of Geographic Information Open Source – GIS https://doi.org/10.1007/978-3-030-53125-6_30 Source: Crossref
2023-04-19 journal_article Geomatik Geomatik Yersel referans verilerinin doğruluğunun çok zamanlı Sentinel-2 uydu görüntüleri ile araştırılması: Arpa ve Buğday örneği https://doi.org/10.29128/geomatik.1210252 Source: Crossref
2023-03-28 journal_article Wiley Crop Science Endemic crop wild relatives in Chile towards the end of the 21st century: Protected areas and agricultural expansion https://doi.org/10.1002/csc2.20962 Source: Crossref
2023-03-17 journal_article IOP Publishing Environmental Research Communications Validation of FABDEM, a global bare-earth elevation model, against UAV-lidar derived elevation in a complex forested mountain catchment https://doi.org/10.1088/2515-7620/acc56d Source: Crossref
2023-01-20 journal_article Springer Science and Business Media LLC Scientific Data A 1.2 Billion Pixel Human-Labeled Dataset for Data-Driven Classification of Coastal Environments https://doi.org/10.1038/s41597-023-01929-2 Source: Crossref
2022-11-08 journal_article MDPI AG Remote Sensing Assessing Changes in Boreal Vegetation of Kola Peninsula via Large-Scale Land Cover Classification between 1985 and 2021 https://doi.org/10.3390/rs14215616 Source: Crossref
2022-10-10 journal_article Copernicus GmbH Natural Hazards and Earth System Sciences Automated snow avalanche release area delineation in data-sparse, remote, and forested regions https://doi.org/10.5194/nhess-22-3247-2022 Source: Crossref
2022-06-27 journal_article MDPI AG Sensors A Novel Remote Sensing Image Registration Algorithm Based on Feature Using ProbNet-RANSAC https://doi.org/10.3390/s22134791 Source: Crossref
2022-04-16 journal_article MDPI AG Agronomy Remote Sensing of Maize Plant Height at Different Growth Stages Using UAV-Based Digital Surface Models (DSM) https://doi.org/10.3390/agronomy12040958 Source: Crossref
2022-02-23 journal_article Copernicus GmbH Earth System Science Data EcoDes-DK15: high-resolution ecological descriptors of vegetation and terrain derived from Denmark's national airborne laser scanning data set https://doi.org/10.5194/essd-14-823-2022 Source: Crossref



2024

2023

2022

Geopaparazzi

2022

GeoServer

2022

GeoTools

2022

GMT

2022

GRASS GIS

2022

gvSIG

2022

Hortonmachine

2022

MapServer

2022

MOSS

2022

OSGeoLive

2022

OSGeoLive Documentation

2022

PostGIS

2022

PROJ

2023

2022

QGIS

2022

rasdaman

2022

SMASH

2022

Projects considering a DOI

  1. degree
  2. (NASA World Wind)


<Add your project here>

DOI for datasets related to OSGeo

This is an incomplete overview over geospatial data sources which can be referenced by DOI. Many more datasets are available in Open Access repositories such as Zenodo

GRASS GIS

  1. Spearfish Dataset for GRASS GIS v4.x - v8.x https://doi.org/10.5281/zenodo.7930522
  2. New Orleans Dataset for GRASS GIS https://doi.org/10.5281/zenodo.3359642
  3. Hilltop Arboretum Landform Dataset for GRASS GIS https://doi.org/10.5281/zenodo.3749397
  4. Sichuan Dataset for GRASS GIS https://doi.org/10.5281/zenodo.3359645
  5. The Hills of Governor's Island Dataset for GRASS GIS https://doi.org/10.5281/zenodo.5248688
  6. Louisiana Dataset for GRASS GIS https://doi.org/10.5281/zenodo.3359620
  7. Natural Earth Dataset for GRASS GIS https://doi.org/10.5281/zenodo.3968936
  8. Global Dataset for GRASS GIS https://doi.org/10.5281/zenodo.3359632
  9. Governor's Island Dataset for GRASS GIS https://doi.org/10.5281/zenodo.5248419

(add datasets here)

QGIS

  1. Governor's Island Dataset for QGIS https://doi.org/10.5281/zenodo.5701115
  2. Louisiana Dataset for QGIS https://doi.org/10.5281/zenodo.3359620

(add datasets here)

DOI for OSGeo Video Recordings

add your DOI badge to your project pages

  • please add your DOI badge to your project

See Example Mapbender

You badge looks like this (replace your DOI in the Link and svg name) 

 <a href="https://doi.org/10.5281/zenodo.5887014"><img src="https://zenodo.org/badge/DOI/10.5281/zenodo.5887014.svg" alt="DOI"></a>


DOI support by Publishers and Journals

Not all publishers and scientific journals forward DOI-references in a manner (CrossRef) which can be automatically harvested and reported.

As it is difficult at best for propective authors to be aware prior to a publication wether its (DOI)-refernces will be indexed by CrossRef.

To mitigate this, an incomplete whitelist is being compiled (below) of journals, where CrossRef-indexing of OSGeo-DOI has been confirmed.

Likewise an incomplete greylist lists journals, where OSGeo-DOI have been used in publications, yet still are not indexed by CrossRef.

For scientific authors, the difference between a publication in a whitelist or greylist journal is wether DOI-based references to OSGeo software, -data or -video will be automagically attributed ("due scientific credit") to the respective OSGeo community / persons. For greylist journals, such attribution needs to be compiled manually.

Whitelist (Journals reporting DOI references to CrossRef)

  • tbd

Greylist

  • tbd


Related Identifiers

Research Organisiation Registry (ROR): An ID for the OSGeo Foundation

ROR is a global, community-led registry of open persistent identifiers for research organizations.

OSGeo ROR

The OSGeo Foundation is a research organisation.

The ROR ID for OSGeo is https://ror.org/00cjqbk89

Usage of ROR

Many scholarly communication systems are already using ROR, and many others are working on integrating ROR.

Background Information (ROR Community) =


ORCID (Open Researcher and Contributor ID) - a PID for people

Authentice an ORCID account with a GitHub

„We’re excited to announce that GitHub is partnering with ORCID. You can now authenticate your ORCID account with your GitHub account, and display your ORCID iD on your public GitHub profile. ORCID provides a persistent unique digital identifier (an ORCID iD) that researchers own and control, and that distinguishes them from every other researcher."

https://github.blog/changelog/2024-03-13-authenticate-orcid-id/

How to include ORCIDs to a LaTEX/Overleaf document

Include these packages: \usepackage{orcidlink} \usepackage[hidelinks]{hyperref}


\author{ Peter Löwe\,\orcidlink{0000-0003-2257-0517}~\textsuperscript{1}\thanks{Corresponding author}, Markus Neteler\,\orcidlink{0000-0003-1916-1966}~\textsuperscript{2} } (Source: OSGEO, PERSISTENT IDENTIFIERS AND THE SHAPE OF THINGS TO COME)

Retrieved from "http://wiki.osgeo.org/w/index.php?title=DOI&oldid=131770"