Kalpana converts ADCIRC output files in netCDF format to Google Earth (kmz) or GIS shapefiles for use with conventional GIS software. The latest version of the code is maintained at our GitHub repository: https://github.com/ccht-ncsu/Kalpana.
Command line arguments control the way it produces output, including the number of contour levels, their values, and the color scale. When these specifications are absent from the command line, it uses reasonable default settings so in many cases only a few of the available command line options will be used for any particular plot.
In the process of working on Kalpana, one of the deliverables was to clean the code, where possible. The following improvements were made as part of this deliverable.
This document describes the methodology followed in
kalpana.py for the creation of shape file and kml files. The sequence of steps involved has been grouped under related sub-headings for better comprehension. The terms in fixed width font refer to variable names in the code.
The actual script
kalapana.py does not require installation, it is merely executed. However, it relies on several Python modules that most users (or their IT supporters) will need to install before working with Kalpana. These modules are:
matplotlib– main python module used for data visualization.
pylab– Imports plotting and numerics libraries in a single name space.
shapely– used to construct geometric objects like Points, Polygons and LineStrings.
fiona– for writing .shp files.
netCDF4– reading and writing netCDF files.
datetime– dates and time calculation, manipulation, and formatting.
time– contains time related functions for measuring the performance of the code itself.
numpy– to facilitate scientific computing; used primarily in Kalpana for working with n-dimensional
numpyarrays, which are ideal for storing large amounts of data.
collections– accessing OrderedDict, which is a dictionary subclass that remembers the order in which entries were added, whereas an ordinary dictionary does not do so).
simplekml– writing kml (Google Earth) files.
In the process of installing Python modules on a desktop platform, as well as an HPC platform, I’ve found that the process can be very challenging. The biggest issue is conflicting module version dependencies, which can be handled by the use of virtual execution environments for Python (explained below).
R Cyriac, JC Dietrich, A Fathi, CN Dawson, KM Dresback, M Bilskie, SC Hagen, H Graber. “Modeling 3D Circulation in the Choctawhatchee Bay and River System.” ADCIRC Users Group Meeting, US Army Engineer Research and Development Center, Coastal and Hydraulics Laboratory, Vicksburg, Mississippi, 05 May 2016.
A Thomas, JC Dietrich, JG Fleming, BO Blanton, RA Luettich Jr. “Optimizing the Placement of Unstructured Mesh Resolution for ADCIRC in Coastal Regions.” ADCIRC Users Group Meeting, US Army Engineer Research and Development Center, Coastal and Hydraulics Laboratory, Vicksburg, Mississippi, 06 May 2016.