AcuPrep

Syntax

acuPrep [options]

Type

AcuSolve Solver Program Command

Description

Prepares the user data to be run by AcuSolve. The following options are supported; for a general description of option specifications, see Command Line Options and Configuration Files.

In the following option descriptions, the full name of each option is followed by its abbreviated name and its type.

help or h (boolean) [FALSE]

If set, the program prints a usage message and exits. The usage message includes all available options, their current values and the place where each option is set.

problem or pb (string)

The name of the problem is specified via this option. This name is used to generate and recognize internal files.

input_file or inp (string)

Name of the input file is specified via this option. If input_file is set to _auto, problem.inp is used.

working_directory or dir (string)

All internal files are stored in this directory. This directory does not need to be on the same file system as the input files of the problem.

file_format or fmt (enumerated)

Format of the internal files:

ascii

ASCII files

binary

Binary files

hdf

Hierarchical data format (HDF5)

num_acuprep_threads or npt (integer) [8]

This parameter specifies the number of threads per processor to run AcuPrep.

num_subdomains or nsd (integer) [1]

This option specifies the number of subdomains into which the mesh is to be decomposed. This number must be greater than or equal to the number of processors to be used to run the problem. The number of subdomains, and similarly the number of processors, may be changed at restart.

num_solver_threads or nst (integer) [1]

This option specifies the number of threads on which the solution will be run. When this value is greater than 1, a two level domain decomposition is performed. The first optimizes for the distributed memory message passing, and the second for the shared memory message passing.

echo_input or echo (boolean) [TRUE]

Echo the input file to the file problem.run.echo; where run is the ID of the current run.

echo_precedence or prec (boolean) [FALSE]

Echo the resolved boundary condition precedence (if any) to the file problem.bc_warning.

run_as_tets or tet (boolean) [FALSE]

The run_as_tets option may be used to split the mesh into an all tet mesh. All continuum fluid and solid elements are split into tetrahedron elements, and all thermal shell elements are converted to wedge elements. The surface facets are split into triangles. This option typically reduces the memory and CPU usage of AcuSolve.

domain_decomposition or ddc (enumerated) [metis]

Domain decomposition technique to be used for decomposing the mesh into subdomains. This advanced option should rarely be changed from its default value.

metis

Use METIS from University of Minnesota. METIS is based on technology described in the following reference: "A Fast and Highly Quality Multilevel Scheme for Partitioning Irregular Graphs". George Karypis and Vipin Kumar. SIAM Journal on Scientific Computing, Vol. 20, No. 1, pp. 359-392, 1999.

acuddc

Causes the domain decomposition to be performed as a separate process using AcuDdc.

restart

Use the domain decomposition from the restart files. This requires that the nodal coordinates, element connectivity, and number of subdomains remain unaltered from the restart run.

acuddc_executable or acuddc (string)

Full path to the AcuDdc executable. This advanced option should rarely be changed from its default value.

max_ddc_agglomeration or mda (string) [_auto]

If mda is larger than 1, a pre-agglomeration of elements into clusters of size mda is performed prior to domain decomposition (DDC). This reduces the DDC memory requirement, but with the potential cost of yielding an inferior decomposition. This option is particularly useful for very large problems when limited memory resources are available. When this option is set to _auto, the agglomeration size is automatically set to yield less than 100 million agglomerated element clusters for the purpose of domain decomposition.

cache_size or cache (integer) [1024]

Size of the computer cache in Kilobytes (KB). This is used to determine the optimal element block size. This advanced option should rarely be changed from its default value.

auto_generate_ebc or ebc (boolean) [TRUE]

Assign mass_flux of type free for fluid boundary surfaces where no mass flux element boundary condition is assigned. This advanced option should rarely be changed from its default value.

auto_reference_frame_interface or rfi (boolean) [TRUE]

Generate reference frame interfaces. This advanced option should rarely be changed from its default value.

auto_set_back_flow_diffusion or bfd (boolean) [FALSE]

Set back flow diffusion for outflow Simple Boundary Conditions. This advanced option should rarely be changed from its default value.

granular_no_slip or grannoslip(boolean) [FALSE]

Enforce no-slip condition for granular flow walls. This advanced option should rarely be changed from its default value.

sort_nodes_and_elements or sort (boolean) [TRUE]

Sort the nodes and elements to localize data access. On cache-based machines, this option improves performance. This advanced option should rarely be changed from its default value.

ignore_negative_jacobian or inj (boolean) [FALSE]

Ignore elements with negative jacobians. This advanced option should rarely be changed from its default value.

line_buff or lbuff (boolean) [FALSE]

Flush standard output after each line of output.

verbose or v (integer) [1]

Set the verbose level for printing information to the screen. Each higher verbose level prints more information. If verbose is set to 0 (or less), only warning and error messages are printed. If verbose is set to 1, basic processing information is printed in addition to warning and error messages. This level is recommended. verbose levels greater than 1 provide information useful only for debugging.

Examples

To run a problem, first write an input file, then execute AcuPrep to preprocess the input file into a format used by the solver, execute AcuView if necessary, and then run the solver by executing AcuSolve. Finally, translate the solution using AcuTrans. AcuPrep, AcuView and AcuSolve are not normally run by themselves, but rather the script AcuRun is used to run these programs.

acuPrep -pb channel

problem= channel

acuPrep

acuPrep -ddc acuddc

acuPrep -ddc restart