Merge pull request #6 from jukent/doi

Update Cookbook with changes to template for DOI

CITATION.cff

@@ -11,7 +11,7 @@ authors:
     given-names: Michael
     website: https://github.com/Michael-Barletta
     orcid: https://orcid.org/0000-0003-3318-7601
-  - name: "ARCO ERA-5 cookbook contributors" # use the 'name' field to acknowledge organizations
+  - name: "ARCO ERA-5 Cookbook contributors" # use the 'name' field to acknowledge organizations
     website: "https://github.com/ProjectPythia/ERA5_interactive/graphs/contributors"
 title: "ARCO ERA-5 Interactive Visualization Cookbook"
-abstract: "A cookbook to interactively explore and visualize ERA-5 data in ARCO format"
+abstract: "A cookbook to interactively explore and visualize ERA-5 data in ARCO format."

README.md

@@ -4,6 +4,7 @@
 
 [![nightly-build](https://github.com/ProjectPythia/ERA5_interactive-cookbook/actions/workflows/nightly-build.yaml/badge.svg)](https://github.com/ProjectPythia/ERA5_interactive-cookbook/actions/workflows/nightly-build.yaml)
 [![Binder](https://binder.projectpythia.org/badge_logo.svg)](https://binder.projectpythia.org/v2/gh/ProjectPythia/ERA5_interactive-cookbook/main?labpath=notebooks)
+[![DOI](https://zenodo.org/badge/657280462.svg)](https://zenodo.org/badge/latestdoi/657280462)
 
 A team at [Google Research & Cloud](https://research.google/) are making parts of the [ECMWF Reanalysis version 5](https://www.ecmwf.int/en/forecasts/dataset/ecmwf-reanalysis-v5) (aka **ERA-5**) accessible in a [Analysis Ready, Cloud Optimized](https://www.frontiersin.org/articles/10.3389/fclim.2021.782909/full) (aka **ARCO**) format.
 
@@ -30,33 +31,31 @@ In the notebooks which comprise this Cookbook, we demonstrate the following:
 3. Plot a map at a specific time using Matplotlib and Cartopy
 4. Create interactive visualizations, leveraging the [Holoviz](https://holoviz.org) ecosystem
 
-
-
 ## Authors
 
 [Kevin Tyle](https://github.com/ktyle), [Michael Barletta](https://github.com/Michael-Barletta)
 
 We also gratefully acknowledge the Google Cloud Research team for making an ARCO-friendly version of the ERA-5 available. Citations for their effort and the ERA-5 reanalysis are below:
 
 - Carver, Robert W, and Merose, Alex. (2023): ARCO-ERA5: An Analysis-Ready Cloud-Optimized Reanalysis Dataset. 22nd Conf. on AI for Env. Science, Denver, CO, Amer. Meteo. Soc, 4A.1, https://ams.confex.com/ams/103ANNUAL/meetingapp.cgi/Paper/415842
-- Hersbach, H., Bell, B., Berrisford, P., Hirahara, S., Horányi, A., 
-Muñoz‐Sabater, J., Nicolas, J., Peubey, C., Radu, R., Schepers, D., 
-Simmons, A., Soci, C., Abdalla, S., Abellan, X., Balsamo, G., 
-Bechtold, P., Biavati, G., Bidlot, J., Bonavita, M., De Chiara, G., 
-Dahlgren, P., Dee, D., Diamantakis, M., Dragani, R., Flemming, J., 
-Forbes, R., Fuentes, M., Geer, A., Haimberger, L., Healy, S., 
-Hogan, R.J., Hólm, E., Janisková, M., Keeley, S., Laloyaux, P., 
-Lopez, P., Lupu, C., Radnoti, G., de Rosnay, P., Rozum, I., Vamborg, F.,
-Villaume, S., Thépaut, J-N. (2017): Complete ERA5: Fifth generation of 
-ECMWF atmospheric reanalyses of the global climate. Copernicus Climate 
-Change Service (C3S) Data Store (CDS).
-Hersbach et al, (2017) was downloaded from the Copernicus Climate Change 
-Service (C3S) Climate Data Store. We thank C3S for allowing us to 
-redistribute the data.
-The results contain modified Copernicus Climate Change Service 
-information 2022. Neither the European Commission nor ECMWF is 
-responsible for any use that may be made of the Copernicus information 
-or data it contains.
+- Hersbach, H., Bell, B., Berrisford, P., Hirahara, S., Horányi, A.,
+  Muñoz‐Sabater, J., Nicolas, J., Peubey, C., Radu, R., Schepers, D.,
+  Simmons, A., Soci, C., Abdalla, S., Abellan, X., Balsamo, G.,
+  Bechtold, P., Biavati, G., Bidlot, J., Bonavita, M., De Chiara, G.,
+  Dahlgren, P., Dee, D., Diamantakis, M., Dragani, R., Flemming, J.,
+  Forbes, R., Fuentes, M., Geer, A., Haimberger, L., Healy, S.,
+  Hogan, R.J., Hólm, E., Janisková, M., Keeley, S., Laloyaux, P.,
+  Lopez, P., Lupu, C., Radnoti, G., de Rosnay, P., Rozum, I., Vamborg, F.,
+  Villaume, S., Thépaut, J-N. (2017): Complete ERA5: Fifth generation of
+  ECMWF atmospheric reanalyses of the global climate. Copernicus Climate
+  Change Service (C3S) Data Store (CDS).
+  Hersbach et al, (2017) was downloaded from the Copernicus Climate Change
+  Service (C3S) Climate Data Store. We thank C3S for allowing us to
+  redistribute the data.
+  The results contain modified Copernicus Climate Change Service
+  information 2022. Neither the European Commission nor ECMWF is
+  responsible for any use that may be made of the Copernicus information
+  or data it contains.
 
 ### Contributors
 

_config.yml

@@ -4,17 +4,8 @@
 title: ARCO ERA-5 Interactive Visualization
 author: Michael Barletta and Kevin Tyle
 logo: notebooks/images/logos/pythia_logo-white-rtext.svg
-email: [email protected]
 copyright: "2023"
 
-description: ARCO ERA-5 Analysis and Visualization
-thumbnail: thumbnail.png
-tags:
-  domains:
-    - meteorology
-  packages:
-    - zarr, geoviews, panel, xarray
-
 execute:
   # To execute notebooks via a Binder instead, replace 'cache' with 'binder'
   execute_notebooks: cache

_gallery_info.yml

@@ -0,0 +1,9 @@
+thumbnail: thumbnail.png
+tags:
+  domains:
+    - meteorology
+  packages:
+    - zarr
+    - geoviews
+    - panel
+    - xarray

_toc.yml

@@ -1,6 +1,9 @@
 format: jb-book
 root: README
 parts:
+  - caption: Preamble
+    chapters:
+      - file: notebooks/how-to-cite
   - caption: Visualization notebooks
     chapters:
       - file: notebooks/01BasicVisualization

notebooks/how-to-cite.md

@@ -0,0 +1,7 @@
+# How to Cite This Cookbook
+
+The material in Project Pythia's ARCO ERA-5 Interactive Visualization Cookbook is licensed for free and open consumption and reuse. All code is served under [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0), while all non-code content is licensed under [Creative Commons BY 4.0 (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/). Effectively, this means you are free to share and adapt this material so long as you give appropriate credit to the Cookbook authors and the Project Pythia community.
+
+The source code for the book is [released on GitHub](https://github.com/ProjectPythia/ERA5_interactive-cookbook) and archived on Zenodo. This DOI will always resolve to the latest release of the book source:
+
+[![DOI](https://zenodo.org/badge/657280462.svg)](https://zenodo.org/badge/latestdoi/657280462)