Skip to contents

Export a dataset together with reference (DataCite and Dublin Core) metadata.

Usage

dataset_export(ds, file, filetype = "csv", ...)

dataset_export_csv(ds, file)

Arguments

ds

A dataset object.

file

A (path to) a file where to export the dataset object.

filetype

Currently only 'csv' is implemented.

...

Further parameters to be passed on to exporting functions. See details.

Value

The function write a desired file on disc and does not return anything.

Details

This function is a wrapper around the exporting functions.It implements file exports in a way that the resulting exported file contains reference metadata.
dataset_export_csv is a wrapper around utils::write.csv. Use ... to pass on argument to that function.

See also

dataset

Examples

my_iris_dataset <- dataset(
     x = iris,
     Dimensions = NULL,
     Measures = c("Sepal.Length", "Sepal.Width",  "Petal.Length", "Petal.Width" ),
     Attributes = "Species",
     Title = "Iris Dataset"
)

my_iris_dataset <- dublincore_add(
     x = my_iris_dataset,
     Creator = person("Edgar", "Anderson", role = "aut"),
     Publisher = "American Iris Society",
     Source = "https://doi.org/10.1111/j.1469-1809.1936.tb02137.x",
     Date = 1935,
     Language = "en"
)

dataset_export_csv(my_iris_dataset, file = file.path(tempdir(), "my_iris.csv"))

# \donttest{
read.csv(file.path(tempdir(), "my_iris.csv"), skip=20)
#>     Sepal.Length Sepal.Width Petal.Length Petal.Width    Species
#> 1            5.1         3.5          1.4         0.2     setosa
#> 2            4.9         3.0          1.4         0.2     setosa
#> 3            4.7         3.2          1.3         0.2     setosa
#> 4            4.6         3.1          1.5         0.2     setosa
#> 5            5.0         3.6          1.4         0.2     setosa
#> 6            5.4         3.9          1.7         0.4     setosa
#> 7            4.6         3.4          1.4         0.3     setosa
#> 8            5.0         3.4          1.5         0.2     setosa
#> 9            4.4         2.9          1.4         0.2     setosa
#> 10           4.9         3.1          1.5         0.1     setosa
#> 11           5.4         3.7          1.5         0.2     setosa
#> 12           4.8         3.4          1.6         0.2     setosa
#> 13           4.8         3.0          1.4         0.1     setosa
#> 14           4.3         3.0          1.1         0.1     setosa
#> 15           5.8         4.0          1.2         0.2     setosa
#> 16           5.7         4.4          1.5         0.4     setosa
#> 17           5.4         3.9          1.3         0.4     setosa
#> 18           5.1         3.5          1.4         0.3     setosa
#> 19           5.7         3.8          1.7         0.3     setosa
#> 20           5.1         3.8          1.5         0.3     setosa
#> 21           5.4         3.4          1.7         0.2     setosa
#> 22           5.1         3.7          1.5         0.4     setosa
#> 23           4.6         3.6          1.0         0.2     setosa
#> 24           5.1         3.3          1.7         0.5     setosa
#> 25           4.8         3.4          1.9         0.2     setosa
#> 26           5.0         3.0          1.6         0.2     setosa
#> 27           5.0         3.4          1.6         0.4     setosa
#> 28           5.2         3.5          1.5         0.2     setosa
#> 29           5.2         3.4          1.4         0.2     setosa
#> 30           4.7         3.2          1.6         0.2     setosa
#> 31           4.8         3.1          1.6         0.2     setosa
#> 32           5.4         3.4          1.5         0.4     setosa
#> 33           5.2         4.1          1.5         0.1     setosa
#> 34           5.5         4.2          1.4         0.2     setosa
#> 35           4.9         3.1          1.5         0.2     setosa
#> 36           5.0         3.2          1.2         0.2     setosa
#> 37           5.5         3.5          1.3         0.2     setosa
#> 38           4.9         3.6          1.4         0.1     setosa
#> 39           4.4         3.0          1.3         0.2     setosa
#> 40           5.1         3.4          1.5         0.2     setosa
#> 41           5.0         3.5          1.3         0.3     setosa
#> 42           4.5         2.3          1.3         0.3     setosa
#> 43           4.4         3.2          1.3         0.2     setosa
#> 44           5.0         3.5          1.6         0.6     setosa
#> 45           5.1         3.8          1.9         0.4     setosa
#> 46           4.8         3.0          1.4         0.3     setosa
#> 47           5.1         3.8          1.6         0.2     setosa
#> 48           4.6         3.2          1.4         0.2     setosa
#> 49           5.3         3.7          1.5         0.2     setosa
#> 50           5.0         3.3          1.4         0.2     setosa
#> 51           7.0         3.2          4.7         1.4 versicolor
#> 52           6.4         3.2          4.5         1.5 versicolor
#> 53           6.9         3.1          4.9         1.5 versicolor
#> 54           5.5         2.3          4.0         1.3 versicolor
#> 55           6.5         2.8          4.6         1.5 versicolor
#> 56           5.7         2.8          4.5         1.3 versicolor
#> 57           6.3         3.3          4.7         1.6 versicolor
#> 58           4.9         2.4          3.3         1.0 versicolor
#> 59           6.6         2.9          4.6         1.3 versicolor
#> 60           5.2         2.7          3.9         1.4 versicolor
#> 61           5.0         2.0          3.5         1.0 versicolor
#> 62           5.9         3.0          4.2         1.5 versicolor
#> 63           6.0         2.2          4.0         1.0 versicolor
#> 64           6.1         2.9          4.7         1.4 versicolor
#> 65           5.6         2.9          3.6         1.3 versicolor
#> 66           6.7         3.1          4.4         1.4 versicolor
#> 67           5.6         3.0          4.5         1.5 versicolor
#> 68           5.8         2.7          4.1         1.0 versicolor
#> 69           6.2         2.2          4.5         1.5 versicolor
#> 70           5.6         2.5          3.9         1.1 versicolor
#> 71           5.9         3.2          4.8         1.8 versicolor
#> 72           6.1         2.8          4.0         1.3 versicolor
#> 73           6.3         2.5          4.9         1.5 versicolor
#> 74           6.1         2.8          4.7         1.2 versicolor
#> 75           6.4         2.9          4.3         1.3 versicolor
#> 76           6.6         3.0          4.4         1.4 versicolor
#> 77           6.8         2.8          4.8         1.4 versicolor
#> 78           6.7         3.0          5.0         1.7 versicolor
#> 79           6.0         2.9          4.5         1.5 versicolor
#> 80           5.7         2.6          3.5         1.0 versicolor
#> 81           5.5         2.4          3.8         1.1 versicolor
#> 82           5.5         2.4          3.7         1.0 versicolor
#> 83           5.8         2.7          3.9         1.2 versicolor
#> 84           6.0         2.7          5.1         1.6 versicolor
#> 85           5.4         3.0          4.5         1.5 versicolor
#> 86           6.0         3.4          4.5         1.6 versicolor
#> 87           6.7         3.1          4.7         1.5 versicolor
#> 88           6.3         2.3          4.4         1.3 versicolor
#> 89           5.6         3.0          4.1         1.3 versicolor
#> 90           5.5         2.5          4.0         1.3 versicolor
#> 91           5.5         2.6          4.4         1.2 versicolor
#> 92           6.1         3.0          4.6         1.4 versicolor
#> 93           5.8         2.6          4.0         1.2 versicolor
#> 94           5.0         2.3          3.3         1.0 versicolor
#> 95           5.6         2.7          4.2         1.3 versicolor
#> 96           5.7         3.0          4.2         1.2 versicolor
#> 97           5.7         2.9          4.2         1.3 versicolor
#> 98           6.2         2.9          4.3         1.3 versicolor
#> 99           5.1         2.5          3.0         1.1 versicolor
#> 100          5.7         2.8          4.1         1.3 versicolor
#> 101          6.3         3.3          6.0         2.5  virginica
#> 102          5.8         2.7          5.1         1.9  virginica
#> 103          7.1         3.0          5.9         2.1  virginica
#> 104          6.3         2.9          5.6         1.8  virginica
#> 105          6.5         3.0          5.8         2.2  virginica
#> 106          7.6         3.0          6.6         2.1  virginica
#> 107          4.9         2.5          4.5         1.7  virginica
#> 108          7.3         2.9          6.3         1.8  virginica
#> 109          6.7         2.5          5.8         1.8  virginica
#> 110          7.2         3.6          6.1         2.5  virginica
#> 111          6.5         3.2          5.1         2.0  virginica
#> 112          6.4         2.7          5.3         1.9  virginica
#> 113          6.8         3.0          5.5         2.1  virginica
#> 114          5.7         2.5          5.0         2.0  virginica
#> 115          5.8         2.8          5.1         2.4  virginica
#> 116          6.4         3.2          5.3         2.3  virginica
#> 117          6.5         3.0          5.5         1.8  virginica
#> 118          7.7         3.8          6.7         2.2  virginica
#> 119          7.7         2.6          6.9         2.3  virginica
#> 120          6.0         2.2          5.0         1.5  virginica
#> 121          6.9         3.2          5.7         2.3  virginica
#> 122          5.6         2.8          4.9         2.0  virginica
#> 123          7.7         2.8          6.7         2.0  virginica
#> 124          6.3         2.7          4.9         1.8  virginica
#> 125          6.7         3.3          5.7         2.1  virginica
#> 126          7.2         3.2          6.0         1.8  virginica
#> 127          6.2         2.8          4.8         1.8  virginica
#> 128          6.1         3.0          4.9         1.8  virginica
#> 129          6.4         2.8          5.6         2.1  virginica
#> 130          7.2         3.0          5.8         1.6  virginica
#> 131          7.4         2.8          6.1         1.9  virginica
#> 132          7.9         3.8          6.4         2.0  virginica
#> 133          6.4         2.8          5.6         2.2  virginica
#> 134          6.3         2.8          5.1         1.5  virginica
#> 135          6.1         2.6          5.6         1.4  virginica
#> 136          7.7         3.0          6.1         2.3  virginica
#> 137          6.3         3.4          5.6         2.4  virginica
#> 138          6.4         3.1          5.5         1.8  virginica
#> 139          6.0         3.0          4.8         1.8  virginica
#> 140          6.9         3.1          5.4         2.1  virginica
#> 141          6.7         3.1          5.6         2.4  virginica
#> 142          6.9         3.1          5.1         2.3  virginica
#> 143          5.8         2.7          5.1         1.9  virginica
#> 144          6.8         3.2          5.9         2.3  virginica
#> 145          6.7         3.3          5.7         2.5  virginica
#> 146          6.7         3.0          5.2         2.3  virginica
#> 147          6.3         2.5          5.0         1.9  virginica
#> 148          6.5         3.0          5.2         2.0  virginica
#> 149          6.2         3.4          5.4         2.3  virginica
#> 150          5.9         3.0          5.1         1.8  virginica
read.csv(file.path(tempdir(), "my_iris.csv"))
#>         Property                                                     value
#> 1     dimensions                                                          
#> 2       measures         Sepal.Length|Sepal.Width|Petal.Length|Petal.Width
#> 3     attributes                                                   Species
#> 4           Type resourceType=DCMITYPE:Dataset|resourceTypeGeneral=Dataset
#> 5          Title                                              Iris Dataset
#> 6           Size                                      16.27 kB [15.89 KiB]
#> 7           Date                                                2022-12-15
#> 8        Creator                                      Edgar Anderson [aut]
#> 9         Source        https://doi.org/10.1111/j.1469-1809.1936.tb02137.x
#> 10     Publisher                                     American Iris Society
#> 11      Language                                                       eng
#> 12        Issued                                                      <NA>
#> 13          <NA>                                                      <NA>
#> 14          <NA>                                                      <NA>
#> 15          <NA>                                                      <NA>
#> 16          <NA>                                                      <NA>
#> 17          <NA>                                                      <NA>
#> 18          <NA>                                                      <NA>
#> 19          <NA>                                                      <NA>
#> 20  Sepal.Length                                               Sepal.Width
#> 21           5.1                                                       3.5
#> 22           4.9                                                         3
#> 23           4.7                                                       3.2
#> 24           4.6                                                       3.1
#> 25             5                                                       3.6
#> 26           5.4                                                       3.9
#> 27           4.6                                                       3.4
#> 28             5                                                       3.4
#> 29           4.4                                                       2.9
#> 30           4.9                                                       3.1
#> 31           5.4                                                       3.7
#> 32           4.8                                                       3.4
#> 33           4.8                                                         3
#> 34           4.3                                                         3
#> 35           5.8                                                         4
#> 36           5.7                                                       4.4
#> 37           5.4                                                       3.9
#> 38           5.1                                                       3.5
#> 39           5.7                                                       3.8
#> 40           5.1                                                       3.8
#> 41           5.4                                                       3.4
#> 42           5.1                                                       3.7
#> 43           4.6                                                       3.6
#> 44           5.1                                                       3.3
#> 45           4.8                                                       3.4
#> 46             5                                                         3
#> 47             5                                                       3.4
#> 48           5.2                                                       3.5
#> 49           5.2                                                       3.4
#> 50           4.7                                                       3.2
#> 51           4.8                                                       3.1
#> 52           5.4                                                       3.4
#> 53           5.2                                                       4.1
#> 54           5.5                                                       4.2
#> 55           4.9                                                       3.1
#> 56             5                                                       3.2
#> 57           5.5                                                       3.5
#> 58           4.9                                                       3.6
#> 59           4.4                                                         3
#> 60           5.1                                                       3.4
#> 61             5                                                       3.5
#> 62           4.5                                                       2.3
#> 63           4.4                                                       3.2
#> 64             5                                                       3.5
#> 65           5.1                                                       3.8
#> 66           4.8                                                         3
#> 67           5.1                                                       3.8
#> 68           4.6                                                       3.2
#> 69           5.3                                                       3.7
#> 70             5                                                       3.3
#> 71             7                                                       3.2
#> 72           6.4                                                       3.2
#> 73           6.9                                                       3.1
#> 74           5.5                                                       2.3
#> 75           6.5                                                       2.8
#> 76           5.7                                                       2.8
#> 77           6.3                                                       3.3
#> 78           4.9                                                       2.4
#> 79           6.6                                                       2.9
#> 80           5.2                                                       2.7
#> 81             5                                                         2
#> 82           5.9                                                         3
#> 83             6                                                       2.2
#> 84           6.1                                                       2.9
#> 85           5.6                                                       2.9
#> 86           6.7                                                       3.1
#> 87           5.6                                                         3
#> 88           5.8                                                       2.7
#> 89           6.2                                                       2.2
#> 90           5.6                                                       2.5
#> 91           5.9                                                       3.2
#> 92           6.1                                                       2.8
#> 93           6.3                                                       2.5
#> 94           6.1                                                       2.8
#> 95           6.4                                                       2.9
#> 96           6.6                                                         3
#> 97           6.8                                                       2.8
#> 98           6.7                                                         3
#> 99             6                                                       2.9
#> 100          5.7                                                       2.6
#> 101          5.5                                                       2.4
#> 102          5.5                                                       2.4
#> 103          5.8                                                       2.7
#> 104            6                                                       2.7
#> 105          5.4                                                         3
#> 106            6                                                       3.4
#> 107          6.7                                                       3.1
#> 108          6.3                                                       2.3
#> 109          5.6                                                         3
#> 110          5.5                                                       2.5
#> 111          5.5                                                       2.6
#> 112          6.1                                                         3
#> 113          5.8                                                       2.6
#> 114            5                                                       2.3
#> 115          5.6                                                       2.7
#> 116          5.7                                                         3
#> 117          5.7                                                       2.9
#> 118          6.2                                                       2.9
#> 119          5.1                                                       2.5
#> 120          5.7                                                       2.8
#> 121          6.3                                                       3.3
#> 122          5.8                                                       2.7
#> 123          7.1                                                         3
#> 124          6.3                                                       2.9
#> 125          6.5                                                         3
#> 126          7.6                                                         3
#> 127          4.9                                                       2.5
#> 128          7.3                                                       2.9
#> 129          6.7                                                       2.5
#> 130          7.2                                                       3.6
#> 131          6.5                                                       3.2
#> 132          6.4                                                       2.7
#> 133          6.8                                                         3
#> 134          5.7                                                       2.5
#> 135          5.8                                                       2.8
#> 136          6.4                                                       3.2
#> 137          6.5                                                         3
#> 138          7.7                                                       3.8
#> 139          7.7                                                       2.6
#> 140            6                                                       2.2
#> 141          6.9                                                       3.2
#> 142          5.6                                                       2.8
#> 143          7.7                                                       2.8
#> 144          6.3                                                       2.7
#> 145          6.7                                                       3.3
#> 146          7.2                                                       3.2
#> 147          6.2                                                       2.8
#> 148          6.1                                                         3
#> 149          6.4                                                       2.8
#> 150          7.2                                                         3
#> 151          7.4                                                       2.8
#> 152          7.9                                                       3.8
#> 153          6.4                                                       2.8
#> 154          6.3                                                       2.8
#> 155          6.1                                                       2.6
#> 156          7.7                                                         3
#> 157          6.3                                                       3.4
#> 158          6.4                                                       3.1
#> 159            6                                                         3
#> 160          6.9                                                       3.1
#> 161          6.7                                                       3.1
#> 162          6.9                                                       3.1
#> 163          5.8                                                       2.7
#> 164          6.8                                                       3.2
#> 165          6.7                                                       3.3
#> 166          6.7                                                         3
#> 167          6.3                                                       2.5
#> 168          6.5                                                         3
#> 169          6.2                                                       3.4
#> 170          5.9                                                         3
#>               V1          V2         V3
#> 1           <NA>        <NA>       <NA>
#> 2           <NA>        <NA>       <NA>
#> 3           <NA>        <NA>       <NA>
#> 4           <NA>        <NA>       <NA>
#> 5           <NA>        <NA>       <NA>
#> 6           <NA>        <NA>       <NA>
#> 7           <NA>        <NA>       <NA>
#> 8           <NA>        <NA>       <NA>
#> 9           <NA>        <NA>       <NA>
#> 10          <NA>        <NA>       <NA>
#> 11          <NA>        <NA>       <NA>
#> 12          <NA>        <NA>       <NA>
#> 13          <NA>        <NA>       <NA>
#> 14          <NA>        <NA>       <NA>
#> 15          <NA>        <NA>       <NA>
#> 16          <NA>        <NA>       <NA>
#> 17          <NA>        <NA>       <NA>
#> 18          <NA>        <NA>       <NA>
#> 19          <NA>        <NA>       <NA>
#> 20  Petal.Length Petal.Width    Species
#> 21           1.4         0.2     setosa
#> 22           1.4         0.2     setosa
#> 23           1.3         0.2     setosa
#> 24           1.5         0.2     setosa
#> 25           1.4         0.2     setosa
#> 26           1.7         0.4     setosa
#> 27           1.4         0.3     setosa
#> 28           1.5         0.2     setosa
#> 29           1.4         0.2     setosa
#> 30           1.5         0.1     setosa
#> 31           1.5         0.2     setosa
#> 32           1.6         0.2     setosa
#> 33           1.4         0.1     setosa
#> 34           1.1         0.1     setosa
#> 35           1.2         0.2     setosa
#> 36           1.5         0.4     setosa
#> 37           1.3         0.4     setosa
#> 38           1.4         0.3     setosa
#> 39           1.7         0.3     setosa
#> 40           1.5         0.3     setosa
#> 41           1.7         0.2     setosa
#> 42           1.5         0.4     setosa
#> 43             1         0.2     setosa
#> 44           1.7         0.5     setosa
#> 45           1.9         0.2     setosa
#> 46           1.6         0.2     setosa
#> 47           1.6         0.4     setosa
#> 48           1.5         0.2     setosa
#> 49           1.4         0.2     setosa
#> 50           1.6         0.2     setosa
#> 51           1.6         0.2     setosa
#> 52           1.5         0.4     setosa
#> 53           1.5         0.1     setosa
#> 54           1.4         0.2     setosa
#> 55           1.5         0.2     setosa
#> 56           1.2         0.2     setosa
#> 57           1.3         0.2     setosa
#> 58           1.4         0.1     setosa
#> 59           1.3         0.2     setosa
#> 60           1.5         0.2     setosa
#> 61           1.3         0.3     setosa
#> 62           1.3         0.3     setosa
#> 63           1.3         0.2     setosa
#> 64           1.6         0.6     setosa
#> 65           1.9         0.4     setosa
#> 66           1.4         0.3     setosa
#> 67           1.6         0.2     setosa
#> 68           1.4         0.2     setosa
#> 69           1.5         0.2     setosa
#> 70           1.4         0.2     setosa
#> 71           4.7         1.4 versicolor
#> 72           4.5         1.5 versicolor
#> 73           4.9         1.5 versicolor
#> 74             4         1.3 versicolor
#> 75           4.6         1.5 versicolor
#> 76           4.5         1.3 versicolor
#> 77           4.7         1.6 versicolor
#> 78           3.3           1 versicolor
#> 79           4.6         1.3 versicolor
#> 80           3.9         1.4 versicolor
#> 81           3.5           1 versicolor
#> 82           4.2         1.5 versicolor
#> 83             4           1 versicolor
#> 84           4.7         1.4 versicolor
#> 85           3.6         1.3 versicolor
#> 86           4.4         1.4 versicolor
#> 87           4.5         1.5 versicolor
#> 88           4.1           1 versicolor
#> 89           4.5         1.5 versicolor
#> 90           3.9         1.1 versicolor
#> 91           4.8         1.8 versicolor
#> 92             4         1.3 versicolor
#> 93           4.9         1.5 versicolor
#> 94           4.7         1.2 versicolor
#> 95           4.3         1.3 versicolor
#> 96           4.4         1.4 versicolor
#> 97           4.8         1.4 versicolor
#> 98             5         1.7 versicolor
#> 99           4.5         1.5 versicolor
#> 100          3.5           1 versicolor
#> 101          3.8         1.1 versicolor
#> 102          3.7           1 versicolor
#> 103          3.9         1.2 versicolor
#> 104          5.1         1.6 versicolor
#> 105          4.5         1.5 versicolor
#> 106          4.5         1.6 versicolor
#> 107          4.7         1.5 versicolor
#> 108          4.4         1.3 versicolor
#> 109          4.1         1.3 versicolor
#> 110            4         1.3 versicolor
#> 111          4.4         1.2 versicolor
#> 112          4.6         1.4 versicolor
#> 113            4         1.2 versicolor
#> 114          3.3           1 versicolor
#> 115          4.2         1.3 versicolor
#> 116          4.2         1.2 versicolor
#> 117          4.2         1.3 versicolor
#> 118          4.3         1.3 versicolor
#> 119            3         1.1 versicolor
#> 120          4.1         1.3 versicolor
#> 121            6         2.5  virginica
#> 122          5.1         1.9  virginica
#> 123          5.9         2.1  virginica
#> 124          5.6         1.8  virginica
#> 125          5.8         2.2  virginica
#> 126          6.6         2.1  virginica
#> 127          4.5         1.7  virginica
#> 128          6.3         1.8  virginica
#> 129          5.8         1.8  virginica
#> 130          6.1         2.5  virginica
#> 131          5.1           2  virginica
#> 132          5.3         1.9  virginica
#> 133          5.5         2.1  virginica
#> 134            5           2  virginica
#> 135          5.1         2.4  virginica
#> 136          5.3         2.3  virginica
#> 137          5.5         1.8  virginica
#> 138          6.7         2.2  virginica
#> 139          6.9         2.3  virginica
#> 140            5         1.5  virginica
#> 141          5.7         2.3  virginica
#> 142          4.9           2  virginica
#> 143          6.7           2  virginica
#> 144          4.9         1.8  virginica
#> 145          5.7         2.1  virginica
#> 146            6         1.8  virginica
#> 147          4.8         1.8  virginica
#> 148          4.9         1.8  virginica
#> 149          5.6         2.1  virginica
#> 150          5.8         1.6  virginica
#> 151          6.1         1.9  virginica
#> 152          6.4           2  virginica
#> 153          5.6         2.2  virginica
#> 154          5.1         1.5  virginica
#> 155          5.6         1.4  virginica
#> 156          6.1         2.3  virginica
#> 157          5.6         2.4  virginica
#> 158          5.5         1.8  virginica
#> 159          4.8         1.8  virginica
#> 160          5.4         2.1  virginica
#> 161          5.6         2.4  virginica
#> 162          5.1         2.3  virginica
#> 163          5.1         1.9  virginica
#> 164          5.9         2.3  virginica
#> 165          5.7         2.5  virginica
#> 166          5.2         2.3  virginica
#> 167            5         1.9  virginica
#> 168          5.2           2  virginica
#> 169          5.4         2.3  virginica
#> 170          5.1         1.8  virginica
# }