Visualization

Kalpana User Guide


Kalpana is a python script that converts ADCIRC output files to GIS compatible shapefiles. The code accepts NetCDF formatted ADCIRC outputs for maximum water levels and wind speeds (maxele.63.nc and maxwvel.63.nc) and converts these to polyline/polygon shapefiles.

More information regarding Kalpana can be found at: https://ccht.ccee.ncsu.edu/how-to-run-kalpana/.


How to Submit a Kalpana Job in the Workspace

You will have to fill out a form to submit your job that asks multiple information as follows:

  1. Working Directory:
    This is the directory that contains the ADCIRC simulation NetCDF file to be converted. You can either drag and drop the directory from Data depot browser on the left or use select button.
     
  2. File type:
    The Kalpana software on DesignSafe is capable to convert two NetCDF file types.
    (a) maxele.63.nc for maximum water levels,
    (b) maxwvel.63.nc for maximum wind speeds.
     
  3. Vector shape:
    Vector shape can be selected from a dropdown menu to be (a) polyline or (b) polygon.
     
  4. Contour type and Contour information:
    If you select contourrange for contour type, the contour information should be provided in this format 'min max interval' (e.g. '0 5 0.5').
     
    If you select contourlevel for contour type, the contour information should be provided as a custom set of contour levels (e.g. '0 1 2 3 4 5 6 7 8 9 10 11 12'). Please note that the selection of contour values depends on the range of your simulation output.

Next enter a job name and an output archive location or use the default provided. Now, click Run to submit your job.

You can track the status of your job to the right side of the same page. The status will change from “Pending” to “Staged”, “Submitting” and “Running”. These processes usually take about 1 to 2 minutes.

Once the status changed to “FINISHED”, you can find the outputs in data depot by navigating to the archived location. If not specified by the user, the job output including the converted shapefile can be found at: My Data / archive / jobs / ${YYYY-MM-DD} / ${JOB_NAME}-${JOB_ID}

 

Last update: May 23, 2019