Quick Install and Verify 

Follow these directions to quickly install and to run a verification test. Please see the file README_Mac_OS_X_Users in the distribution for more detailed discussion.


1. Extract the downloaded tarball (for example, use: tar xvzf warp3d.....tar.gz).

2. This will create a directory with name of the form warp3d_distribution _x.y.z

3. Move this directory which contains the complete WARP3D package to the desired location on your filesystem. The discussion below assumes this directory is ~/warp3d  (i.e., your home directory). Change the acess permissions as desired. The precompiled executables are located in the warp3d directory under sub-directory run_mac_os_x.

4. Before use, set one environment variable.

  • Set the variable WARP3D_HOME to point to the WARP3D installation directory. In a bash shell, run the command
 % export WARP3D_HOME=/yyyy/xxxx/warp3d

                          (make yyyy and xxxx as needed to locate your home directory)

  • Recommendation: Put this command in your ~/.bashrc to avoid having to redo this step every time you open a new terminal window.

5. The pre-compiled version of WARP3D is now installed and ready to run..

6.  Run several of the example problems to verify correct installation. Execute these commands in a Bash shell:

% warp3d_exe=$WARP3D_HOME/run_mac_os_x/warp3d.omp
% cd $WARP3D_HOME/example_problems_for_READMEs
% export OMP_NUM_THREADS=4
% export MKL_NUM_THREADS=4
% $warp3d_exe < test_18a
% $warp3d_exe < test_18b
  • The first line sets a short reference to the WARP3D executable. The 2nd line switches to the small directory with problems to verify proper installation.
  • OMP_NUM_THREADS sets the number of threads for the parallel loops in WARP3D proper.
  • MKL_NUM_THREADS sets the number of threads for the Intel Pardiso sparse shared memory solver.
  • This example assumes the hardware supports at least 4 threads (usually a system with at least 4 cores since 2 threads per core is not optimal for compute heavy jobs).
  • Example test_18 computes extensive amounts of ductile crack growth in a model of an SE(B) specimen with the Gurson material model. The mesh has 1 layer of elements in the thickness direction with plane-strain constraints.
  • Part a computes half the load steps and writes a restart file. Part b resumes the solution using the restart file and completes a total of 60 load steps. Parts a and b each use less than 10 secs of wall time.
  • The above example employs input redirection via the shell "<" operator.
  • Similarly, output may be redirected to a file using the ">" operator, e.g. $warp3d_exe < test_18a > output_test_18a.
  • All of the above commands  are more conveniently placed into a shell script for execution at the command line. The file warp3d_script_mac_os_x  in the WARP3D directory provides a starting point for any further customizations.