RcamelsCL

Description

RcamelsCL is an R package developed to provide easy and reliable access to the Catchment Attributes and Meteorology for Large Sample Studies – Chile dataset (CAMELS-CL), a widely used benchmark resource for large-sample hydrology and comparative catchment analysis. This package focuses on simplifying the acquisition, organisation, and handling of both spatial and temporal data required for hydrological research and modelling across diverse climatic and physiographic regions of Chile.

It was designed by Héctor Garcés-Figueroa and I to support reproducible scientific workflows. RcamelsCL offers a consistent interface for downloading and managing hydrometeorological time series and catchment attributes directly from the official data repository. By standardising data access and preprocessing steps, the package reduces the time and effort typically required to prepare datasets for analysis, allowing users to focus on model development, hypothesis testing, and large-sample hydrological investigations.

Importantly, RcamelsCL preserves the integrity of the original dataset by providing direct access to the original raw data, without altering their content. This approach ensures transparency and traceability in scientific applications, which is particularly relevant for studies involving benchmarking, model intercomparison, and regional hydrological assessment.

Well suited for research, teaching, and operational analysis, RcamelsCL provides a technically sound and efficient gateway to one of the most comprehensive hydrological datasets available for Chile. It is especially valuable for users seeking a reliable foundation for data-driven hydrological studies and reproducible environmental research.

A simpler way to work with CAMELS-CL

RcamelsCL is an R package built to make the CAMELS-CL dataset easier to use. For hydrologists, that matters because CAMELS-CL (Alvarez-Garreton et al., 2018) has become a key reference for studying how river basins behave across Chile’s wide range of climates and landscapes.

Instead of spending a large amount of time downloading files, reorganizing folders, and cleaning inputs, users can access the CAMELS-CL data through a consistent R workflow designed for research and modelling.

Why CAMELS-CL matters

CAMELS-CL, short for Catchment Attributes and Meteorology for Large Sample Studies – Chile, is one of the Chile’s main benchmark datasets for large-sample hydrology and comparative catchment analysis.

It brings together the kinds of information researchers need to ask big questions, including:

• Hydrometeorological time series
• Catchment attributes
• Datasets spanning diverse climatic and physiographic regions of Chile

That broad coverage makes the dataset especially useful for testing hydrological models, comparing catchments, and exploring how geography and climate shape water availability.

What RcamelsCL does

Developed by Héctor Garcés-Figueroa and me, RcamelsCL was designed to support reproducible scientific workflows end-to-end..

RcamelsCL gives users a reliable way to:

• Download data directly from the official CAMELS-CL repository.
• Organize both spatial and temporal datasets.
• Manage hydrometeorological series and basin attributes through a single interface.
• Reduce repetitive preprocessing steps before analysis begins.

The result is straightforward: less time spent preparing data, and more time spent on model development, hypothesis testing, and hydrological analysis.

Why direct access to raw data is important

One of the package’s strongest features is that it preserves the original dataset exactly as published. RcamelsCL provides access to the raw source CAMELS-CL data without changing its content.

That matters for public trust in science as much as for technical work. When researchers can trace their inputs back to the original repository, it becomes easier to check methods, compare results, and repeat studies with confidence.

This kind of transparency is especially valuable for:

• Benchmarking studies, where researchers need to know they are testing models against the same source material.

• Model intercomparison, to avoid that small preprocessing differences can change model outcomes.

• Regional hydrological assessment, where consistent data handling makes it easier to compare catchments across Chile in a reproducible way.

• Uses beyond specialist research. Although the package is built mostly for the scientific community, its value goes beyond high-level research projects. RcamelsCL is also well suited for:

  • Teaching.
  • Operational analysis.
  • Training in reproducible environmental workflows.

For students, it lowers the barrier to working with real hydrological data. For practitioners, it offers a dependable entry point into one of the most comprehensive catchment datasets available for Chile.

The bigger picture

Hydrology increasingly depends on tools that are not just accurate, but also transparent, repeatable, and efficient. RcamelsCL addresses a basic but important bottleneck: reproducible data access.

By making CAMELS-CL easier to download, organise, and use without altering the original records, the package gives researchers a stronger foundation for data-driven hydrology in Chile. That is a practical contribution with wide reach, from classroom exercises to large-scale environmental assessments.

How to cite it?

• The package should be cited as:

  Garces-Figueroa H., Zambrano-Bigiarini M. (2026). RcamelsCL: Easy Handling of the CAMELS-CL Dataset. R package version 0.2-0, doi:10.32614/CRAN.package.RcamelsCL. https://CRAN.R-project.org/package=RcamelsCL.