{"id":13937750,"url":"https://github.com/dankelley/oce","last_synced_at":"2025-04-08T09:10:42.817Z","repository":{"id":844991,"uuid":"570570","full_name":"dankelley/oce","owner":"dankelley","description":"R package for oceanographic processing","archived":false,"fork":false,"pushed_at":"2024-10-14T20:20:17.000Z","size":462548,"stargazers_count":142,"open_issues_count":13,"forks_count":42,"subscribers_count":12,"default_branch":"develop","last_synced_at":"2024-10-29T21:02:01.668Z","etag":null,"topics":["oceanography","r"],"latest_commit_sha":null,"homepage":"http://dankelley.github.io/oce/","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dankelley.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":"codemeta.json"}},"created_at":"2010-03-19T21:23:42.000Z","updated_at":"2024-10-06T17:11:56.000Z","dependencies_parsed_at":"2023-09-28T03:54:19.900Z","dependency_job_id":"1993147f-fdcd-4af6-84d3-aa4328584d66","html_url":"https://github.com/dankelley/oce","commit_stats":{"total_commits":9026,"total_committers":19,"mean_commits":"475.05263157894734","dds":"0.17161533348105473","last_synced_commit":"454cd50a5c6878bfcec5b7c13921a03a707929b7"},"previous_names":[],"tags_count":31,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dankelley%2Foce","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dankelley%2Foce/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dankelley%2Foce/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dankelley%2Foce/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dankelley","download_url":"https://codeload.github.com/dankelley/oce/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247280263,"owners_count":20912967,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["oceanography","r"],"created_at":"2024-08-07T23:03:50.594Z","updated_at":"2025-04-08T09:10:42.810Z","avatar_url":"https://github.com/dankelley.png","language":"R","readme":"\u003c!-- markdownlint-disable MD013 md033 --\u003e\n\n# oce \u003cimg alt=\"oce logo\" src=\"https://raw.githubusercontent.com/dankelley/oce/develop/oce-logo-3.png\" align=\"right\" height=\"95\" /\u003e\n\n\u003c!-- badges: start --\u003e\n\n[![CRAN\\_Status\\_Badge](https://www.r-pkg.org/badges/version/oce)](https://cran.r-project.org/package=oce)\n[![status](https://joss.theoj.org/papers/10.21105/joss.03594/status.svg)](https://joss.theoj.org/papers/10.21105/joss.03594)\n[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](http://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/)\n[![GitHub last commit](https://img.shields.io/github/last-commit/dankelley/oce)](https://img.shields.io/github/last-commit/dankelley/oce)\n[![R-CMD-check](https://github.com/dankelley/oce/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/dankelley/oce/actions/workflows/R-CMD-check.yaml)\n![RStudio CRAN mirror downloads](https://cranlogs.r-pkg.org/badges/last-month/oce)\n![RStudio CRAN mirror downloads](https://cranlogs.r-pkg.org/badges/last-week/oce)\n![RStudio CRAN mirror downloads](https://cranlogs.r-pkg.org/badges/last-day/oce)\n![RStudio CRAN mirror downloads](https://cranlogs.r-pkg.org/badges/grand-total/oce)\n\u003c!-- badges: end --\u003e\n\n## Why use R for oceanographic analysis?\n\nThe R language is popular in many branches of science, and Oceanography is no\nexception. With its broad statistical support, R is a natural choice for\noceanographers in the biological, chemical and geological sub-disciplines.\nHowever, some physical oceanographers have remained attached to Matlab, which\nwas widely adopted during the 1990s. Lately, this has been changing, as\noceanographers turn to open-source systems such as Python and R. A particular\nstrength of R is its provision of many powerful and well-vetted packages for\nhandling specialized calculations. The oce package is a prime example.\n\n## What the oce package provides\n\nThe oce package handles a wide variety of tasks that come up in the analysis of\nOceanographic data. In addition to the present README file, a brief sketch of\nthe package has been written by the core developers (Kelley Dan E., Clark\nRichards and Chantelle Layton, 2022. [oce: an R package for Oceanographic\nAnalysis](https://doi.org/10.21105/joss.03594). Journal of Open Source\nSoftware, 7(71), 3594), and the primary developer uses the package extensively\nin his book about the place of R in oceanographic analysis (Kelley, Dan E.,\n2018. [Oceanographic Analysis with\nR](https://link.springer.com/book/10.1007/978-1-4939-8844-0). New York.\nSpringer-Verlag ISBN 978-1-4939-8844-0).  Details of oce functions are provided\nwithin the R help system, and in the package\n[webpage](https://dankelley.github.io/oce/).\n\n## Installing oce\n\nStable versions of oce are available from CRAN, and may be installed from\nwithin R, in the same way as other packages. However, the CRAN version is only\nupdated a few times a year (pursuant to policy), so many users install the\n`\"develop\"` branch instead. This branch may be updated several times per day,\nas the authors fix bugs or add features that are motivated by day-to-day usage.\nThis is the branch favoured by users who need new features or who would wish to\ncontribute to Oce development.\n\nTo install a `develop` version that is usually under a week old, try using\n\n    install.packages(\"oce\", repos = c(\"https://dankelley.r-universe.dev\", \"https://cloud.r-project.org\"))\n\nwhich does not require that you have compilers for C++, Fortran, etc. on your\nsystem.  However, if you have those things, you can also try building straight\nfrom the github source using\n\n    remotes::install_github(\"dankelley/oce\", ref=\"develop\")\n\n\nNote that most readers should also install Ocedata, with\n\n    remotes::install_github(\"dankelley/ocedata\", ref=\"main\")\n\nwhich does not require compilers for C++, Fortran, etc.\n\n## Evolution of oce\n\nOce is emphatically an open-source system, and so the participation of users is\nvery important. This is why Git is used for version control of the Oce source\ncode, and why GitHub is the host for that code. Users are invited to take part\nin the development process, by suggesting features, by reporting bugs, or just\nby watching as others do such things. Oceanography is a collaborative\ndiscipline, so it makes sense that the evolution of Oce be similarly\ncollaborative.\n\n## Examples using built-in datasets\n\n### CTD\n\n    library(oce)\n    data(ctd)\n    plot(ctd, which=c(1,2,3,5), type=\"l\", span=150)\n\n![Sample CTD plot.](https://raw.githubusercontent.com/dankelley/oce/develop/oce-demo-1.png)\n\n### Acoustic Doppler profiler\n\n    library(oce)\n    data(adp)\n    plot(adp)\n\n![Sample adp plot.](https://raw.githubusercontent.com/dankelley/oce/develop/oce-demo-2.png)\n\n### Sealevel and tides\n\n    library(oce)\n    data(sealevel)\n    m \u003c- tidem(sealevel)\n    par(mfrow=c(2, 1))\n    plot(sealevel, which=1)\n    plot(m)\n\n![Sample sealevel plot.](https://raw.githubusercontent.com/dankelley/oce/develop/oce-demo-3.png)\n\n### Echosounder\n\n    library(oce)\n    data(echosounder)\n    plot(echosounder, which=2, drawTimeRange=TRUE, drawBottom=TRUE)\n\n![Sample echosounder plot.](https://raw.githubusercontent.com/dankelley/oce/develop/oce-demo-4.png)\n\n### Map\n\n    library(oce)\n    par(mar=rep(0.5, 4))\n    data(endeavour, package=\"ocedata\")\n    data(coastlineWorld, package=\"oce\")\n    mapPlot(coastlineWorld, col=\"gray\")\n    mapPoints(endeavour$longitude, endeavour$latitude, pch=20, col=\"red\")\n\n![Sample map plot.](https://raw.githubusercontent.com/dankelley/oce/develop/oce-demo-5.png)\n\n### Landsat image\n\n    library(ocedata)\n    library(oce)\n    data(landsat)\n    plot(landsat)\n\n![Sample landsat image plot.](https://raw.githubusercontent.com/dankelley/oce/develop/oce-demo-6.png)\n","funding_links":[],"categories":["R","Hydrosphere"],"sub_categories":["Ocean and Hydrology Data Access"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdankelley%2Foce","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdankelley%2Foce","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdankelley%2Foce/lists"}