1 / 22

Building CCSM2.0

Building CCSM2.0. Brian Kauffman CCSM Software Engineering Group ccsm@ucar.edu. Building the CCSM - overview. The CCSM directory structure The build environment The execution directory Input data positioning Building executables interactively These slides follow the

corina
Download Presentation

Building CCSM2.0

An Image/Link below is provided (as is) to download presentation Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author. Content is provided to you AS IS for your information and personal use only. Download presentation by click this link. While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server. During download, if you can't get a presentation, the file might be deleted by the publisher.

E N D

Presentation Transcript

  1. Building CCSM2.0 Brian Kauffman CCSM Software Engineering Group ccsm@ucar.edu

  2. Building the CCSM - overview • The CCSM directory structure • The build environment • The execution directory • Input data positioning • Building executables interactively These slides follow the “Building the CCSM” section of the “CCSM2.0 User’s Guide”

  3. The CCSM Directory Structure • scripts/ contains one or more sets of run scripts for various simulations • models/ contains the CCSM2.0 src code used in the various simulations

  4. …/ccsm2.0/scripts/ In the scripts/ directory we find… • test.a1/ - example run scripts provided • tools/ - utils used by run scripts • gui_run/ - script that runs the gui • case.X1/ - additional, user-created • case.Y2/ run scripts

  5. …/ccsm2.0/scripts/test.a1/ In the test.a1/ directory we find… • test.a1 …master run script • atm.setup.csh …setup scripts for • cpl.setup.csh component models • *.setup.csh • RESUBMIT …used for auto-resubmit • ccsm_archive …output file archiver • test.a1.har …output file harvester

  6. $SCRIPTS The run script sets an env variable that specifies where the run and setup scripts are located. Eg. in test.a1.run we have… $SCRIPTS = /usr/jdoe/ccsm2.0/scripts/test.a1 Or, more accurately… $CSMROOT = /usr/jdoe/ccsm2.0 $CASE = test.a1 $SCRIPTS = $CSMROOT/scripts/$CASE

  7. run script, env vars, setup scripts A user executes a master run script (eg. test.a1.run) which in turn calls several component model “setup scripts,” one for each component model The run script sets certain env variables that are sent to the setup scripts, much like input arguments in a subroutine call. These env variables are used to coordinate and control the behavior of the setup scripts. For example, $CSMBLD specifies a makefile location, thus allowing all component model setup scripts to use the same makefile!

  8. …/ccsm2.0/models/ In the models/ directory we find… • atm/ - code for atmosphere models • ice/, lnd/, ocn/ - code for other models • cpl/ - code for the coupler • bld/ - makefile & related • csm_share/ - code shared by components • camclm_share/ - code shared by cam & clm • utils/ - code for utils, eg. esmf

  9. …/ccsm2.0/models/atm/ In the models/atm/ directory we find the source code for three atmosphere models… • cam/ - source code for CAM • datm5/ - source code for datm5 • latm5/ - source code for latm5 Similarly, there are multiple ice, land, and ocean component models.

  10. …/models/bld/ In the bld/ directory we find… • Makefile …generic makefile • Macros.AIX …machine specific • Macros.IRIX64 macros definitions • makdep.c …dependency generator This is the one makefile and dependency generator used to build all CCSM components. $CSMBLD = $CSMROOT/models/bld

  11. …/bld/Makefile The Makefile is a machine-independenttemplate -- machine-specific details are provide by a macro-definitions files. Eg. the Makefile contains generic commands like… $(FC) $(FFLAGS) $(INCDIR) $*.f90

  12. …/bld/Macros.* Macros files specify a set of machine-dependent macros needed by the generic Makefile. Eg. Macros.AIX might define… • FC = mpxlf90_r • FFLAGS = -03 -qstrict -qtune=auto • INCLDIR = -I/usr/lpp/ppe.poe/include …whereas Macros.IRIX64 will define this macros appropriately for an SGI O2K

  13. …/bld/Macros.<your local machine> Macros files specify a set of machine-dependent macros. We provide macros files for several machines, but when it comes to your home-town supercomputer, you’re on your own! Eg. Macros.<???> defines… • FC = <???> • FFLAGS = <???> • INCLDIR = <???> • etc.

  14. …/bld/makdep.c $CSMBLD also contains a dependency generator, makdep.c, this identifies common dependencies such as F90’s use module & include, and cpp #include This is extremely useful, especially for code development & hacking.

  15. Filepath The Makefile uses a source code search path defined in a file called “Filepath” created by the setup scripts. For example, its contents might be… /usr/jdoe/ccsm2.0/scripts/test.a1/src.cpl /usr/jdoe/ccsm2.0/models/cpl/cpl5 /usr/jdoe/ccsm2.0/models/csm_share

  16. Filepath & $VPATH • The Filepath file is used to define gnu-make’s $VPATH variable • The “current working directory” is always the first path in $VPATH • The makefile makes a list of all *.c, *.F90, and *.F files found in the search path -- all of these files will be compiled. • If more than one file with the same name exist, the first file found with that name will be compiled -- all others will be ignored. • The order of the paths in Filepath is the same order that gmake/$VPATH will use.

  17. gmake So CCSM has a common build env, with a command line that looks like… unix> gmake -j 6 -f $CSMBLD/Makefile \ MACFILE=Macros.AIX \ VPFILE=Filepath \ THREAD = TRUE \ EXEC=$EXEDIR/cpl

  18. $EXEDIR Atmosphere component model is built here… • $EXEROOT/atm/obj/*.o • $EXEROOT/atm/obj/Filepath …but executable will be located one level up… • $EXEROOT/atm/atm Similar for all other component models. Note, for example, • $EXEROOT = /scratch/jdoe/test.a1

  19. Input data positioning A component model setup script… • Prepositions input data files • Creates a namelist input file • Builds the executable … all for one specific component. The setup script not only builds an executable, it also pre-positions data into the same directory in which the executable is located.

  20. $CSMROOT/scripts/toos/ccsm_getdata The ccsm_getdata (csh script)

  21. fini

More Related