Generic ADCIRC – Command Line Options

ADCIRC Command Line Options

–I INPUTDIR

Look for input files in the directory ‘INPUTDIR’ instead of looking in the directory where the ADCIRC command was issued.

–O GLOBALDIR

Write fulldomain output files to the directory ‘GLOBALDIR’ instead of writing them to the directory where the ADCIRC command was issued.

–L

When running in parallel, write subdomain output and binaryhotstart files to the PE* subdirectories instead of writing fulldomain output and binary hotstart files. This option does not affect the writing of NetCDF hotstart files, which are always written for the full domain.

–S

When running in parallel, write subdomain binary hotstart files to the PE* subdirectories instead of writing fulldomain binary hotstart files. This option does not affect the writing of NetCDF hotstart file, which are always written for the full domain.

–R

When running in parallel, read subdomain binary hotstart files instead of a fulldomain binary hotstart file. This option does not affect the reading of NetCDF hotstart files, which always reflect the fulldomain solution.

–W NUM_WRITERS

When running in parallel, dedicate NUM_WRITERS MPI processes solely to the task of writing ascii output files (either sparse or dense ascii formats). Must be a positive integer. This option only affects the writing of the ascii formatted fort.63, fort.64, fort.73, and fort.74 files.

–Ws NUM_SPLIT_WRITERS

Same as -W option above, but a new file is created each time the data are written; the integer part of the simulation time is appended to the file name.

–H NUM_HOTSTART_WRITERS’::

Same as -W option above, except that NUM_HOTSTART_WRITERS MPI processes will be dedicated to writing binary hotstart files. This option does not affect the writing of NetCDF hotstart files. The binary hotstart files that are written using this option are only suitable for 2DDI runs without harmonic analysis.

Version 51 additions:
–M

When running in parallel, write subdomain harmonic analysis files. This option is useful for tidal analyses with many consituents (e.g., more than approximately 30) because writing fulldomain harmonic analysis output files with this many constituents can exhaust the physical memory of the host computer.

–Mft MESH_FILE_TYPE

The MESH_FILE_TYPE can be specified as ascii (the default) or xdmf (introduced in ADCIRC v51).

–Mfn MESH_FILE_NAME

Search for a full domain mesh file named MESH_FILE_NAME rather than the default mesh file name fort.14.

–Nft NODAL_ATTRIBUTES_FILE_TYPE

The NODAL_ATTRIBUTES_FILE_TYPE can be specified as ascii (the default) or xdmf (introduced in ADCIRC v51).

–Nfn NODAL_ATTRIBUTES_FILE_NAME

Search for a full domain nodal attributes file named NODAL_ATTRIBUTES_FILE_NAME rather than the default nodal attributes file name fort.14.

ADCPREP Command Line Options

The capability of adcprep to use command line options was developed to ease the task of automating its execution. If the adcprep command is issued without command line options, it will present an interactive menu to the user to allow the selection of the task to be performed.

--np NUM_SUBDOMAINS

Decompose the domain into NUM_SUBDOMAINS subdomains. The number of subdomains should be equal to the number of compute processors that will be used in the parallel computation. This command line option is required.

--partmesh

Partition the mesh only; that is, decide which subdomain each of the nodes should fall into. This should be done first. The result is a file called partmesh.txt, which consists of a list of integers, one line per node in the fulldomain mesh. Each integer in the list represents the subdomain number that each node will fall into. As a result, the range of values in the file represents the range of subdomain numbers.

--prepall

Use the partmesh.txt file to decompose all the ADCIRC input files into subdirectories numbered ‘PExxxx’ where ‘xxxx’ is the zero indexed, zero padded subdomain number. Expects all input files to have the default names, e.g., the mesh file must be named fort.14 instead of something like myMeshFile.grd in order for this option to work. This option requires that adcprep has already been executed with the partmesh option, and that the partmesh.txt file was written successfully.

--prep13

Only redecompose the nodal attributes (fort.13) input file. Requires that prepall step has already been performed.

--prep15

Only redecompose the control model parameter and periodic boundary conditions file (fort.15) input file. Requires that prepall step has already been performed.

--prep20

Only redecompose the non-periodic, normal flux boundary condition file (fort.20). Requires that prepall step has already been performed.

--prep88

Only redecompose the upland river initialization file (fort.88).

Requires that *prepall* step has already been performed.