extractoz

{extractOz}: Get local attribute information from GPS points for Australian agricultural research

https://github.com/dpird-fsi/extractoz

Science Score: 36.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
✓
Committers with academic emails
1 of 4 committers (25.0%) from academic institutions
○
Institutional organization owner
○
JOSS paper metadata
○
Scientific vocabulary similarity
Low similarity (17.6%) to scientific vocabulary

Keywords

agriculture agriculture-data agriculture-research agroecology australia r-package soils soils-data weather weather-data

Keywords from Contributors

animal climate interpretability standardization hack weather-api weather-forecast

Last synced: 9 months ago · JSON representation

Repository

{extractOz}: Get local attribute information from GPS points for Australian agricultural research

Basic Info

Host: GitHub
Owner: DPIRD-FSI
License: gpl-3.0
Language: R
Default Branch: main
Homepage: https://dpird-fsi.github.io/extractOz/
Size: 40 MB

Statistics

Stars: 5
Watchers: 3
Forks: 1
Open Issues: 0
Releases: 10

Topics

agriculture agriculture-data agriculture-research agroecology australia r-package soils soils-data weather weather-data

Created about 4 years ago · Last pushed almost 2 years ago

Metadata Files

Readme Changelog License Code of conduct Codemeta

README.Rmd

---
title: ""
output: github_document
---

# {extractOz}: A Unified Approach to Extracting Data About Australian Locations Using GPS Points 


[![codecov](https://codecov.io/gh/DPIRD-FSI/extractOz/branch/main/graph/badge.svg?token=PBtL3rNIYb)](https://codecov.io/gh/DPIRD-FSI/extractOz)
[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
[![R-CMD-check](https://github.com/DPIRD-FSI/extractOz/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/DPIRD-FSI/extractOz/actions/workflows/R-CMD-check.yaml)


Extract the GRDC agroecological zone, major soil order and weather data from your GPS sampling points.
Datasets for the GRDC agroecological zones and functions that automatically download modified data from the Digital Atlas of Australian Soils are included in this package for ease of use.
You may also use your own geospatial vector format file to extract similar information using the generic function, `extract_area()`.

## Quick Start

You can install {extractOz} like so.

```{r setup, eval=FALSE}
if (!require("remotes")) {
  install.packages("remotes")
}

remotes::install_github("DPIRD-FSI/extractOz", build_vignettes = TRUE)
```

Load the packages necessary to execute the examples that follow.

```{r load-libs}
library(extractOz)
library(dplyr)
```

## Create Locations in WA and NSW

```{r create-locs}
locs <- list(
  "Merredin" = c(x = 118.28, y = -31.48),
  "Corrigin" = c(x = 117.87, y = -32.33),
  "Tamworth" = c(x = 150.84, y = -31.07)
)
```

## Extract the GRDC AgroEcological Zones

See `?extract_ae_zone()` for more help on how to use this function.

```{r az-zone}
z <- extract_ae_zone(x = locs)
```

## Extract the Soil Order

See `?extract_soil_order()` for more help on how to use this function.

```{r soil-order}
s <- extract_daas_soil_order(x = locs)
```

## Get Weather Data for These Locations in 2020

Using the previously used list of GPS points, fetch weather data from SILO for 2020.
This is just a non-working example, replace `your_api_key` with your email address below.
See `?extract_patched_point()` for more help on how to use this function.

### A Note on API Keys

The examples in this README assume that you have stored your API key in your .Renviron file.
See [Chapter 8](https://rstats.wtf/r-startup.html#renviron) in "What They Forgot to Teach You About R" by Bryan _et al._ for more on storing details in your .Renviron if you are unfamiliar.

```{r ppd}
three_sites <-
  extract_patched_point(
    x = locs,
    start_date = "20200101",
    end_date = "20201231",
    api_key = Sys.getenv("SILO_API_KEY")
  )
```

## Join the Weather Data with AE Zone, Soil Order and Site Information

Now using `dplyr::left_join()`, create a single `data.frame()` of the location, GPS coordinates, agroecological zone and weather data.

```{r join-all}
left_join(z, three_sites, by = c(
  "location" = "location",
  "x" = "x",
  "y" = "y"
)) %>%
  left_join(s)
```

## Code of Conduct

Please note that the {extractOz} project is released with a [Contributor Code of Conduct](https://contributor-covenant.org/version/2/0/CODE_OF_CONDUCT.html).
By contributing to this project, you agree to abide by its terms.

Owner

Name: DPIRD Farming Systems Innovation
Login: DPIRD-FSI
Kind: organization
Location: Australia

Website: https://dpird.wa.gov.au/
Twitter: DPIRDWA
Repositories: 2
Profile: https://github.com/DPIRD-FSI

GitHub home for projects in the Department of Primary Industries and Regional Development (DPIRD) of Western Australia Farming Systems Innovation Directorate

CodeMeta (codemeta.json)

{
  "@context": "https://doi.org/10.5063/schema/codemeta-2.0",
  "@type": "SoftwareSourceCode",
  "identifier": "extractOz",
  "description": "Extracts point data for a given GPS coordinate that includes major soil order, weather and GRDC agro-ecological zone information at that point.",
  "name": "extractOz: Extract Australian Soil, Weather and GRDC Agro-ecological Zone Information from GPS Points",
  "relatedLink": "https://dpird-fsi.github.io/extractOz/",
  "codeRepository": "https://github.com/DPIRD-FSI/extractOz",
  "issueTracker": "https://github.com/DPIRD-FSI/extractOz/issues",
  "license": "https://spdx.org/licenses/GPL-3.0",
  "version": "1.1.8",
  "programmingLanguage": {
    "@type": "ComputerLanguage",
    "name": "R",
    "url": "https://r-project.org"
  },
  "runtimePlatform": "R version 4.4.1 (2024-06-14)",
  "author": [
    {
      "@type": "Person",
      "givenName": "Adam H.",
      "familyName": "Sparks",
      "email": "adam.sparks@dpird.wa.gov.au",
      "@id": "https://orcid.org/0000-0002-0061-8359"
    },
    {
      "@type": "Person",
      "givenName": "Rodrigo",
      "familyName": "Pires",
      "email": "rodrigo.pires@dpird.wa.gov.au",
      "@id": "https://orcid.org/0000-0001-7384-6849"
    }
  ],
  "copyrightHolder": [
    {
      "@type": "Organization",
      "name": "Western Australia Agriculture Authority (WAAA)"
    },
    {
      "@type": "Organization",
      "name": "Grains Research and Development Corporation"
    }
  ],
  "funder": [
    {
      "@type": "Organization",
      "name": "Grains Research and Development Corporation"
    }
  ],
  "maintainer": [
    {
      "@type": "Person",
      "givenName": "Rodrigo",
      "familyName": "Pires",
      "email": "rodrigo.pires@dpird.wa.gov.au",
      "@id": "https://orcid.org/0000-0001-7384-6849"
    }
  ],
  "softwareSuggestions": [
    {
      "@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": "readr",
      "name": "readr",
      "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=readr"
    },
    {
      "@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": "roxyglobals",
      "name": "roxyglobals",
      "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=roxyglobals"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "spelling",
      "name": "spelling",
      "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=spelling"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "testthat",
      "name": "testthat",
      "version": ">= 3.0.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": "tidyverse",
      "name": "tidyverse",
      "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=tidyverse"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "vcr",
      "name": "vcr",
      "version": ">= 0.6.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=vcr"
    }
  ],
  "softwareRequirements": {
    "1": {
      "@type": "SoftwareApplication",
      "identifier": "curl",
      "name": "curl",
      "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=curl"
    },
    "2": {
      "@type": "SoftwareApplication",
      "identifier": "data.table",
      "name": "data.table",
      "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=data.table"
    },
    "3": {
      "@type": "SoftwareApplication",
      "identifier": "httr",
      "name": "httr",
      "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=httr"
    },
    "4": {
      "@type": "SoftwareApplication",
      "identifier": "methods",
      "name": "methods"
    },
    "5": {
      "@type": "SoftwareApplication",
      "identifier": "nasapower",
      "name": "nasapower",
      "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=nasapower"
    },
    "6": {
      "@type": "SoftwareApplication",
      "identifier": "purrr",
      "name": "purrr",
      "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=purrr"
    },
    "7": {
      "@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"
    },
    "8": {
      "@type": "SoftwareApplication",
      "identifier": "stats",
      "name": "stats"
    },
    "9": {
      "@type": "SoftwareApplication",
      "identifier": "utils",
      "name": "utils"
    },
    "10": {
      "@type": "SoftwareApplication",
      "identifier": "weatherOz",
      "name": "weatherOz"
    },
    "11": {
      "@type": "SoftwareApplication",
      "identifier": "R",
      "name": "R",
      "version": ">= 4.0.0"
    },
    "SystemRequirements": null
  },
  "applicationCategory": "Tools",
  "isPartOf": "https://www.dpird.wa.gov.au/",
  "keywords": [
    "agriculture",
    "Australia",
    "agroecology",
    "soils",
    "weather",
    "weather-data",
    "soils-data",
    "agriculture-research",
    "r-package",
    "agriculture-data",
    "australia"
  ],
  "fileSize": "1350.501KB",
  "releaseNotes": "https://github.com/DPIRD-FSI/extractOz/blob/master/NEWS.md",
  "readme": "https://github.com/DPIRD-FSI/extractOz/blob/main/README.md",
  "contIntegration": [
    "https://github.com/DPIRD-FSI/extractOz/actions",
    "https://codecov.io/gh/DPIRD-FSI/extractOz"
  ],
  "developmentStatus": "https://www.repostatus.org/#active"
}

GitHub Events

Total

Issues event: 2
Member event: 1

Last Year

Issues event: 2
Member event: 1

Committers

Last synced: 10 months ago

All Time

Total Commits: 313
Total Committers: 4
Avg Commits per committer: 78.25
Development Distribution Score (DDS): 0.067

Past Year

Commits: 114
Committers: 3
Avg Commits per committer: 38.0
Development Distribution Score (DDS): 0.167

Top Committers

Name	Email	Commits
Adam H. Sparks	a**s@i**m	292
Adam H. Sparks	a**s@c**u	18
github-actions[bot]	4****]	2
Adam Sparks	A**s@d**u	1

Committer Domains (Top 20 + Academic)

dpird.wa.gov.au: 1 curtin.edu.au: 1

Issues and Pull Requests

Last synced: 10 months ago

All Time

Total issues: 13
Total pull requests: 8
Average time to close issues: 6 months
Average time to close pull requests: 9 days
Total issue authors: 2
Total pull request authors: 1
Average comments per issue: 1.38
Average comments per pull request: 0.25
Merged pull requests: 8
Bot issues: 0
Bot pull requests: 0

Past Year

Issues: 0
Pull requests: 0
Average time to close issues: N/A
Average time to close pull requests: N/A
Issue authors: 0
Pull request authors: 0
Average comments per issue: 0
Average comments per pull request: 0
Merged pull requests: 0
Bot issues: 0
Bot pull requests: 0

View more stats

Top Authors

Issue Authors

adamhsparks (11)
kaibagley (1)

Pull Request Authors

adamhsparks (10)

Top Labels

Issue Labels

enhancement (7) bug (1) wontfix (1)

Pull Request Labels

Packages

Total packages: 2
Total downloads: unknown

Total dependent packages: 0
(may contain duplicates)
Total dependent repositories: 0
(may contain duplicates)
Total versions: 26

proxy.golang.org: github.com/DPIRD-FSI/extractOz

Documentation: https://pkg.go.dev/github.com/DPIRD-FSI/extractOz#section-documentation
License: gpl-3.0
Latest release: v1.1.18
published almost 2 years ago

Versions: 13
Dependent Packages: 0
Dependent Repositories: 0

Rankings

Dependent packages count: 5.4%

Average: 5.6%

Dependent repos count: 5.8%

Last synced: 9 months ago

proxy.golang.org: github.com/dpird-fsi/extractoz

Documentation: https://pkg.go.dev/github.com/dpird-fsi/extractoz#section-documentation
License: gpl-3.0
Latest release: v1.1.18
published almost 2 years ago

Versions: 13
Dependent Packages: 0
Dependent Repositories: 0

Rankings

Dependent packages count: 5.4%

Average: 5.6%

Dependent repos count: 5.8%

Last synced: 9 months ago

Dependencies

DESCRIPTION cran

R >= 4.0.0 depends
cropgrowdays * imports
curl * imports
httr * imports
sf * imports
utils * imports
knitr * suggests
rmarkdown * suggests
spelling * suggests
testthat >= 3.0.0 suggests
tidyverse * suggests

.github/workflows/tic.yml actions

actions/checkout v3 composite
actions/upload-artifact v2 composite
pat-s/always-upload-cache v3 composite
r-lib/actions/setup-pandoc v2 composite
r-lib/actions/setup-r v2 composite
r-lib/actions/setup-tinytex v2 composite

.github/workflows/update-tic.yml actions

actions/checkout v3 composite
peter-evans/create-pull-request v4 composite
r-lib/actions/setup-r v2 composite