What "install" scripts does?:

  • install script is a script that gets library, source and run script files from CVS repository, compiles them and also execute some selected programs. It is also capable of detecting the machine type and sets up compiler options.
    • Firstly, the script create libs directory, cd to it and executes "cvs co libs_gsm" (or libs_rsm for rsm or libs_gdas for gdas and so on).
    • Script edits configure-libs file and change the MACHINE variable based on the machine type, then execute configure-libs
    • Script then execute 'make', which compiles w3-libraries for grib packing/unpacking (w3lib.a) using libs/w3lib_machine directory, model library (modelib.a) and ncar library (ncaru.a). It also compiles utility programs under libs/etc/utils and libs/etc/util_machine directories.
    • Script also uncompresses fixed fields and constants, and convert ascii format file to the machine native format.
    • Secondly, the script creates gsm (rsm, crsm,scm,gdas,roms,...) directory, cd to it and executes "cvs co src_gsm" (or src_rsm, src_gdas, src_roms, ...).
    • The script edits configure-model and change several key variables. These include model and resolution, serial or parallel machine, institution (which determines some of the batch job header files and library locations. Also, some variables (full directory name of the library) are taken from def/sysvars.defs file. The script executes configure-model.
    • Script then execute 'make' to compile various programs. For co2 and mtn program, the compiled programs are executed and generates file necessary for forecast execution for gsm and rsm. co2 program interpolates the climatological co2 profile to model vertical levels. mtn computes grid and spectral topography for global and regional models.
    • Thirdly, the script creates gsm_runs (rsm_runs, ...) directory, cd to it and executes "cvs co scr_gsm" (or scr_rsm or scr_gdas).
    • The script edits configure-scr and change several key variables, including the directory where the model executables exist.
    • The script execute "configure-scr gsm" (or configure-scr rsm or configure-scr gdas). The configure-scr takes one argument, name of the run script. You may find various run scripts in expscr directory.
    • As you see in the above explanations, it is possible to install the model manually by following the steps described above and manually editing the configure-* scripts. The changes required on configure-* scripts are all concentrated at the beginning, and should be clearly marked.
      • install script takes various optional arguments, which can control the way the model system is set up. Type "install --help" to see available options.
      • Similarly, configure-model script takes various optional arguments, which can control how to configure the forecast model.