Getting Started with copernicusR
In copernicusR: R Interface to Copernicus Marine Service

Note: The code examples below are not evaluated (eval = FALSE) to comply with CRAN policies.
They require internet access, user credentials for Copernicus Marine Service,
and external Python dependencies, which are not permitted to run automatically in CRAN checks.

knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  eval = FALSE
)

This vignette shows how to set up and use copernicusR to access Copernicus Marine data.

Prerequisites

Before using this package, ensure that: 1. You have Python 3.7 or higher installed on your system. 2. You have a free Copernicus Marine account and valid credentials. 3. The copernicusmarine Python package is installed (handled via setup_copernicus()).

Basic Setup

library(copernicusR)

# Check if everything is ready
copernicus_is_ready()

# Set up using your credentials (replace with your actual values)
setup_copernicus(username = "<your_username>", password = "<your_password>")

Download Example

# Download sea surface temperature
file <- copernicus_download(
  dataset_id = "cmems_mod_glo_phy_anfc_0.083deg_P1D-m",
  variables = "thetao",
  start_date = "2024-01-01",
  end_date = "2024-01-01",
  bbox = c(-10, 0, 35, 45),  # Mediterranean subset
  output_file = file.path(tempdir(), "test_download.nc")
)