BMI_Tutorial

BMI & Coastal Tutorial

Application scope

The tutorial runs on top of the standard Lower Colorado V4 tutorial directory structure, i.e., it runs entirely in t-route's V4 mode, and with HYfeatures data. Due to its simplicity, the Cedar Bayou example is used to demonstrate the capability and reported on here. The following inputs will need to be collected:

• Cedar Bayou geopackage (of geopackage containing same), e.g., Diff_Texas_CedarBayou_NGENv201.gpkg.
• Coastal boundary input file (in this example, DFLOW output), e.g., coastal_boundary_input_file = boundary_forcing/FlowFM_0000_his.nc
• Coastal domain yaml boundary file, e.g., domain/coastal_domain_LC_US_DS.yaml.
• qlat input forcing files, e.g., qlat_file_pattern_filter = "*.CHRTOUT_DOMAIN1.csv" in a designated qlat_input_folder.
• usgs timeslices and rfc input folders (other gages are not enabled; e.g., usgs_timeslices and rfc_timeseries)

In the main BMI script, reference is made to a dedicated Standard_Coastal_AnA.yaml script. That script needs to be adapted to the aforementioned inputs.

Description of main script

The main script run_BMI_Coastal.py is available in the standard repository of t-route, in the test/LowerColorado_TX_v4 folder. It relies on the following standard and t-route libraries:

Standard libraries:

import sys import glob

import os import numpy as np import pandas as pd import geopandas as gpd import pickle from datetime import datetime, timedelta import time import xarray as xr

T-route repository libraries:

import bmi_troute import bmi_DAforcing from troute.HYFeaturesNetwork import HYFeaturesNetwork from troute.AbstractNetwork import * import bmi_df2array as df2a