ADVENTURE_Auto (Ver. 0.1 beta) Manual 0. Notice Currently, all the commands in ADVENTURE_Auto works only for a mesh of 2nd order 10-node tetrahedral elements. Other types of elements are not supported now. The number of elements and nodes handled by these commands are 1M and 1M, respectively. These limitations are hard-coded into source codes, so you can extend them by modifying the source codes directly. 1. ADVENTURE_Auto ADVENTURE_Auto is a module to automate finite element analyses using other ADVENTURE modules. This toolkit contains some useful commands for the automation of FE analyses, such as boundary condition attachment and analysis result evaluation. ADVENTURE_Auto primarily depends on the following ADVENTURE modules. * ADVENTURE_IO * ADVENTURE_TetMesh * ADVENTURE_BCtool * ADVENTURE_Metis (on MPI-enabled environment) * ADVENTURE_Solid, ADVENTURE_Thermal and other solver modules. In addition, ADVENTURE_Auto can be used with the following ADVENTURE modules. * Combined with ADVENTURE_CAD, you can perform a parametric study in which the dimension parameters of the geometry model vary over the analyses. * Combined with ADVENTURE_Opt, you can perform parametric design optimization using either SQP or GA. In section 2, the commands in ADVENTURE_Auto are explained. In section 3, the file formats used in ADVENTURE_Auto are explained. In section 4, the commands in other ADVENTURE modules and related to ADVENTURE_Auto are explained. In section 5, the file formats used in other ADVENTURE modules and related to ADVENTURE_Auto are explained. 2. Commands in ADVENTURE_Auto module 2.1. Viewer Commands * advauto_pchview This command visualizes a surface patch. It reads the following files. a surface patch file (*.pch) a face group file (*.fgr) * advauto_mshview This command visualizes the surface of a mesh. It reads the following files. a mesh file (*.msh) a face group file (*.fgr) * advauto_fgrview This command visualizes the ID number of face groups in a mesh. It reads the following files. a mesh file (*.msh) a face group file (*.fgr) * advauto_solidview This command visualizes the surface contour and deformation plot of a stress analysis. It reads the following files. a mesh file (*.msh) a face group file (*.fgr) an ASCII displacement analysis result file (Displacement.dat) an ASCII nodal equivalent stress analysis result file (NodalEquivalentStress.dat) * advauto_thermalview This command visualizes the surface contour plot of a heat conduction analysis. It reads the following files. a mesh file (*.msh) a face group file (*.fgr) an ASCII temperature analysis result file (Temperature.dat) 2.2. Data Extraction Commands * advauto_findfgr This command finds a face group which contains all the vertex coordinates in the specified file. It reads the following files. a mesh file (*.msh) a face group file (*.fgr) a file of the list of vertex coordinates (x, y, z) It writes the ID number of the face group found into stdout. * advauto_nelements This command extracts the number of elements in a mesh. It reads the following files. a mesh file (*.msh) It writes the number of elements into stdout. * advauto_nnodes This command extracts the number of nodes in a mesh. It reads the following files. a mesh file (*.msh) It writes the number of nodes into stdout. * advauto_volume This command gets the volume of a mesh. It reads the following files. a mesh file (*.msh) It writes the volume into stdout. * advauto_displacement This command extracts the min/max value of a displacement analysis result. It reads the following files. a mesh file (*.msh) an ASCII displacement analysis result file (Displacement.dat) It writes the min/max values for each components and length into stdout. * advauto_equivstress This command extracts the min/max value of an equivalent stress analysis result. It reads the following files. a mesh file (*.msh) an ASCII nodal equivalent stress analysis result file (NodalEquivalentStress.dat) It writes the min/max values into stdout. 2.3. Conversion Commands * advauto_fgr2element This command extracts all the element faces over specified face groups. It reads the following files. a mesh file (*.msh) a face group file (*.fgr) a file of the list of face group IDs It writes an element face list into stdout. * advauto_fgr2node This command extracts all the nodes over specified face groups. It reads the following files. a mesh file (*.msh) a face group file (*.fgr) a file of the list of face group IDs It writes a node list into stdout. * advauto_fgr2elementbc This command extracts boundary conditions on element faces over specified face groups. It reads the following files. a mesh file (*.msh) a face group file (*.fgr) a face group boundary condition file (*.fgrbc) It writes element face boundary conditions (*.elementbc) into stdout. * advauto_fgr2nodebc This command extracts boundary conditions on nodes over specified face groups. It reads the following files. a mesh file (*.msh) a face group file (*.fgr) a face group boundary condition file (*.fgrbc) It writes node boundary conditions (*.nodebc) into stdout. * advauto_fgr2dofbc This command extracts boundary conditions on node D.O.F.s over specified face groups. It reads the following files. a mesh file (*.msh) a face group file (*.fgr) a face group D.O.F. boundary condition file (*.fgrdofbc) It writes node D.O.F. boundary conditions (*.dofbc) into stdout. * advauto_elementbc2nodebc This command converts Neumann boundary conditions from element faces into nodes by surface integration. It reads the following files. a mesh file (*.msh) a face group file (*.fgr) an element face boundary condition file (*.elementbc) It writes node boundary conditions (*.nodebc) into stdout. * advauto_elementbc2dofbc This command converts Neumann boundary conditions from element faces into node D.O.F.s by surface integration. It reads the following files. a mesh file (*.msh) a face group file (*.fgr) an element face boundary condition file (*.elementbc) It writes node D.O.F. boundary conditions (*.dofbc) into stdout. 2.4. ADVENTURE I/O Commands * advauto_msh2adv This command converts a mesh file into an ADVENTURE I/O file. It reads the following files. a mesh file (*.msh) It writes the following files. a ADVENTURE I/O file (*.adv) * advauto_constant2adv This command converts a constant file into an ADVENTURE I/O file. It reads the following files. a constant file (*.constant) It writes the following files. an ADVENTURE I/O file (*.adv) * advauto_elementbc2adv This command converts an element face boundary condition file into an ADVENTURE I/O file. It reads the following files. an element face boundary condition file (*.elementbc) It writes the following files. an ADVENTURE I/O file (*.adv) * advauto_nodebc2adv This command converts a node boundary condition file into an ADVENTURE I/O file. It reads the following files. a node boundary condition file (*.nodebc) It writes the following files. an ADVENTURE I/O file (*.adv) * advauto_dofbc2adv This command converts a node D.O.F. boundary condition file into an ADVENTURE I/O file. It reads the following files. a node D.O.F. boundary condition file (*.dofbc) It writes the following files. an ADVENTURE I/O file (*.adv) 2.5. ADVENTURE I/O Commands (Single Version) * advauto_single_msh2adv This command converts a mesh file into an ADVENTURE I/O file. It reads the following files. a mesh file (*.msh) It writes the following files. a ADVENTURE I/O file (*.adv, single version) * advauto_single_constant2adv This command converts a constant file into an ADVENTURE I/O file. It reads the following files. a constant file (*.constant) It writes the following files. an ADVENTURE I/O file (*.adv, single version) * advauto_single_elementbc2adv This command converts an element face boundary condition file into an ADVENTURE I/O file. It reads the following files. an element face boundary condition file (*.elementbc) It writes the following files. an ADVENTURE I/O file (*.adv, single version) * advauto_single_nodebc2adv This command converts a node boundary condition file into an ADVENTURE I/O file. It reads the following files. a node boundary condition file (*.nodebc) It writes the following files. an ADVENTURE I/O file (*.adv, single version) * advauto_single_dofbc2adv This command converts a node D.O.F. boundary condition file into an ADVENTURE I/O file. It reads the following files. a node D.O.F. boundary condition file (*.dofbc) It writes the following files. an ADVENTURE I/O file (*.adv, single version) * advauto_single_getsolidresult This command extracts analysis results as ASCII text files. It reads the following files. an ADVENTURE I/O file (*.adv) It writes the following files. a displacement analysis result file (Displacement.dat) a nodal equivalent stress analysis result file (NodalEquivalentStress.dat) an element equivalent stress analysis result file (EquivalentStress.dat) 3. File Formats Used in ADVENTURE_Auto module * face group boundary condition file (*.fgrbc) This file format represents boundary condition data on face groups. The total number of the selected face groups is specified as (num_items). Boundary condition data may be scalar, vector or any combination of them. The number of value components on each face group is specified as (num_values). The contents of *.fgrbc file are, num_items num_values group_id_0 value_0_a value_0_b value_0_c ... group_id_1 value_1_a value_1_b value_1_c ... group_id_2 value_2_a value_2_b value_2_c ... ... * face group D.O.F. boundary condition file (*.fgrdofbc) This file format represents boundary condition data on face groups. The total number of data items is specified as (num_items). It may not be the same as the total number of the selected face groups. Boundary condition data is a pair of D.O.F.(degree of freedom) ID, which is either 0, 1 or 2, and its component value. The contents of *.fgrdofbc file are, num_items group_id_0 dof_0 value_0 group_id_1 dof_1 value_1 group_id_2 dof_2 value_2 ... * node boundary condition file (*.nodebc) This file format represents boundary condition data on nodes. The total number of the nodes is specified as (num_items). Boundary condition data may be scalar, vector or any combination of them. The total number of value components on each node is specified as (num_values). The contents of *.nodebc file are, num_items num_values node_id_0 value_0_a value_0_b value_0_c ... node_id_1 value_1_a value_1_b value_1_c ... node_id_2 value_2_a value_2_b value_2_c ... ... * node D.O.F. boundary condition file (*.dofbc) This file format represents boundary condition data on nodes. The total number of data items is specified as (num_items). It may not be the same as the total number of the selected nodes. Boundary condition data is a pair of degree of freedom ID, which is either 0, 1 or 2, and its component value. The contents of *.dofbc file are, num_items node_id_0 dof_0 value_0 node_id_1 dof_1 value_1 node_id_2 dof_2 value_2 ... * element boundary condition file (*.elementbc) This file format represents boundary condition data on element faces. The total number of the element faces is specified as (num_items). Boundary condition data may be scalar, vector or any combination of them. The total number of value components on each node is specified as (num_values). The contents of *.elementbc file are, num_items num_values element_id_0 face_id_0 value_0_a value_0_b value_0_c ... element_id_1 face_id_1 value_1_a value_1_b value_1_c ... element_id_2 face_id_2 value_2_a value_2_b value_2_c ... ... * constant file (*.constant) This file format represents node- or element-independent constant data, such as geometrical properties and material properties. The total number of the constant data items is specified as (num_items). For each constant data item, a FEGA label is specified. It is the label of FEGA (Finite Element Generic Attribute) in ADVENTURE I/O. See ADVENTURE I/O module and other ADVENTURE solver modules for more detail. Each constant data may be scalar, vector or any combination of them. The number of value components on each constant data item is specified as (num_values_?). The contents of *.constant file are, num_items FEGA_label_0 num_values_0 value_0_a value_0_b ... FEGA_label_1 num_values_1 value_1_a ... FEGA_label_2 num_values_2 value_2_a value_2_b value_2_c ... FEGA_label_3 num_values_3 value_3_a value_3_b value_3_c ... ... 4. Some Important Commands contained in Other ADVENTURE Modules * advcad in ADVENTURE_CAD module This command generates a surface patch file (*.pch) from a geometry file (*.gm3d). See ADVENTURE_CAD manual for more detail. * advtmesh8m in ADVENTURE_TetMesh module This command generates a mesh file (*.msh) from a surface patch file (*.pch). See ADVENTURE_TetMesh manual for more detail. * msh2pch in ADVENTURE_BCtool module This command generates a face group file (*.fgr) from a mesh file (*.msh). See ADVENTURE_BCtool manual for more detail. * advcat in ADVENTURE_IO module This command concatenates some ADVENTURE I/O files into one. See ADVENTURE_IO manual for more detail. * hddmmrg in ADVENTURE_Solid module This command generates an ASCII text file of analysis results. See ADVENTURE_Solid manual for more detail. 5. Some Important File Formats Used in Other ADVENTURE Modules * geometry file (*.gm3d) See ADVENTURE_CAD manual for more detail. * surface patch file (*.pch) See ADVENTURE_TetMesh manual for more detail. * mesh file (*.msh) See ADVENTURE_TetMesh manual for more detail. * face group file (*.fgr) See ADVENTURE_BCtool manual for more detail. * ADVENTURE I/O file (*.adv) See ADVENTURE_IO manual, as well as the manual of each ADVENTURE solver module, for more detail. * ASCII analysis result file (*.dat) See ADVENTURE_Solid manual for more detail.