Skip to content

ccht-ncsu/Kalpana

Repository files navigation

Kalpana is a Python module to convert ADCIRC outputs to geospatial vector formats (shapefile or kmz), and to downscale the maximum water elevations onto a higher-resolution raster

ADCIRC to geospatial vector formats

Kalpana can convert time-varying outputs (e.g. fort.63.nc, swan_HS.63.nc) and time-constant outputs (maxele.63.nc) into polylines or polygons in both shapefile and kmz formats. Kalpana was developed originally by Rosemary Cyriac, and her efforts were aided by the work of Rich Signell and Rusty Holleman to generate shapefiles from ADCIRC results. Then, Jason Fleming improved Kalpana and incorporated it into the ADCIRC Surge Guidance System (ASGS).

Downscaling

By considering small-scale topographic features, Kalpana can downscale the maximum water elevations (maxele.63.nc) to a higher-resolution raster. This process can provide a more accurate representation of the extent of the inundation. As part of the downscaling, the water surface can be expanded outward to intersect with the ground surface, beyond the extent predicted by ADCIRC. This expansion can be done in two ways: the static method was developed by Nelson Tull, and then the head-loss method was developed by Carter Rucker. The details can be found in this paper. The schematics below show the downscaling process.

Storm surge expansion

Storm surge contraction

Updated version

Kalpana was updated to Python 3 and upgraded by Tomás Cuevas as a part of his MSc research. The details can be found in his thesis. Instructions for using Kalpana can be found in the examples folder, including a few Jupyter notebooks created by Brandon Tucker and Tomás. For any questions, comments, or suggestions, please send an email to tomascuevas@gmail.com or open an Issue.

License

This software is published under the GPLv3 license.

Citation

Paper:
Rucker, C.A., Tull, N., Dietrich, J.C., Langan, T.E., Mitasova, H., Blanton, B.O., Fleming, J.G. and Luettich, R.A., 2021. Downscaling of real-time coastal flooding predictions for decision support. Natural Hazards, 107, pp.1341-1369.

Installation

We recommend creating a separate conda environment to install Kalpana. The details are provided in the install folder.