Developers Guide

Information also appears in the corresponding code directories.

Installing

We have provided a script installcalpuff.sh that performs a simple wget, unzip and tidy up of the required model code from src.com

Code modifications

Code modifications are provided in CALPUFF_CODE_MODS - makecodemods.sh takes these modifications and symbolically links them.

A description of the modifications made can be found here.

• terrel mods
• ctgproc mods
• makegeo mods
• calmet mods
• calpuf mods including hourly output

Compiling (Intel)

This automatically done when the exe files are not there by Run.sh/ Run_ext.sh

CALPUFF ONLY (extra step)

# CALPUFF ONLY 1st step
ifort -c modules.for

ifort -O0 -fltconsistency <mainFortranFile>.f -o <mainFortranFile>_intel.exe.

• -O0 – Don’t perform any optimisation (compilation will be fast, executable will be slow)
• fltconsistency Perform floating-point operations in strict conformance with the IEEE 754 standard.

Other compilers have been investigated. But are not available as of yet. (Requires a different code mod)

Future Plan CALPUFF_MODS_INTEL and CALPUFF_MODS_OPEN will provide user with 2 different options

Inputs

After including the required code changes outlined in CALPUFF_MODS

inp files

• terrel.inp
• ctgproc.inp
• makegeo.inp
• calmet.inp
• calpuf.inp

data

• Topography files
• Land Use Files
• Wind Files
• masaya.dat – generated by TERREL
• lulc1km_masaya.dat – The land-use generated by CTGPROC
• geo_masaya.dat – generated by MAKEGEO.
• calmet.dat - generated by CALMET

Visualization

Brief overview below

• full guide in process here

Python Tools

Run.sh automatically runs the Python vizualisation tools.

Static Site image viewer.

In VIZ SITE CODE the folder public html contains a fully developed static site build through JavaScript, HTML and css designed to view the days forecast. This can be hosted on a web server or simply viewed via a light weight python web server.

• css - custom style files
• fonts - custom fonts
• images - banners, icons, etc
• _includes - common html code to multiple pages e.g. naviation bar etc.
• index.html - Landing page.
• js - Javascript library for animating, loading in the days images etc
• UNRESP_VIZ - folder containing image archive,

This code will work out of the box with Run.sh or can be adapted for other purposes.