Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

oce

An R package for oceanographic processing.
https://github.com/dankelley/oce

Category: Hydrosphere
Sub Category: Ocean and Hydrology Data Access

Keywords

oceanography r

Keywords from Contributors

teos-10

Last synced: about 6 hours ago
JSON representation

Repository metadata

R package for oceanographic processing

README.md

oce

CRAN_Status_Badge
status
Project Status: Active – The project has reached a stable, usable state and is being actively developed.
GitHub last commit
R-CMD-check
RStudio CRAN mirror downloads
RStudio CRAN mirror downloads
RStudio CRAN mirror downloads
RStudio CRAN mirror downloads

Why use R for oceanographic analysis?

The R language is popular in many branches of science, and Oceanography is no
exception. With its broad statistical support, R is a natural choice for
oceanographers in the biological, chemical and geological sub-disciplines.
However, some physical oceanographers have remained attached to Matlab, which
was widely adopted during the 1990s. Lately, this has been changing, as
oceanographers turn to open-source systems such as Python and R. A particular
strength of R is its provision of many powerful and well-vetted packages for
handling specialized calculations. The oce package is a prime example.

What the oce package provides

The oce package handles a wide variety of tasks that come up in the analysis of
Oceanographic data. In addition to the present README file, a brief sketch of
the package has been written by the core developers (Kelley Dan E., Clark
Richards and Chantelle Layton, 2022. oce: an R package for Oceanographic
Analysis. Journal of Open Source
Software, 7(71), 3594), and the primary developer uses the package extensively
in his book about the place of R in oceanographic analysis (Kelley, Dan E.,
2018. Oceanographic Analysis with
R. New York.
Springer-Verlag ISBN 978-1-4939-8844-0). Details of oce functions are provided
within the R help system, and in the package
webpage.

Installing oce

Stable versions of oce are available from CRAN, and may be installed from
within R, in the same way as other packages. However, the CRAN version is only
updated a few times a year (pursuant to policy), so many users install the
"develop" branch instead. This branch may be updated several times per day,
as the authors fix bugs or add features that are motivated by day-to-day usage.
This is the branch favoured by users who need new features or who would wish to
contribute to Oce development.

To install a develop version that is usually under a week old, try using

install.packages("oce", repos = c("https://dankelley.r-universe.dev", "https://cloud.r-project.org"))

which does not require that you have compilers for C++, Fortran, etc. on your
system. However, if you have those things, you can also try building straight
from the github source using

remotes::install_github("dankelley/oce", ref="develop")

Note that most readers should also install Ocedata, with

remotes::install_github("dankelley/ocedata", ref="main")

which does not require compilers for C++, Fortran, etc.

Evolution of oce

Oce is emphatically an open-source system, and so the participation of users is
very important. This is why Git is used for version control of the Oce source
code, and why GitHub is the host for that code. Users are invited to take part
in the development process, by suggesting features, by reporting bugs, or just
by watching as others do such things. Oceanography is a collaborative
discipline, so it makes sense that the evolution of Oce be similarly
collaborative.

Examples using built-in datasets

CTD

library(oce)
data(ctd)
plot(ctd, which=c(1,2,3,5), type="l", span=150)

Sample CTD plot.

Acoustic Doppler profiler

library(oce)
data(adp)
plot(adp)

Sample adp plot.

Sealevel and tides

library(oce)
data(sealevel)
m <- tidem(sealevel)
par(mfrow=c(2, 1))
plot(sealevel, which=1)
plot(m)

Sample sealevel plot.

Echosounder

library(oce)
data(echosounder)
plot(echosounder, which=2, drawTimeRange=TRUE, drawBottom=TRUE)

Sample echosounder plot.

Map

library(oce)
par(mar=rep(0.5, 4))
data(endeavour, package="ocedata")
data(coastlineWorld, package="oce")
mapPlot(coastlineWorld, col="gray")
mapPoints(endeavour$longitude, endeavour$latitude, pch=20, col="red")

Sample map plot.

Landsat image

library(ocedata)
library(oce)
data(landsat)
plot(landsat)

Sample landsat image plot.

Owner metadata

GitHub Events

Total
Last Year

Committers metadata

Last synced: 8 days ago

Total Commits: 9,145
Total Committers: 18
Avg Commits per committer: 508.056
Development Distribution Score (DDS): 0.169

Commits in past year: 198
Committers in past year: 2
Avg Commits per committer in past year: 99.0
Development Distribution Score (DDS) in past year: 0.01

Name Email Commits
Dan Kelley k****n@g****m 7596
Dan.Kelley@Dal.Ca D****y@D****a@3****5 1068
Clark Richards c****s@g****m 251
dan.kelley@dal.ca d****y@d****a@3****5 126
Pablo Valdés p****4@g****m 49
Jaimie Harbin j****6@d****a 19
akrenner m****r@n****v 8
jkennel j****l@u****a 5
Dan Kelley k****y@D****l 5
Chantelle c****3@h****m 4
Chisholm C****E@E****a 3
Dan Kelley k****y@e****a 3
Anna Victor 1****8 2
Jeff Jackson X****c 2
Andrew Barna a****a@g****m 1
SvenGastauer s****r@p****u 1
Dirk Eddelbuettel e****d@d****g 1
Zak Varty 4****y 1

Committer domains:

Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 2,168
Total pull requests: 134
Average time to close issues: about 1 month
Average time to close pull requests: 1 day
Total issue authors: 140
Total pull request authors: 13
Average comments per issue: 5.07
Average comments per pull request: 1.79
Merged pull request: 126
Bot issues: 0
Bot pull requests: 0

Past year issues: 106
Past year pull requests: 0
Past year average time to close issues: 6 days
Past year average time to close pull requests: N/A
Past year issue authors: 11
Past year pull request authors: 0
Past year average comments per issue: 4.65
Past year average comments per pull request: 0
Past year merged pull request: 0
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/dankelley/oce

Top Issue Authors

  • dankelley (1,425)
  • richardsc (420)
  • j-harbin (44)
  • clayton33 (35)
  • atcogswell (8)
  • MichaelFolkes (8)
  • EOGrady21 (8)
  • janstrauss1 (6)
  • Bokoyea (6)
  • koRneel82 (6)
  • Vinterwoo (5)
  • zacharywestbrown (4)
  • Xandac (4)
  • tomvanengeland (4)
  • edwardpmorris (4)

Top Pull Request Authors

  • richardsc (98)
  • j-harbin (9)
  • dankelley (5)
  • Xandac (4)
  • pablovaldes (3)
  • akrenner (3)
  • clayton33 (3)
  • EOGrady21 (3)
  • SvenGastauer (2)
  • eddelbuettel (1)
  • zakvarty (1)
  • DocOtak (1)
  • avictor88 (1)

Top Issue Labels

  • graphics (293)
  • ctd (281)
  • development (245)
  • request (215)
  • adp (151)
  • mapping (138)
  • bug (131)
  • section (95)
  • reporter recheck requested (89)
  • high priority (85)
  • argo (81)
  • enhancement (62)
  • adv (62)
  • I/O (57)
  • ODF (51)
  • for next CRAN (51)
  • low priority (44)
  • documentation (41)
  • ad2cp (41)
  • rsk (40)
  • landsat (34)
  • imagep (29)
  • tidem (29)
  • flags (28)
  • pinned (25)
  • stale (24)
  • advice:programming (22)
  • coastline (21)
  • amsr (19)
  • sw (18)

Top Pull Request Labels

  • rsk (2)
  • ODF (1)
  • colormap (1)

Package metadata

cran.r-project.org: oce

Analysis of Oceanographic Data

  • Homepage: https://dankelley.github.io/oce/
  • Documentation: http://cran.r-project.org/web/packages/oce/oce.pdf
  • Licenses: GPL-2 | GPL-3 [expanded from: GPL (≥ 2)]
  • Latest release: 0.1.74 (published over 16 years ago)
  • Last Synced: 2025-04-29T15:05:44.402Z (1 day ago)
  • Versions: 68
  • Dependent Packages: 13
  • Dependent Repositories: 33
  • Downloads: 2,462 Last month
  • Docker Downloads: 1,466
  • Rankings:
    • Forks count: 1.719%
    • Stargazers count: 3.024%
    • Dependent packages count: 4.248%
    • Dependent repos count: 4.631%
    • Downloads: 6.557%
    • Average: 6.665%
    • Docker downloads count: 19.814%
  • Maintainers (1)
conda-forge.org: r-oce

  • Homepage: http://dankelley.github.com/oce/
  • Licenses: GPL-3.0-only
  • Latest release: 0.9_20 (published over 2 years ago)
  • Last Synced: 2025-04-29T15:05:52.328Z (1 day ago)
  • Versions: 13
  • Dependent Packages: 1
  • Dependent Repositories: 2
  • Rankings:
    • Dependent repos count: 20.06%
    • Average: 26.646%
    • Forks count: 27.282%
    • Dependent packages count: 28.954%
    • Stargazers count: 30.287%

Dependencies

.github/workflows/R-CMD-check.yaml 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/draft-pdf.yml actions
  • actions/checkout v2 composite
  • actions/upload-artifact v1 composite
  • openjournals/openjournals-draft-action master composite
DESCRIPTION cran
  • R >= 2.15 depends
  • gsw * depends
  • methods * depends
  • utils * depends
  • Rcpp * imports
  • DBI * suggests
  • R.utils * suggests
  • RSQLite * suggests
  • XML * suggests
  • automap * suggests
  • foreign * suggests
  • interp * suggests
  • knitr * suggests
  • lubridate * suggests
  • ncdf4 * suggests
  • ocedata * suggests
  • rmarkdown * suggests
  • sf * suggests
  • sp * suggests
  • terra * suggests
  • testthat >= 3.0.0 suggests
  • tiff * suggests

Score: 16.293404677334436