search

CEMPD / SMOKE

Create emissions inputs for multiple air quality modeling systems with unmatched speed and flexibility
https://www.cmascenter.org/smoke/
45 stars 21 forks source link

provide additional "How to Use SMOKE" documentation #56

Open cseppan opened 1 year ago

cseppan commented 1 year ago

As part of the SMOKE v4.9 release, chapters specific to the old Assigns file and run scripts were removed from the SMOKE User's Guide (v4.9 guide). This how-to guidance needs to be updated based on the Emissions Modeling Platform scripts and made available to users, possibly on the SMOKE GitHub site or through the CMAS wiki.

old chapters from the SMOKE v4.8.1 User's Guide SMOKE Directory Structure How to Use SMOKE Source Code and Include Files Downloading, Installing, and Compiling SMOKE

The CMAS wiki has a page detailing the 2011v6.3 package: https://www.airqualitymodeling.org/index.php/SMOKE-NEI-Platform6.3

Each platform provides similar information in a text file: 2016v1 2016v2 2017

cseppan commented 1 year ago

Revised the main SMOKE page on the CMAS wiki: https://www.airqualitymodeling.org/index.php/SMOKE

Added pages for

2016v2: https://www.airqualitymodeling.org/index.php/2016v2_Emissions_Modeling_Platform 2017: https://www.airqualitymodeling.org/index.php/2017_Emissions_Modeling_Platform

christos-e commented 1 year ago

Sections 12.2 and 12.3 can be simply replaced by the git clone command of the SMOKE repo.

The previous information in section 12.4 is still relevant on RHEL8 standard Linux distributions with respect to installing IOAPI. Note that some Linux variants do not use the same standards and that possibly confuse users (i.e. Debian).

Once the user has the IOAPI and SMOKE repo setup, the Makeinclude file ind the src directory needs to be modified according to the user's SMK_HOME, BIN, IOBASE, INSTDIR.

From Architecture perspective the user needs to specify compiler-specific choices which may require additional flags for specific hardware.

Regarding netcdf-4 the user may need to include NFDIR and NCDIR library paths explicitly: i.e:

IOLIB = -L$(IOBIN) -lioapi -L${NFDIR}/lib -lnetcdff -L${NCDIR}/lib -lnetcdf

The next step would be to proceed with issuing the Make command, and verify the compiled objects can be found in INSTDIR.