Skip to content

Texas Bridge - Flood Warning Cross Section Web Server

License

Notifications You must be signed in to change notification settings

mdbartos/tx-bridge-xs

 
 

Repository files navigation

TX-BRIDGE-XS tx-bridge agency

Texas Bridge - Flood Warning Cross Section Web Server

tx-bridge logo

Description: A database of simplified bridge geometry was extracted from statewide LiDAR and DEMs for the State of Texas. From the bridge database, it was necessary to produce interactive graphics estimating water depths for more than 19,000 bridges across Texas on an hourly basis, providing an eighteen-hour advance prediction. These graphics are used to indicate instances when a bridge's superstructure, including beams and deck, may be at risk of flooding.

Each cross section is cross-referenced with both the National Bridge Inventory database and the National Weather Service’s National Water Model (NWM) stream reach. Anticipated stream flows from the National Water Model are then converted into predictions of flood depths.

sample cross section

Flask Server

This Flask server hosts interactive Plotly graphics displaying a 'bridge envelope'. Each bridge features a synthetic rating curve, depicting depth versus flow rate, and is associated with a specific National Water Model stream reach that it crosses.

flask server diagram

Sample URL

http:https://127.0.0.1:5000/xs/?uuid=526fdf7e-d1e6-4e21-ba1c-2b43825a0deb&list_flows=0,0,0,0,0,0,0,100,1000,5000,28000,42000,50000,45000,42000,35000,30000,25000&first_utc_time=2023-10-26T02:00:00



Another server, separate from this repository, is designed to perform two tasks: 1) retrieve forecasted short-range flows for the specified National Water Model reach per bridge, and 2) generate continuously updated URLs for the bridge cross-sections.

Dockerfile

To build a container from this repository, clone to your local drive and build with the following command

docker build -t tx-bridge-xs .

Docker Container

For convience, a container has been pre-built and pushed to DockerHub. To pull this container to your machine...

docker pull civileng127/tx-bridge-xs:20240223

To run this container, use the following command

docker run -e AWS_ACCESS_KEY_ID=<your_access_key> -e AWS_SECRET_ACCESS_KEY=<your_secret_access-key> -p 5000:5000 civileng127/tx-bridge-xs:20240223

Note that this container will need to have your AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY as command line environment inputs. Additionally, the Dockerfile/Docker Container has an environmental variable for the bucket containing the bridge jsons ... ENV PATH_TO_BRIDGE_JSONS="s3:https://tx-bridge-xs-json/"

Misc

Before initializing the web server, a JSON file is generated for each bridge and stored in an S3 bucket. This process is facilitated by a script called 'create_bridge_json_files.py', located in the misc folder. The script converts the bridge SQLite database, generated using 'TX-Bridge' for the State of Texas, into separate JSON files for each UUID. Currently, the database is hosted on S3 at the location s3:https://txbridge-data/test-upload/tx-bridge-geom.sqlite.

About

Texas Bridge - Flood Warning Cross Section Web Server

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages

  • Python 96.8%
  • Dockerfile 2.0%
  • HTML 1.2%