Add DataCite metadata to an objectSource:
Add metadata conforming the DataCite Metadata Schema to datasets, i.e. structured R data.frame or list objects, for an accurate and consistent identification of a resource for citation and retrieval purposes.
datacite(x) datacite_add( x, Title, titleType = NULL, Creator, Identifier = NULL, Publisher = NULL, PublicationYear = "THIS", Subject = NULL, Type = "Dataset", Contributor = NULL, Date = NULL, Language = NULL, AlternateIdentifier = NULL, RelatedIdentifier = NULL, Format = NULL, Version = NULL, Rights = NULL, Description = NULL, Geolocation = NULL, FundingReference = NULL, overwrite = TRUE )
An R object of type data.frame, or inherited data.table, tibble; alternatively a well structured R list.
For a single
NULL. Otherwise you can add a Subtitle, an Alternative Title and an Other Title. See
The main researchers involved in producing the data, or the authors of the publication, in priority order. To supply multiple creators, repeat this property.
The Identifier is a unique string that identifies a resource. For software, determine whether the identifier is for a specific version of a piece of software, (per the Force11 Software Citation Principles, or for all versions. Similar to
The name of the entity that holds, archives, publishes prints, distributes, releases, issues, or produces the resource. This property will be used to formulate the citation, so consider the prominence of the role. For software, use Publisher for the code repository. Mandatory in DataCite, and similar to dct:publisher. See
The year when the data was or will be made publicly available in
Recommended for discovery. Subject, keyword, classification code, or key phrase describing the resource. Similar to dct:subject.
subjectto properly add a key phrase from a controlled vocabulary and create structured Subject objects with
Dataset. The DataCite resourceType definition refers back to dcm:type. The
Type$resourceTypeGeneralis set to
Dataset, while the user can set a more specific
Recommended for discovery. The institution or person responsible for collecting, managing, distributing, or otherwise contributing to the development of the resource.
The primary language of the resource. Allowed values are taken from IETF BCP 47, ISO 639-1 language code. See
An identifier or identifiers other than the primary Identifier applied to the resource being registered. This may be any alphanumeric string which is unique within its domain of issue. May be used for local identifiers. AlternateIdentifier should be used for another identifier of the same instance (same location, same file).
Recommended for discovery. Similar to dct:relation.
Technical format of the resource. Similar to dct:format.
Free text. Suggested practice: track major_version.minor_version. See
Any rights information for this resource. The property may be repeated to record complex rights characteristics. Free text. See
Recommended for discovery. All additional information that does not fit in any of the other categories. May be used for technical information. A free text. Similar to dct:description.
Recommended for discovery. Spatial region or named place where the data was gathered or about which the data is focused. See
Information about financial support (funding) for the resource being registered.
If pre-existing metadata properties should be overwritten, defaults to
DataCite is a leading global non-profit organisation that provides persistent identifiers
(DOIs) for research data and other research outputs. Organizations within the research
community join DataCite as members to be able to assign DOIs to all their research
outputs. This way, their outputs become discoverable and associated metadata is made
available to the community.
DataCite then develops additional services to improve the DOI management experience, making it easier for our members to connect and share their DOIs with the broader research ecosystem and to assess the use of their DOIs within that ecosystem. DataCite is an active participant in the research community and promotes data sharing and citation through community-building efforts and outreach activities.
ResourceType property will be by definition "Dataset".
Size attribute (e.g. bytes, pages, inches, etc.) will automatically added to the dataset.
my_iris <- datacite_add( x = iris, Title = "Iris Dataset", Creator = person(family = "Anderson", given = "Edgar", role = "aut"), Publisher = "American Iris Society", PublicationYear = 1935, Geolocation = "US", Language = "en") datacite(my_iris) #> $names #>  "Sepal.Length" "Sepal.Width" "Petal.Length" "Petal.Width" "Species" #> #> $Title #> $Title$Title #>  "Iris Dataset" #> #> #> $Creator #>  "Edgar Anderson [aut]" #> #> $Identifier #>  NA #> #> $Publisher #>  "American Iris Society" #> #> $Issued #>  1935 #> #> $publication_year #>  1935 #> #> $Type #> $Type$resourceType #>  "Dataset" #> #> $Type$resourceTypeGeneral #>  "Dataset" #> #> #> $Description #>  NA #> #> $Geolocation #>  "US" #> #> $Language #>  "eng" #> #> $Rights #>  NA #> #> $Size #>  "11.34 kB [11.08 KiB]" #>