GENIE:GENIEToolboxQuickStart

Andrew Price, University of Southampton, ([mailto:a.r.price@soton.ac.uk a.r.price@soton.ac.uk])

GENIE Toolbox Quick Start
A quick introduction to executing a GENIE model with the GENIE Toolbox
 * Linux
 * Windows

Linux
 Download a pre-built archive of the default GENIE model instance genie_ig_fi_fi to a working directory (e.g. /home/user/example)  genie_ig_fi_fi_archive.tar.gz  Create a directory in which the software can manage individual model instances (e.g. /home/user/example/output) Start GENIELab Load the model configuration metadata for genie_ig_fi_fi</li> >> metadata = genie_ig_fi_fi_config</tt> metadata =

genie_main: [1x1 struct] genie_igcm3: [1x1 struct] genie_fixedocean: [1x1 struct] genie_fixedseaice: [1x1 struct] genie_fixedchem: [1x1 struct] genie_fixedicesheet: [1x1 struct] Create a local runtime data structure (substituting your local directories as appropriate)</li> >> runtime.LocalRunDir   = '/home/user/example/output';</tt> >> runtime.RuntimeArchive = '/home/user/example/genie_ig_fi_fi_archive.tar.gz';</tt> >> runtime.EXPID         = 'genie_ig_fi_fi'</tt> runtime =

LocalRunDir: '/home/user/example/output' RuntimeArchive: '/home/user/example/genie_ig_fi_fi_archive.tar.gz' EXPID: 'genie_ig_fi_fi'

Create a resource description for the local machine</li> >> resource = createResource('local')</tt> resource =

type: 'local' name: 'Local machine' MaxJobs: 1 broker: 'fork' RemoteTargetOS: 'linux' RemoteFileSep: '/' Execute the model</li> >> [handle, retrieve] = gc_jobsubmit(metadata, runtime, resource)</tt> ******************************************************* Welcome to GENIE, initialisation starting ******************************************************* ======================================================= Initialisation of GENIE main module complete ======================================================= fixedicesheet: Opening orog file ../../genie-fixedicesheet/data/input/orog_grid_std_t21.nc fixedicesheet: Opening iland file ../../genie-fixedicesheet/data/input/landmask_std_t21.nc fixedicesheet: Opening icefrac file ../../genie-fixedicesheet/data/input/icefrac_t21.nc fixedicesheet: Opening restart file for read: ../../genie-fixedicesheet/data/input/fixedicesheet_restart_0.nc Fixed icesheet thinks DOY= 0.0000000E+00 Opening restart file for write: ./fixedicesheet/fixedicesheet_restart_1999_12_30.nc Opening restart file for write: ./fixedicesheet/fixedicesheet_data_1999_12_30.nc fixedchem: Opening restart file for read: ../../genie-fixedchem/data/input/fixedchem_restart_0.nc Fixed chemistry thinks DOY= 0.0000000E+00 Opening restart file for write: ./fixedchem/fixedchem_restart_1999_12_30.nc &INILSURF ALBEDO_FIX     =  5.0000001E-02, SNOLOOK = 0.1000000   , 2*0.8000000      , 2*0.2000000      , 2*0.3000000      ,  0.2000000    ,  0.3000000    , 3*0.5000000    ,  0.7000000    ,  0.6000000    ,  0.8000000    , 5*0.7000000      ,  0.4000000    ,  0.8000000    ,   0.7000000    ,  0.8000000    , SZLOOK  =  1.0000000E-03,  9.9999997E-05,  3.0000001E-04,   1.000000    ,   1.200000    , 2*1.000000       ,   1.200000    , 1.000000  , 3*0.4000000      , 8*0.1200000      ,   1.500000    , 2*0.1200000      ,  3.0000000E-03, SALOOK =  0.1000000   ,  0.7500000    ,  5.9999999E-02,  0.1400000    ,  0.1200000    , 4*0.1300000      ,  0.1700000    , 2*0.1600000    ,  0.1900000    , 2*0.2000000      ,  0.1200000    ,  0.1700000    , 2*0.1900000      ,  0.2500000    ,   0.1800000    ,  0.1500000    ,  0.1200000    ,  0.3500000    , SHSSTAR =  0.3000000    , OUTPUTDIR_NAME_IGCMLANDSURF    = ./igcm

... The model output data files can be found in a unique sub-directory of the folder specified in runtime.LocalRunDir</tt></li> </ol>

Windows
<ol> Download a pre-built archive of the default GENIE model instance genie_ig_fi_fi to a working directory (e.g. C:\example</tt>)</li>  genie_ig_fi_fi_archive.zip</li> </ul> Create a directory in which the software can manage individual model instances (e.g. <tt>C:\example\output</tt>)</li> <li>Start GENIELab</li> <li>Load the model configuration metadata for genie_ig_fi_fi</li> <tt>>> metadata = genie_ig_fi_fi_config</tt> metadata =

genie_main: [1x1 struct] genie_igcm3: [1x1 struct] genie_fixedocean: [1x1 struct] genie_fixedseaice: [1x1 struct] genie_fixedchem: [1x1 struct] genie_fixedicesheet: [1x1 struct] <li>Create a local runtime data structure (substituting your local directories as appropriate)</li> <tt>>> runtime.LocalRunDir   = 'C:\example\output';</tt> <tt>>> runtime.RuntimeArchive = 'C:\example\genie_ig_fi_fi_archive.tar.gz';</tt> <tt>>> runtime.EXPID         = 'genie_ig_fi_fi'</tt> runtime =

LocalRunDir: 'C:\example\output' RuntimeArchive: 'C:\example\genie_ig_fi_fi_archive.tar.gz' EXPID: 'genie_ig_fi_fi'

<li>Create a resource description for the local machine</li> <tt>>> resource = createResource('local')</tt> resource =

type: 'local' name: 'Local machine' MaxJobs: 1 broker: 'fork' RemoteTargetOS: 'win32' RemoteFileSep: '\' <li>Execute the model</li> <tt>>> [handle, retrieve] = gc_jobsubmit(metadata, runtime, resource)</tt> ******************************************************* Welcome to GENIE, initialisation starting ******************************************************* ======================================================= Initialisation of GENIE main module complete ======================================================= fixedicesheet: Opening orog file ../../genie-fixedicesheet/data/input/orog_grid_std_t21.nc fixedicesheet: Opening iland file ../../genie-fixedicesheet/data/input/landmask_std_t21.nc fixedicesheet: Opening icefrac file ../../genie-fixedicesheet/data/input/icefrac_t21.nc fixedicesheet: Opening restart file for read: ../../genie-fixedicesheet/data/input/fixedicesheet_restart_0.nc Fixed icesheet thinks DOY= 0.0000000E+00 Opening restart file for write: ./fixedicesheet/fixedicesheet_restart_1999_12_30.nc Opening restart file for write: ./fixedicesheet/fixedicesheet_data_1999_12_30.nc fixedchem: Opening restart file for read: ../../genie-fixedchem/data/input/fixedchem_restart_0.nc Fixed chemistry thinks DOY= 0.0000000E+00 Opening restart file for write: ./fixedchem/fixedchem_restart_1999_12_30.nc &INILSURF ALBEDO_FIX     =  5.0000001E-02, SNOLOOK = 0.1000000   , 2*0.8000000      , 2*0.2000000      , 2*0.3000000      ,  0.2000000    ,  0.3000000    , 3*0.5000000    ,  0.7000000    ,  0.6000000    ,  0.8000000    , 5*0.7000000      ,  0.4000000    ,  0.8000000    ,   0.7000000    ,  0.8000000    , SZLOOK  =  1.0000000E-03,  9.9999997E-05,  3.0000001E-04,   1.000000    ,   1.200000    , 2*1.000000       ,   1.200000    , 1.000000  , 3*0.4000000      , 8*0.1200000      ,   1.500000    , 2*0.1200000      ,  3.0000000E-03, SALOOK =  0.1000000   ,  0.7500000    ,  5.9999999E-02,  0.1400000    ,  0.1200000    , 4*0.1300000      ,  0.1700000    , 2*0.1600000    ,  0.1900000    , 2*0.2000000      ,  0.1200000    ,  0.1700000    , 2*0.1900000      ,  0.2500000    ,   0.1800000    ,  0.1500000    ,  0.1200000    ,  0.3500000    , SHSSTAR =  0.3000000    , OUTPUTDIR_NAME_IGCMLANDSURF    = ./igcm

... <li>The model output data files can be found in a unique sub-directory of the folder specified in <tt>runtime.LocalRunDir</tt></li> </ol>