Temperature and salinity distribution (LANL)

Most jobs are continuations of a run-sequence, so the potential temperature and salinity (and other necessary variables) are read in from a restart file. In this case, the init_ts_opt should be set to 'restart' and the runid and iyear0,...,isecond0 parameters in time_manager_nml are reset by the values in the restart file.

Table: Temperature and salinity initialization (LANL)

&init_ts_nml	LANL default	LANL values	Initial temperature and salinity distribution
init_ts_option	'internal'	'restart', 'branch', 'file', 'mean', 'internal'	start from restart OR read initial ocean conditions from a file OR create conditions from an input mean ocean profile OR create initial conditions based on 1992 Levitus mean ocean profile computed internally
init_ts_file	'unknown_ts_file'	string ≤ 256 characters	restart file OR file containing 3D potential temperature and salinity at grid points OR file containing depth profile of potential temperature and salinity OR (ignored for 'internal' or when luse_pointer_files is enabled)
init_ts_file_fmt	'bin'	'bin', 'nc'	data format (binary or netCDF) for input init_ts_file ('file' and 'restart' options only)
/

If you want to start from an old restart file, but also want the new run to start from time zero, the init_ts_opt should be set to 'branch'. In this case, the time information in the restart file is ignored (namelist inputs for the various parameters are used instead), but the ocean state is initialized with the data in the restart file. Note, that this will not give an exact restart because the code will start with an Euler forward step as if it were starting from scratch.

To begin a run from scratch, any of the other three options can be used.The 'file' option reads a file containing the 3-d fields for potential temperature and salinity and uses those fields for the initial condition. The 'mean' option reads a mean profile from an ascii input file with potential temperature and salinity given in two columns as a function of depth.This mean state will be spread across the horizontal domain to create horizontally-uniform 3-d fields. The final option is 'internal' which generates a mean vertical profile by interpolating from the 1992 Levitus mean ocean profile. As in the 'mean' option, this vertical profile is then spread across the horizontal domain to create the full 3-d fields.

Temperature and salinity distribution (CESM1)

The CESM1 T,S initialization options are different from the LANL base-model options. Note, in particular, that the LANL 'branch' and CESM1 'ccsm_branch' options have different meanings. Although the CESM1 POP2 code recognizes all of the LANL base options, none of them will work properly in the CESM1 version of POP2.

Table: Temperature and salinity initialization (CESM1)

&init_ts_nml	CESM1 default	CESM1 values	Initial temperature and salinity distribution
init_ts_option	auto-filled by CESM1 POP2 scripts	'ccsm_startup', 'ccsm_continue', 'ccsm_branch', 'ccsm_hybrid', 'PHC'	read initial ocean conditions from a file ('ccsm_startup') OR start from a restart file ('ccsm_continue' and 'ccsm_branch') OR start from a restart file but use different model date ('ccsm_hybrid') OR remap PHC Levitus data to POP grid ('PHC'). 'PHC' is a research option that is available but not publicly supported.
init_ts_suboption	'null'	'null', 'spunup'	if init_ts_suboption = 'spunup', then init_ts_option is set (internally) to 'ccsm_startup_spunup'; otherwise, this option has no effect. If the spunup suboption is selected, the model T,S are initialized from the specified input file, but velocities are initialized to zero, as in a 'ccsm_startup' run.
init_ts_file	'ts'	'ts', 'PHC'	restart file OR file containing 3D potential temperature and salinity at grid points OR remap PHC Levitus data to POP grid
init_ts_file_fmt	auto-filled by CESM1 POP2 scripts	'bin', 'nc'	data format (binary or netCDF) for input init_ts_file ('ccsm_continue', 'ccsm_branch', 'ccsm_hybrid' options only)
init_ts_outfile	auto-filled by CESM1 POP2 scripts	string ≤ 256 characters	output filename of output T,S file; only used with the 'PHC' init_ts_option option
init_ts_outfile_fmt	auto-filled by CESM1 POP2 scripts	'bin', 'nc'	output format of output T,S file; only used with the 'PHC' init_ts_option option
/