Kalpana is a Python module to convert ADCIRC output files to geospatial vector formats (shapefile or kmz), and to downscale the maximum water elevations onto a higher-resolution raster.
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).
Kalpana can downscale the maximum water elevations (maxele.63.nc) to a higher-resolution raster by considering small-scale topographic features. This process can provide a more-accurate representation of the inundation extent. 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
Kalpana was updated to python 3 and upgraded by Tomás Cuevas as a part of his MSc research. Instructions for using Kalpana can be found in the examples folder, including a few Jupyter notebooks created by Brandon Tucker. For any question, comment or suggestion please send an email to tomascuevas@gmail.com or open an Issue.