climenv

climenv: download, extract and visualise climatic and elevation data

https://github.com/jamestsakalos/climenv

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.5%) to scientific vocabulary
Last synced: 10 months ago · JSON representation

Repository

climenv: download, extract and visualise climatic and elevation data

Basic Info
Statistics
  • Stars: 4
  • Watchers: 2
  • Forks: 2
  • Open Issues: 1
  • Releases: 0
Created about 3 years ago · Last pushed over 1 year ago
Metadata Files
Readme Changelog Codemeta

README.Rmd

---
output: github_document
---

[![codemeta](https://github.com/jamestsakalos/climenv/actions/workflows/codemeta.yml/badge.svg)](https://github.com/jamestsakalos/climenv/actions/workflows/codemeta.yml)
[![lint](https://github.com/jamestsakalos/climenv/actions/workflows/lint.yaml/badge.svg)](https://github.com/jamestsakalos/climenv/actions/workflows/lint.yaml)
[![pkgdown](https://github.com/jamestsakalos/climenv/actions/workflows/pkgdown.yml/badge.svg)](https://github.com/jamestsakalos/climenv/actions/workflows/pkgdown.yml)
[![R-CMD-check](https://github.com/jamestsakalos/climenv/actions/workflows/R-CMD-check.yml/badge.svg)](https://github.com/jamestsakalos/climenv/actions/workflows/R-CMD-check.yml)
[![test-coverage](https://github.com/jamestsakalos/climenv/actions/workflows/test-coverage.yaml/badge.svg)](https://github.com/jamestsakalos/climenv/actions/workflows/test-coverage.yaml)
[![Codecov test coverage](https://codecov.io/gh/jamestsakalos/climenv/branch/master/graph/badge.svg)](https://app.codecov.io/gh/jamestsakalos/climenv?branch=master)




```{r, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/README-",
  out.width = "100%"
)
```

# climenv

R functions for downloading, extracting, and plotting climatological data as a 
function of user supplied multi and single geospatial polygon and point data.

## Description

If you are a scientist seeking a convenient solution for downloading, extracting
, and plotting climatological data, consider exploring the features of this 
package. It grants you access to three widely recognised modelled data sets, 
namely WorldClim 2, CHELSA, and NASA’s SRTM. It seamlessly handles both multi 
and single geospatial polygon and point data, allowing you to extract outputs 
that can serve as covariates in various ecological studies. It also allows you 
to visualise these extractions using two common graphic options – the 
Walter-Lieth climate diagram and the Holdridge life zone classification scheme. 
The last option is a scheme of our own design which incorporates aspects of both
Walter-Leigh and Holdridge. The package's user-friendly access and extraction of
globally recognisable data sets significantly enhance its versatility and 
usability across a broad spectrum of applications.

For any questions, comments or bug reports please submit an issue here on GitHub.
Suggestions, ideas and references of new algorithms are always welcome.

## News

* June-2023: Version 1.0.0

## Main functionalities

* Downloads climate data from two main sources;
  * CHELSA, short for "Climatologies at High resolution for the Earth's Land 
  Surface Areas," encompasses a high-resolution gridded dataset containing 
  extensive climate data, including temperature and precipitation for the period
  1981–2010
  * WorldClim 2, short for "World Climate", is a comprehensive global dataset 
  offers fine-scale gridded climate data including temperature and precipitation
  for the period 1970–2000
* Downloads elevation data from two main sources;
  * SRTM, which stands for 'Shuttle Radar Topography Mission,' refers 
  specifically to the hole-filled CGIAR-SRTM dataset, providing 90-meter 
  resolution elevation data for the Earth's surface within latitudes ranging 
  from -60 to 60 degrees
  * Mapzen's synthesis digital elevation product which combines several sources 
  of digital elevation models, including SRTM, the ArcticDEM (covering all 
  areas north of 60°), EUDEM (digital elevation model over Europe)
* Extracts the data;
  * as raw data for points
  * as zonal statistics for a group of points or over a spatial extent (polygon)

## Installation from the source

You can install the development version from [GitHub](https://github.com/jamestsakalos/climenv) with:

``` r
# install.packages("devtools")
devtools::install_github("jamestsakalos/climenv", build_vignettes = TRUE)
```
## Example

This is a basic example which shows you how to use the main `climenv` function:

```{r fig1, fig.width = 16, fig.height = 8, fig.align = "center"}
library(climenv)

# Step 1. Import the Sibillini National Park Boundary
# Step 2. Run the download function
# Step 3. Run the extract function
#* See ce_download & ce_extract documentation

# Steps 1, 2 & 3 can be skipped by loading the extracted data
data("it_data")

# Step 4. Visualise the climatic envelope using a Holdridge diagram
p1 <- plot_h(data = it_data, "MED")
```


The package vignette provides detailed explanation and demonstration on
the application of climenv.

Owner

  • Name: James Tsakalos
  • Login: jamestsakalos
  • Kind: user
  • Location: Italy

I am a researcher in the Scuola di Bioscienze e Medicina Veterinaria at the University of Camerino.

CodeMeta (codemeta.json)

{
  "@context": "https://doi.org/10.5063/schema/codemeta-2.0",
  "@type": "SoftwareSourceCode",
  "identifier": "climenv",
  "description": "Grants access to three widely recognised modelled data sets, namely Global Climate Data (WorldClim 2), Climatologies at high resolution for the earth's land surface areas (CHELSA), and National Aeronautics and Space Administration's (NASA) Shuttle Radar Topography Mission (SRTM). It handles both multi and single geospatial polygon and point data, extracts outputs that can serve as covariates in various ecological studies. Provides two common graphic options – the Walter-Lieth (1960) <https://donum.uliege.be/bitstream/2268.1/7079/1/Walter-Lieth_Klimadiagramm-Weltatlas.pdf> climate diagram and the Holdridge (1967) <https://reddcr.go.cr/sites/default/files/centro-de-documentacion/holdridge_1966_-_life_zone_ecology.pdf> life zone classification scheme. Provides one new graphic scheme of our own design which incorporates aspects of both Walter-Leigh and Holdridge. Provides user-friendly access and extraction of globally recognisable data sets to enhance their usability across a broad spectrum of applications.",
  "name": "climenv: Download, Extract and Visualise Climate and Elevation Data",
  "codeRepository": "https://github.com/jamestsakalos/climenv",
  "issueTracker": "https://github.com/jamestsakalos/climenv/issues",
  "license": "https://spdx.org/licenses/GPL-3.0",
  "version": "1.0.0.9000",
  "programmingLanguage": {
    "@type": "ComputerLanguage",
    "name": "R",
    "url": "https://r-project.org"
  },
  "runtimePlatform": "R version 4.3.3 (2024-02-29)",
  "provider": {
    "@id": "https://cran.r-project.org",
    "@type": "Organization",
    "name": "Comprehensive R Archive Network (CRAN)",
    "url": "https://cran.r-project.org"
  },
  "author": [
    {
      "@type": "Person",
      "givenName": "James L.",
      "familyName": "Tsakalos",
      "email": "jamestsakalos@gmail.com",
      "@id": "https://orcid.org/0000-0001-5067-196X"
    },
    {
      "@type": "Person",
      "givenName": "Martin R.",
      "familyName": "Smith",
      "email": "martin.smith@durham.ac.uk",
      "@id": "https://orcid.org/0000-0001-5660-1727"
    },
    {
      "@type": "Person",
      "givenName": "Federico",
      "familyName": "Luebert",
      "@id": "https://orcid.org/0000-0003-2251-4056"
    },
    {
      "@type": "Person",
      "givenName": "Ladislav",
      "familyName": "Mucina",
      "@id": "https://orcid.org/0000-0003-0317-8886"
    }
  ],
  "copyrightHolder": [
    {
      "@type": "Person",
      "givenName": "James L.",
      "familyName": "Tsakalos",
      "email": "jamestsakalos@gmail.com",
      "@id": "https://orcid.org/0000-0001-5067-196X"
    }
  ],
  "maintainer": [
    {
      "@type": "Person",
      "givenName": "James L.",
      "familyName": "Tsakalos",
      "email": "jamestsakalos@gmail.com",
      "@id": "https://orcid.org/0000-0001-5067-196X"
    }
  ],
  "softwareSuggestions": [
    {
      "@type": "SoftwareApplication",
      "identifier": "covr",
      "name": "covr",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=covr"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "fs",
      "name": "fs",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=fs"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "knitr",
      "name": "knitr",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=knitr"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "progress",
      "name": "progress",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=progress"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "raster",
      "name": "raster",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=raster"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "rmarkdown",
      "name": "rmarkdown",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=rmarkdown"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "testthat",
      "name": "testthat",
      "version": ">= 0.2.0",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=testthat"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "vdiffr",
      "name": "vdiffr",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=vdiffr"
    }
  ],
  "softwareRequirements": {
    "1": {
      "@type": "SoftwareApplication",
      "identifier": "R",
      "name": "R",
      "version": ">= 4.1.0"
    },
    "2": {
      "@type": "SoftwareApplication",
      "identifier": "climaemet",
      "name": "climaemet",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=climaemet"
    },
    "3": {
      "@type": "SoftwareApplication",
      "identifier": "dismo",
      "name": "dismo",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=dismo"
    },
    "4": {
      "@type": "SoftwareApplication",
      "identifier": "dplyr",
      "name": "dplyr",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=dplyr"
    },
    "5": {
      "@type": "SoftwareApplication",
      "identifier": "elevatr",
      "name": "elevatr",
      "version": ">= 0.99",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=elevatr"
    },
    "6": {
      "@type": "SoftwareApplication",
      "identifier": "exactextractr",
      "name": "exactextractr",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=exactextractr"
    },
    "7": {
      "@type": "SoftwareApplication",
      "identifier": "geodata",
      "name": "geodata",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=geodata"
    },
    "8": {
      "@type": "SoftwareApplication",
      "identifier": "glue",
      "name": "glue",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=glue"
    },
    "9": {
      "@type": "SoftwareApplication",
      "identifier": "methods",
      "name": "methods"
    },
    "10": {
      "@type": "SoftwareApplication",
      "identifier": "plyr",
      "name": "plyr",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=plyr"
    },
    "11": {
      "@type": "SoftwareApplication",
      "identifier": "randomForest",
      "name": "randomForest",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=randomForest"
    },
    "12": {
      "@type": "SoftwareApplication",
      "identifier": "sf",
      "name": "sf",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=sf"
    },
    "13": {
      "@type": "SoftwareApplication",
      "identifier": "sp",
      "name": "sp",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=sp"
    },
    "14": {
      "@type": "SoftwareApplication",
      "identifier": "Ternary",
      "name": "Ternary",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=Ternary"
    },
    "15": {
      "@type": "SoftwareApplication",
      "identifier": "terra",
      "name": "terra",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=terra"
    },
    "SystemRequirements": null
  },
  "fileSize": "1757.901KB",
  "citation": [
    {
      "@type": "ScholarlyArticle",
      "datePublished": "2023",
      "author": [
        {
          "@type": "Person",
          "givenName": "James Lee",
          "familyName": "Tsakalos"
        },
        {
          "@type": "Person",
          "givenName": "Martin Ross",
          "familyName": "Smith"
        },
        {
          "@type": "Person",
          "givenName": "Federico",
          "familyName": "Luebert"
        },
        {
          "@type": "Person",
          "givenName": "Ladislav",
          "familyName": "Mucina"
        }
      ],
      "name": "climenv: download, extract and visualise climatic and elevation data",
      "description": "R package version 1.0.0.9000",
      "isPartOf": {
        "@type": "PublicationIssue",
        "datePublished": "2023",
        "isPartOf": {
          "@type": [
            "PublicationVolume",
            "Periodical"
          ],
          "name": "Journal of Vegetation Science"
        }
      }
    }
  ]
}

GitHub Events

Total
  • Issues event: 1
  • Watch event: 1
  • Issue comment event: 1
  • Push event: 4
Last Year
  • Issues event: 1
  • Watch event: 1
  • Issue comment event: 1
  • Push event: 4

Packages

  • Total packages: 1
  • Total downloads:
    • cran 223 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 1
  • Total maintainers: 1
cran.r-project.org: climenv

Download, Extract and Visualise Climate and Elevation Data

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 223 Last month
Rankings
Dependent packages count: 28.9%
Dependent repos count: 36.9%
Average: 50.9%
Downloads: 86.8%
Maintainers (1)
Last synced: about 1 year ago

Dependencies

.github/workflows/R-CMD-check.yml actions
  • actions/checkout v3 composite
  • r-lib/actions/check-r-package v2 composite
  • r-lib/actions/setup-pandoc v2 composite
  • r-lib/actions/setup-r v2 composite
  • r-lib/actions/setup-r-dependencies v2 composite
.github/workflows/codemeta.yml actions
  • ms609/actions/codemeta main composite
.github/workflows/lint.yaml actions
  • actions/checkout v3 composite
  • r-lib/actions/setup-r v2 composite
  • r-lib/actions/setup-r-dependencies v2 composite
.github/workflows/pkgdown.yml actions
  • ms609/actions/pkgdown main composite
.github/workflows/test-coverage.yaml actions
  • actions/checkout v3 composite
  • actions/upload-artifact v3 composite
  • r-lib/actions/setup-r v2 composite
  • r-lib/actions/setup-r-dependencies v2 composite
DESCRIPTION cran
  • R >= 4.1.0 depends
  • Ternary * imports
  • climaemet * imports
  • dismo * imports
  • dplyr * imports
  • elevatr * imports
  • exactextractr * imports
  • geodata * imports
  • glue * imports
  • macroBiome * imports
  • plyr * imports
  • randomForest * imports
  • sf * imports
  • sp * imports
  • terra * imports
  • covr * suggests
  • fs * suggests
  • knitr * suggests
  • raster * suggests
  • rmarkdown * suggests
  • testthat >= 3.0.0 suggests
  • vdiffr * suggests