Skip to content

Commit c7538a4

Browse files
committed
udpate readme with zenodo publication
1 parent 9b56111 commit c7538a4

File tree

2 files changed

+52
-36
lines changed

2 files changed

+52
-36
lines changed

README.Rmd

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@ knitr::opts_chunk$set(
1818

1919
<!-- badges: start -->
2020
![GitHub](https://img.shields.io/github/license/b-cubed-eu/b3data-scripts)
21+
[![Release](https://img.shields.io/github/release/b-cubed-eu/b3data-scripts.svg)](https://github.com/b-cubed-eu/b3data-scripts/releases)
2122
[![repo status](https://www.repostatus.org/badges/latest/wip.svg)](https://www.repostatus.org/#wip)
2223
![GitHub repo size](https://img.shields.io/github/repo-size/b-cubed-eu/b3data-scripts)
2324
<!-- badges: end -->
@@ -65,7 +66,7 @@ Follow the steps below to run the scripts in a logical order.
6566
## 📦 The `b3data` data package
6667

6768
- **Name**: `b3data`
68-
- **Published at**: [Zenodo](https://zenodo.org/) (DOI to be reserved)
69+
- **Published at**: [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.15181097.svg)](https://doi.org/10.5281/zenodo.15181097)
6970
- **Used in**: [b3verse](https://docs.b-cubed.eu/guides/b3verse/)
7071
- **Importable in R via**: [frictionless](https://docs.ropensci.org/frictionless/) R package
7172

@@ -84,10 +85,10 @@ library(frictionless)
8485

8586
### Step 2 — Read the package descriptor from Zenodo
8687

87-
> This example uses a placeholder data package; replace with the final URL when ready.
88+
The content of the data package can be consulted using `read_package()`.
8889

8990
```{r}
90-
b3data_package <- read_package("https://zenodo.org/records/10053702/files/datapackage.json")
91+
b3data_package <- read_package("https://zenodo.org/records/15181098/files/datapackage.json")
9192
b3data_package
9293
```
9394

@@ -96,13 +97,17 @@ b3data_package
9697
Tabular datasets can be loaded using `read_resource()`.
9798

9899
```{r}
99-
gps <- read_resource(b3data_package, "gps")
100-
head(gps)
100+
bird_cube_belgium <- read_resource(b3data_package, "bird_cube_belgium_mgrs10")
101+
head(bird_cube_belgium)
101102
```
102103

103-
For non-tabular resources (e.g. spatial or raster data), use packages like `sf` or `terra`.
104+
For non-tabular resources (e.g. spatial or raster data), use packages like `sf` or `terra` directly.
104105

105-
> Example coming soon.
106+
```{r}
107+
mgrs10_belgium <- sf::st_read("https://zenodo.org/records/15181098/files/mgrs10_refgrid_belgium.geojson",
108+
quiet = TRUE)
109+
head(mgrs10_belgium)
110+
```
106111

107112
```{r, echo=FALSE}
108113
# nolint end

README.md

Lines changed: 40 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
<!-- badges: start -->
44

55
![GitHub](https://img.shields.io/github/license/b-cubed-eu/b3data-scripts)
6+
[![Release](https://img.shields.io/github/release/b-cubed-eu/b3data-scripts.svg)](https://github.com/b-cubed-eu/b3data-scripts/releases)
67
[![repo
78
status](https://www.repostatus.org/badges/latest/wip.svg)](https://www.repostatus.org/#wip)
89
![GitHub repo
@@ -52,7 +53,8 @@ Follow the steps below to run the scripts in a logical order.
5253
## 📦 The `b3data` data package
5354

5455
- **Name**: `b3data`
55-
- **Published at**: [Zenodo](https://zenodo.org/) (DOI to be reserved)
56+
- **Published at**:
57+
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.15181097.svg)](https://doi.org/10.5281/zenodo.15181097)
5658
- **Used in**: [b3verse](https://docs.b-cubed.eu/guides/b3verse/)
5759
- **Importable in R via**:
5860
[frictionless](https://docs.ropensci.org/frictionless/) R package
@@ -68,17 +70,15 @@ library(frictionless)
6870

6971
### Step 2 — Read the package descriptor from Zenodo
7072

71-
> This example uses a placeholder data package; replace with the final
72-
> URL when ready.
73+
The content of the data package can be consulted using `read_package()`.
7374

7475
``` r
75-
b3data_package <- read_package("https://zenodo.org/records/10053702/files/datapackage.json")
76+
b3data_package <- read_package("https://zenodo.org/records/15181098/files/datapackage.json")
7677
b3data_package
77-
#> A Data Package with 3 resources:
78-
#> • reference-data
79-
#> • gps
80-
#> • acceleration
81-
#> For more information, see <https://doi.org/10.5281/zenodo.10053702>.
78+
#> A Data Package with 2 resources:
79+
#> • bird_cube_belgium_mgrs10
80+
#> • mgrs10_refgrid_belgium
81+
#> For more information, see <https://doi.org/10.5281/zenodo.15181098>.
8282
#> Use `unclass()` to print the Data Package as a list.
8383
```
8484

@@ -87,30 +87,41 @@ b3data_package
8787
Tabular datasets can be loaded using `read_resource()`.
8888

8989
``` r
90-
gps <- read_resource(b3data_package, "gps")
91-
head(gps)
92-
#> # A tibble: 6 × 21
93-
#> `event-id` visible timestamp `location-long` `location-lat`
94-
#> <dbl> <lgl> <dttm> <dbl> <dbl>
95-
#> 1 14256075762 TRUE 2018-05-25 16:11:37 4.25 51.3
96-
#> 2 14256075763 TRUE 2018-05-25 16:16:41 4.25 51.3
97-
#> 3 14256075764 TRUE 2018-05-25 16:21:29 4.25 51.3
98-
#> 4 14256075765 TRUE 2018-05-25 16:26:28 4.25 51.3
99-
#> 5 14256075766 TRUE 2018-05-25 16:31:21 4.25 51.3
100-
#> 6 14256075767 TRUE 2018-05-25 16:36:09 4.25 51.3
101-
#> # ℹ 16 more variables: `bar:barometric-pressure` <dbl>,
102-
#> # `external-temperature` <dbl>, `gps:dop` <dbl>, `gps:satellite-count` <dbl>,
103-
#> # `gps-time-to-fix` <dbl>, `ground-speed` <dbl>, heading <dbl>,
104-
#> # `height-above-msl` <dbl>, `location-error-numerical` <dbl>,
105-
#> # `manually-marked-outlier` <lgl>, `vertical-error-numerical` <dbl>,
106-
#> # `sensor-type` <chr>, `individual-taxon-canonical-name` <chr>,
107-
#> # `tag-local-identifier` <chr>, `individual-local-identifier` <chr>, …
90+
bird_cube_belgium <- read_resource(b3data_package, "bird_cube_belgium_mgrs10")
91+
head(bird_cube_belgium)
92+
#> # A tibble: 6 × 8
93+
#> year mgrscode specieskey species family n mincoordinateuncerta…¹
94+
#> <dbl> <chr> <dbl> <chr> <chr> <dbl> <dbl>
95+
#> 1 2000 31UDS65 2473958 Perdix perdix Phasi… 1 3536
96+
#> 2 2000 31UDS65 2474156 Coturnix coturn… Phasi… 1 3536
97+
#> 3 2000 31UDS65 2474377 Fulica atra Ralli… 5 1000
98+
#> 4 2000 31UDS65 2475443 Merops apiaster Merop… 6 1000
99+
#> 5 2000 31UDS65 2480242 Vanellus vanell… Chara… 1 3536
100+
#> 6 2000 31UDS65 2480637 Accipiter nisus Accip… 1 3536
101+
#> # ℹ abbreviated name: ¹​mincoordinateuncertaintyinmeters
102+
#> # ℹ 1 more variable: familycount <dbl>
108103
```
109104

110105
For non-tabular resources (e.g. spatial or raster data), use packages
111-
like `sf` or `terra`.
106+
like `sf` or `terra` directly.
112107

113-
> Example coming soon.
108+
``` r
109+
mgrs10_belgium <- sf::st_read("https://zenodo.org/records/15181098/files/mgrs10_refgrid_belgium.geojson",
110+
quiet = TRUE)
111+
head(mgrs10_belgium)
112+
#> Simple feature collection with 6 features and 1 field
113+
#> Geometry type: POLYGON
114+
#> Dimension: XY
115+
#> Bounding box: xmin: 13919.31 ymin: 159175.7 xmax: 34107.28 ymax: 209553.2
116+
#> Geodetic CRS: WGS 84
117+
#> mgrscode geometry
118+
#> 1 31UDS65 POLYGON ((23939.64 190365.5...
119+
#> 2 31UDS66 POLYGON ((24123.5 200367.5,...
120+
#> 3 31UDS72 POLYGON ((33389.37 160175.9...
121+
#> 4 31UDS73 POLYGON ((33573.52 170177.6...
122+
#> 5 31UDS74 POLYGON ((33757.62 180179.5...
123+
#> 6 31UDS75 POLYGON ((33941.67 190181.5...
124+
```
114125

115126
## 📁 Repository structure
116127

0 commit comments

Comments
 (0)