Add or retrieve metadata conforming the DataCite Metadata Schema.
datacite(
Title,
Creator,
Identifier = NULL,
Publisher = NULL,
PublicationYear = NULL,
Subject = NULL,
Type = "Dataset",
Contributor = NULL,
DateList = NULL,
Language = NULL,
AlternateIdentifier = NULL,
RelatedIdentifier = NULL,
Format = NULL,
Version = NULL,
Rights = NULL,
Description = NULL,
Geolocation = NULL,
FundingReference = NULL
)as_datacite(x, type = "bibentry", ...)
is.datacite(x)
# S3 method for datacite
is.datacite(x)
A utils::bibentry
object DataCite attributes.
as_datacite
returns the existing metadata of a dataset object.
The name(s) or title(s) by which a resource is known. May be the
title of a dataset or the name of a piece of software.
Similar to
dct:title.
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 dct:title
in dublincore()
.
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 publisher()
.
The year when the data was or will be made publicly available in
YYYY
format.See publication_year()
.
Recommended for discovery. Subject, keyword, classification code, or key
phrase describing the resource. Similar to
dct:subject.
Use subject
to properly add a key phrase from a controlled vocabulary
and create structured Subject objects with subject_create
.
Defaults to Dataset
.
The DataCite resourceType definition refers back to
dcm:type.
The Type$resourceTypeGeneral
is set to "Dataset"
, while the user can set a more
specific Type$resourceType
value.
Recommended for discovery. The institution or person responsible for collecting, managing, distributing, or otherwise contributing to the development of the resource.
DataCite 4.4 allows to set multiple dates to a resource, they should be added as a list. See: datacite:Date.
The primary language of the resource. Allowed values are taken from
IETF BCP 47, ISO 639-1 language code. See language()
.
An identifier or identifiers other than the primary
Identifier applied to the resource being registered. This may be any
alphanumeric string unique within its domain of issue. It 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 version
.
Any rights information for this resource. The property may be repeated to record complex rights characteristics.
Free text. See rights
.
Recommended for discovery. All additional information that does not fit in any of the other categories. It 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 geolocation()
.
Information about financial support (funding) for the resource being registered.
An object that is tested if it has a class "datacite".
A DataCite 4.4 metadata can be returned as a type="list"
,
a type="dataset"
, or a type="bibentry"
(default).
Optional parameters to add to a datacite
object.
author=person("Jane", "Doe")
adds an author to the citation
object if type="dataset"
.
DataCite is a leading global non-profit organisation that provides persistent identifiers (DOIs) for research data and other research outputs. Organisations 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.
The ResourceType
property will be by definition "Dataset".
The Size
attribute (e.g. bytes, pages, inches, etc.) will automatically added to
the dataset.
Other metadata functions:
dublincore()
,
related_item()
datacite(
Title = "Iris Dataset",
Creator = person(family = "Anderson", given = "Edgar", role = "aut"),
Publisher = "American Iris Society",
PublicationYear = 1935,
Geolocation = "US",
Language = "en")
as_datacite(iris_dataset, type="dataset")
Run the code above in your browser using DataLab