bakaano.plot_runoff

Plotting utilities for routed runoff outputs.

Role: Visualize routed runoff maps and time series.

class bakaano.plot_runoff.RoutedRunoff(working_dir, study_area)[source]

Bases: object

interactive_plot_routed_runoff_timeseries(start_date, end_date, grdc_netcdf=None, lookup_csv=None, id_col='id', lat_col='latitude', lon_col='longitude')[source]

Interactive wrapper: lists available station_ids and prompts user to select one.

Parameters:

  • start_date (str) – Start date (YYYY-MM-DD).

  • end_date (str) – End date (YYYY-MM-DD).

  • grdc_netcdf (str, optional) – GRDC NetCDF path with station coordinates.

  • lookup_csv (str, optional) – Station lookup CSV path.

  • id_col (str) – Station id column name in lookup CSV.

  • lat_col (str) – Latitude column name in lookup CSV.

  • lon_col (str) – Longitude column name in lookup CSV.

Returns:

None. Displays a matplotlib plot.

map_routed_runoff(date, vmax=8)[source]

Map routed runoff for a specific date.

Parameters:

  • date (str) – Date string (YYYY-MM-DD) matching runoff output keys.

  • vmax (float) – Max value for color scaling (log1p).

Returns:

None. Displays a matplotlib plot.

plot_routed_runoff_timeseries(start_date, end_date, station_id=None, lat=None, lon=None, grdc_netcdf=None, lookup_csv=None, id_col='id', lat_col='latitude', lon_col='longitude')[source]

Plot routed runoff time series for one or more stations or coordinates.

Provide either:

  • station_id with grdc_netcdf OR lookup_csv, or

  • lat/lon directly.

Returns:

None. Displays a matplotlib plot.