PISCO_GR2M v2.0 - README

============================================================
DESCRIPTION
============================================================
PISCO_GR2M v2.0 is a national-scale hydrological dataset
providing simulated monthly streamflow across Peru.

The dataset was developed using:
- PISCO gridded precipitation and temperature datasets
- GR2M rainfall-runoff model
- river routing model

It provides continuous monthly discharge estimates for 11,913
river reaches (COMIDs), covering Peru and transboundary basins.

============================================================
DATA COMPONENTS
============================================================

1) NetCDF file
   - PISCO_GR2M_v2.0.nc

2) River network (vector)
   - riv_pisco_GR2M_v2.0.gpkg

3) Catchments (vector)
   - cat_pisco_GR2M_v2.0.gpkg

============================================================
NETCDF DATA STRUCTURE
============================================================

Format: NetCDF (.nc)
Temporal resolution: monthly
Units: m3/s

Variables:

- comid
  Unique identifier of river reaches (COMID)

- time
  Time dimension (days since 1970-01-01, UTC)

- flow
  Simulated monthly streamflow (m3/s)
  Dimensions: [time x comid]

Notes:
- Flow values correspond to routed discharge using RAPID
- Time is stored as UNIX time (seconds since 1970-01-01)

============================================================
SPATIAL DATA STRUCTURE
============================================================

All spatial data are provided in GeoPackage (.gpkg) format.

------------------------------------------------------------
1) River Network (riv_pisco_GR2M_v2.0.gpkg)
------------------------------------------------------------

Geometry: Line (river reaches)

Main attributes typically include:

- COMID
  Unique river reach identifier (links with NetCDF)

- Length / Length_km
  River reach length

- Upstream / Downstream IDs
  Connectivity within the river network

- Other hydraulic/topologic attributes may be included

Purpose:
- Defines the routing network used by RAPID
- Enables visualization and mapping of streamflow

------------------------------------------------------------
2) Catchments (cat_pisco_GR2M_v2.0.gpkg)
------------------------------------------------------------

Geometry: Polygon (subbasins)

Main attributes typically include:

- COMID
  Unique identifier matching the river reach outlet

- Area / Area_km2
  Catchment area

- Other physiographic attributes (if included)

Purpose:
- Defines contributing areas for each river reach
- Used for spatial aggregation and analysis

============================================================
LINK BETWEEN DATASETS
============================================================

The key linkage across all datasets is:

COMID

- NetCDF: identifies time series of streamflow
- River network: spatial location of flow
- Catchments: contributing drainage area

============================================================
ABBREVIATIONS
============================================================

PISCO    : Peruvian Interpolated data of SENAMHI observations
ARNOVIC  : ARNO/VIC hydrological model implementation
RAPID    : Routing Application for Parallel Computation of Discharge
COMID    : Unique identifier for river reaches

============================================================
NOTES AND LIMITATIONS
============================================================

- Streamflow values are simulated, not direct observations
- Model calibrated using 43 gauging stations (1981–2020)
- Suitable for regional and national-scale applications
- Local-scale use requires validation with observed data
- Uncertainty may increase in small catchments or ungauged regions

============================================================
ADDITIONAL RESOURCES
============================================================

COMID finder:
https://hllauca.github.io/PISCO_HyD_ARNOVIC_map/Identificar_COMID.html

HydroShare resource:
https://www.hydroshare.org/resource/f1b537f338f24533af5dab946b51d215/

============================================================
AUTHOR
============================================================

Harold Llauca
SENAMHI - Peru
hllauca@senamhi.gob.pe

============================================================