From: bangerth <bangerth@0785d39b-7218-0410-832d-ea1e28bc413d>
Date: Wed, 3 Apr 2013 21:29:23 +0000 (+0000)
Subject: Add note about building the tool.
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=9a7a0919cc7afbb8c81838776f6a46b0a3e19291;p=dealii-svn.git

Add note about building the tool.

git-svn-id: https://svn.dealii.org/trunk@29171 0785d39b-7218-0410-832d-ea1e28bc413d
---

diff --git a/deal.II/contrib/mesh_conversion/README.txt b/deal.II/contrib/mesh_conversion/README.txt
index b55e350587..77f4d27d0f 100644
--- a/deal.II/contrib/mesh_conversion/README.txt
+++ b/deal.II/contrib/mesh_conversion/README.txt
@@ -9,6 +9,15 @@ Author: Jean-Paul Pelteret
         modified by: Timo Heister, heister@math.tamu.edu
 ===================================================
 
+
+This tool is intended to support converting ABAQUS .inp files into a
+format that deal.II can read. To use this tool, you need to configure
+deal.II using the "-DDEAL_II_COMPONENT_MESH_CONVERTER=ON" argument
+when calling 'cmake'. The resulting executable will then be placed in
+the installation directory.
+
+
+
 Cubit features captured by ABAQUS .inp files:
 ---------------------------------------------
 1. Multiple material-id's can be defined in the mesh. This is done by specifying blocksets in the pre-processor.
@@ -20,7 +29,7 @@ How to use:
 1.1. Go to "Analysis setup mode" by clicking on the disc icon in the toolbar on the right.
 1.2. Select "Export Mesh" under "Operation" by clicking on the necessary icon in the toolbar on the right.
 1.3. Select an output file. I have found that in Cubit version 11.0 and 12.0 that it is necessary to click on the browse button and type it in the dialogue that pops up.
-1.4. Select the dimension to output in. 
+1.4. Select the dimension to output in.
 1.5. Tick the overwrite box.
 1.6. If using Cubit v12.0 onwards, uncheck the box "Export using Cubit ID's". The conversion process will encounter errors if box if left checked.
 1.7. Click apply.
@@ -33,18 +42,13 @@ IMPORTANT NOTE: From v12.0 onwards, the format of the Abaqus file that Cubit out
        './convert_mesh <spatial_dimension>  /path/to/input_file.inp /path/to/output_file.ucd'
 
        The first input argument is the spatial dimension of the input file, the second is the path to the read-in Abaqus .inp file, and the third is the name of the file to which you wish to write the output AVS .ucd file to.
-       An example of the correct program usage is: 
+       An example of the correct program usage is:
 e.g.  './convert_mesh 3 mesh/3d/test_in.inp mesh/3d/test_out.ucd'
 
 
 Notes:
 ------
-1. This tool was made with the specific intention of the output file being used as a mesh for deal.II.
-2. It has been tested with the deal.II 6.2-pre subversion as distributed on 2009-10-16.
-3. Testing...
-   Abaqus OLD: It has been tested for both 2d and 3d meshes, although more thoroughly for the latter. The 2d grids that were tested were drawn in the X-Y plane.
-   Abaqus NEW: As of yet, this has been tested only for 3d meshes (on a single simple mesh and a complex mesh, which is not provided as an example - but this hopefully covers all the possible problems one may encounter).
-4. A few example / test meshes are provided in the directory "mesh". The .inp files that have been generated are all of the Abaqus OLD format except for one - CC.cub has been converted into both the "new" and "old" formats and both subsequently converted into deal.II readable meshes.
+1. A few example / test meshes are provided in the directory "mesh". The .inp files that have been generated are all of the Abaqus OLD format except for one - CC.cub has been converted into both the "new" and "old" formats and both subsequently converted into deal.II readable meshes.
 
 Copyright:
 ----------