v3.3 update

epri-dev · Dec 8, 2021 · 3817f50 · 3817f50
1 parent 250df1a
commit 3817f50
Show file tree

Hide file tree

Showing 16 changed files with 61 additions and 47 deletions.
diff --git a/3002016526 Technical Documentation.pdf b/3002016526 Technical Documentation.pdf
diff --git a/3002016526 User's Guide.pdf b/3002016526 User's Guide.pdf
diff --git a/3002022845 Support Document.pdf b/3002022845 Support Document.pdf
diff --git a/3002022845 Technical Documentation.pdf b/3002022845 Technical Documentation.pdf
diff --git a/3002022845 Users Guide.pdf b/3002022845 Users Guide.pdf
diff --git a/README-Build-Instructions.txt b/README-Build-Instructions.txt
@@ -1,9 +1,9 @@
-Date: 26 November 2019 
+Date: 18 November 2021
 
 Developer contact information:  
 
  1) Douglas Henn  
-    Sage-Xator  
+    Xator  
     3836 Quakerbridge Road
     Suite 102
     Princeton  
@@ -28,25 +28,25 @@ Developer contact information:
 
 **Computer system requirements to recompile software:**  
   Linux 64 bit system (x68_64) with Intel Fortran compiler for standard build  
-  Windows 7 or above with Intel Fortran and C compilers for advanced build  
+  Windows 8 or above with Intel Fortran and C compilers for advanced build  
 
 **Steps to recompile software**  
 
   *Regular build on 64-bit Linux system:*  
-  1) Unzip the tgz file on a Linux system using:  
-         $ tar -xzvf SCICHEM-3.2.2-Binary.tgz  
+  1) Unzip the tar file on a Linux system using:  
+         $ tar -xvf SCICHEM-3.3-Binary.tar
   2) Change to build directory:  
          $ cd build/linux  
   3) Run build script:  
          $ bash makeall.sh  
   4) The executable and shared library files listed below will be created  
   under the build/linux/ifort directory as well as copied to bin/linux:  
-         metsci, tersci, runsci, sciDOSpost, scipp, srf2smp, smp2post,  
+         metsci, tersci, runsci, sciDOSpost, scipp  
 
 
   *Advanced build on 32-bit or 64-bit Linux/Unix system**:  
-  1) Unzip the tgz file on a Linux/Unix system using:  
-         $ tar -xzvf SCICHEM-3.2.2-Binary.tgz
+  1) Unzip the tar file on a Linux/Unix system using:  
+         $ tar -xvf SCICHEM-3.3-Binary.tar
   2) Download the NETCDF library version 4.1.2 or later as source code  
   or static libraries for the system from  
   [NETCDF Homepage](http://www.unidata.ucar.edu/software/netcdf)  
@@ -69,30 +69,30 @@ Developer contact information:
        $ bash makeall.sh  
   9) The executable and shared library files listed below will be created  
      under the build/linux/ifort directory as well as copied to bin/linux:  
-      metsci, tersci, runsci, sciDOSpost, scipp, srf2smp, smp2post,  
+      metsci, tersci, runsci, sciDOSpost, scipp  
 
 *The information is provided to the user for convenience.  
 However, the code has not been tested extensively with other compilers or systems.  
 
  *Regular build on 64-bit Windows system**:  
 
-  Note: Only project files for Intel compiler with Visual Studio 2013 is provided  
+  Note: Only project files for Intel compiler with Visual Studio 2013 are provided  
   for building the SCIPUFFgui executable for Windows.  
 
-  1) Unzip the tgz file "SCICHEM-3.2.2-Binary.tgz" on the Windows system.  
+  1) Unzip the tar file "SCICHEM-3.3-Binary.tar" on the Windows system using 7-Zip.  
   2) Open the EPRI.sln solution file with Visual Studio 2013.  
   3) Include the NETCDF and HDF library path in the include path for the projects.  
   4) Build the executable files.  
   5) The executable and dynamic library files listed below should be created:  
    metsci.exe, tersci.exe, runsci.exe , SCIPUFFgui.exe, sciDOSpost.exe,  
-   scipp.exe, srf2smp.exe, smp2post.exe,swim.dll, systool.dll, landuse.dll, messages.dll and SCIPtool.dll  
+   scipp.exe, swim.dll, systool.dll, landuse.dll, messages.dll and SCIPtool.dll  
 
  *Advanced build on 64-bit Windows system**:  
 
   Note: Only project files for Intel compiler with Visual Studio 2013 is provided  
   for building the SCIPUFFgui executable for Windows.  
 
-  1) Unzip the tgz file "SCICHEM-3.2.2-Binary.tgz" on the Windows system.  
+  1) Unzip the tar file "SCICHEM-3.3-Binary.tar" on the Windows system using 7-Zip.  
   2) Download the NETCDF library version 4.1.2 or later as source code or  
   static libraries for the system from  
   [NETCDF Homepage](http://www.unidata.ucar.edu/software/netcdf)  
@@ -107,7 +107,7 @@ However, the code has not been tested extensively with other compilers or system
   6) Build the executable files.  
   7) The executable and dynamic library files listed below should be created:  
    metsci.exe, tersci.exe, runsci.exe , SCIPUFFgui.exe, sciDOSpost.exe,  
-   scipp.exe, srf2smp.exe, smp2post.exe,swim.dll, systool.dll, landuse.dll, messages.dll and SCIPtool.dll  
+   scipp.exe, swim.dll, systool.dll, landuse.dll, messages.dll and SCIPtool.dll  
 
 *The information is provided to the user for convenience. However, the code has  
 not been tested extensively for other versions of Visual Studio or systems.  

diff --git a/README-Download-Instructions.txt b/README-Download-Instructions.txt
diff --git a/README-Examples.txt b/README-Examples.txt
@@ -0,0 +1,26 @@
+Examples provided with the SCICHEM 3.3 package
+
+Brief descriptions of the four example cases provided with the  
+distribution are given below. The examples are hypothetical and  
+are provided for illustrative purposes so that the user can test  
+the setup of the model and run through the tutorials. For additional  
+details please refer to the "Tutorial" section (Appendix A) of the User's Guide.
+
+1) so2_2005: This is an annual 1-hour SO2 example with no chemistry and a  
+hypothetical SO2 source. This example uses keyword format input files.
+
+2) no2_mc_2005: This is an annual 1-hour NO2 example with an optimized NO-NO2-O3  
+chemistry mechanism for near-source calculations and a hypothetical NOx source.  
+This example also uses keyword format input files.
+
+3) tva: This is a one-day case study with the full photochemical mechanism (CB6r2)  
+and hypothetical SO2 and NOx emissions for power plant plume impacts on downwind ozone.  
+The example uses the location of the TVA Cumberland power plant located in northwestern  
+Tennessee. This example uses namelist type input files.
+c
+4) SW_ss: This is a multi-day power plant plume case study with the full  
+photochemical mechanism and aerosol and aqueous-phase chemistry for ozone  
+and secondary PM2.5 impacts. This example uses 3-D meteorology fields based on WRF  
+outputs processed with MMF and hypothetical SO2 and NOx emissions. The power plant
+is located in the Four Corners region in the southwestern US. This example uses namelist
+type input files.
diff --git a/README.txt b/README.txt
@@ -1,9 +1,7 @@
 
-This repository utilizes Git LFS to serve large files - please follow the README-Download-Instructions.txt file in order to access these files.
+**SCICHEM 3.3**  
 
-**SCICHEM 3.2.2**  
-
-SCICHEM 3.2.2 is a reactive puff model that can be used to calculate  
+SCICHEM 3.3 is a reactive puff model that can be used to calculate  
 single or multi-source impacts of emissions at downwind locations.  The  
 model can be used for both short-range calculations (for example,  
 1-hour SO2, 1-hour NO2, 24-hour secondary PM2.5, or 8-hour ozone  
@@ -32,25 +30,24 @@ package includes the following:
 
 This distribution includes a limited version of a Graphical User  
 Interface (GUI), named "SCIPUFFgui, which is provided for the 64-bit  
-Windows 7 or higher operating system as an aid to the user for  
+Windows 8 or higher operating system as an aid to the user for  
 visualization of model results. The GUI can plot concentration contour  
 plots for surface, horizontal, or vertical slices for all source types.  
 Note that SCIPUFFgui can also be used to create and run SCICHEM   
 namelist-type projects. Note that it does not generate keyword-type
-projects (introduced in SCICHEM 3.x) and cannot be
-used to define some new source types such as area and volume  
-sources. Thus, users are recommended to use the GUI primarily for  
-viewing simulation results. 
+projects (introduced in SCICHEM 3.x) and cannot be used to define  area
+sources. It is recommended to use the GUI primarily for viewing simulation
+results or modifying input from existing projects. 
 
 This distribution consists of three readme files, namely "README.txt"  
 (this file),README-Examples.txt and "READMe-Build-Instructions.txt", 
-three documents, "3002016526 User's Guide.pdf" and "3002016526 Technical
-Documentation.pdf" and "3002016526 Support Document.pdf" and the following
+three documents, "3002022845 User's Guide.pdf" and "3002022845 Technical
+Documentation.pdf" and "3002022845 Support Document.pdf" and the following
 four zipped files (to limit the size of the individual zipped files):
 
--	SCICHEM-3.2-Binary.tar  
--	SCICHEM-3.2-Examples.tar  
--	SCICHEM-3.2-FC_MEDOC.tgz
+-	SCICHEM-3.3-Binary.tar  
+-	SCICHEM-3.3-Examples.tar  
+-	SCICHEM-3.3-FC_MEDOC.tgz
 -   CTM2SCICHEM.tar
 
 All the files should be unzipped in the same directory. These can be
@@ -61,7 +58,7 @@ directory and landuse.dat file point to the correct directory on the
 User's system. Details for running the SCIPUFFgui on Windows is  
 provided in the User's Guide.  
 
-Building downwash in SCICHEM 3.2 is based on PRIME (Schulman et al., 2000). 
+Building downwash in SCICHEM 3.3 is based on PRIME (Schulman et al., 2000). 
 PRIME has not been updated in over 15 years, and has been shown to overpredict 
 concentrations by factors of 2 to 8 for certain building types (Petersen et al., 2017). 
 New treatments for building downwash are being developed (Petersen et al., 2017)  
@@ -73,7 +70,7 @@ from the BPIPPRM output in the SO section. See the User's guide for details.
 
 The Mesoscale Model Interface Program (MMIF) on the U.S. EPA SCRAM web  
 site can be used to convert prognostic meteorological model (MM5 and/or  
-WRF) outputs to SCICHEM ready meteorological  inputs. SCICHEM 3.2  
+WRF) outputs to SCICHEM ready meteorological  inputs. SCICHEM 3.2 or later  
 requires MMIF version 3.4 or later for compatibility.  
 
 This is a full release that has been tested for a number of conditions.  
@@ -83,7 +80,7 @@ Intel compiler. For users interested in building the executable files
 on Linux or Windows machines, build scripts and Visual Fortran project  
 files for the Intel compiler are provided. Users can create builds  
 using other compilers but builds with non-Intel compilers have not been  
-tested at this time.  
+tested.  
 
 Additional details and user instructions are provided in the documents  
 bundled with the package. Users are requested to offer feedback to EPRI  
@@ -117,7 +114,7 @@ the surface deposition and dosage files, and calculate output (averaged
 concentrations, deposition, visibility obscuration) at arbitrary
 receptors (i.e. not specified before the SCICHEM run). For samplers
 that are not at the surface (e.g., at locations corresponding to
-aircraft measurements), the user can give SCICHEM a maximum of 500
+aircraft measurements), the user can define a maximum of 5000
 sampling locations.  
 
 3) The large scale variance type (ENSM_TYPE) should be set to none for  

diff --git a/SCICHEM-3.2-FC_MEDOC.tgz → SCICHEM-3.3-FC_MEDOC.tgz b/SCICHEM-3.2-FC_MEDOC.tgz → SCICHEM-3.3-FC_MEDOC.tgz
diff --git a/SCICHEM3.2.2-Examples.tar b/SCICHEM3.2.2-Examples.tar
diff --git a/SCICHEM3.2.2-binary.tar b/SCICHEM3.2.2-binary.tar
diff --git a/SCICHEM3.2.2_BugFixes.docx b/SCICHEM3.2.2_BugFixes.docx
diff --git a/SCICHEM3.3-Examples.tar b/SCICHEM3.3-Examples.tar
diff --git a/SCICHEM3.3-binary.tar b/SCICHEM3.3-binary.tar
diff --git a/SCICHEM3.3_Updates.pdf b/SCICHEM3.3_Updates.pdf