Skip to contents

The Dublin Core, also known as the Dublin Core Metadata Element Set (DCMES), is a set of fifteen main metadata items for describing digital or physical resources, such as datasets or their printed versions. Dublin Core has been formally standardized internationally as ISO 15836, as IETF RFC 5013 by the Internet Engineering Task Force (IETF), as well as in the U.S. as ANSI/NISO Z39.85.

The dublincore() function creates a bibentry object with extended Dublin Core elements.


dc <- dublincore(
  title = "Iris Dataset",
  creator = person("Edgar", "Anderson", role = "aut"),
  publisher = "American Iris Society",
  datasource = "https://doi.org/10.1111/j.1469-1809.1936.tb02137.x",
  date = 1935,
  language = "en",
  description = "This famous (Fisher's or Anderson's) iris data set gives the
  measurements in centimeters of the variables sepal length and width and petal length
  and width, respectively, for 50 flowers from each of 3 species of iris.
  The species are Iris setosa, versicolor, and virginica."
)

A bibentry object is easily printed or exported into various formats, for example, Bibtex.

print(dc, "Bibtex")
#> @Misc{,
#>   title = {Iris Dataset},
#>   author = {Edgar Anderson},
#>   identifier = {:tba},
#>   publisher = {American Iris Society},
#>   year = {1935},
#>   language = {en},
#>   relation = {:unas},
#>   format = {:unas},
#>   rights = {:tba},
#>   description = {This famous (Fisher's or Anderson's) iris data set gives the
#>   measurements in centimeters of the variables sepal length and width and petal length
#>   and width, respectively, for 50 flowers from each of 3 species of iris.
#>   The species are Iris setosa, versicolor, and virginica.},
#>   type = {DCMITYPE:Dataset},
#>   datasource = {https://doi.org/10.1111/j.1469-1809.1936.tb02137.x},
#>   coverage = {:unas},
#> }

The dataset package has an internal version of the famous dataset, iris. With as_datacite() you can retrieve the DataCite metadata of an existing dataset object into bibentry, list, or dataset format.

as_dublincore(iris_dataset, "list")
#> $title
#> [1] "Iris Dataset"
#> 
#> $creator
#> [1] "Edgar Anderson [aut]"
#> 
#> $identifier
#> [1] "https://doi.org/10.5281/zenodo.10396807"
#> 
#> $publisher
#> [1] "American Iris Society"
#> 
#> $subject
#> NULL
#> 
#> $type
#> [1] "DCMITYPE:Dataset"
#> 
#> $contributor
#> NULL
#> 
#> $date
#> function () 
#> .Internal(date())
#> <bytecode: 0x000002413f947ce0>
#> <environment: namespace:base>
#> 
#> $language
#> [1] "en"
#> 
#> $relation
#> [1] ":unas"
#> 
#> $format
#> [1] "application/r-rds"
#> 
#> $rights
#> [1] ":unas"
#> 
#> $datasource
#> [1] ":unas"
#> 
#> $description
#> [1] "The famous (Fisher's or Anderson's) iris data set."
#> 
#> $coverage
#> [1] ":unas"

Adding a datacite object created with datacite() to an existing dataset is not yet implemented.