- fileThe name of the mesh file to read
C++ Type:MeshFileName
Description:The name of the mesh file to read
FileMesh
Read a mesh from a file.
Support File Formats
The FileMesh is the default type for MOOSE and as the name suggests it reads the mesh from an external file. MOOSE supports reading and writing a large number of formats and could be extended to read more.
| Extension | Description |
|---|---|
| .e, .exd | Sandia's ExodusII format |
| .dat | Tecplot ASCII file |
| .fro | ACDL's surface triangulation file |
| .gmv | LANL's GMV (General Mesh Viewer) format |
| .mat | Matlab triangular ASCII file (read only) |
| .msh | GMSH ASCII file |
| .n, .nem | Sandia's Nemesis format |
| .plt | Tecplot binary file (write only) |
| .node, .ele; .poly | TetGen ASCII file (read; write) |
| .inp | Abaqus .inp format (read only) |
| .ucd | AVS's ASCII UCD format |
| .unv | I-deas Universal format |
| .xda, .xdr | libMesh formats |
| .vtk, .pvtu | Visualization Toolkit |
Input Parameters
- ghosting_patch_sizeThe number of nearest neighbors considered for ghosting purposes when 'iteration' patch update strategy is used. Default is 5 * patch_size.
C++ Type:unsigned int
Description:The number of nearest neighbors considered for ghosting purposes when 'iteration' patch update strategy is used. Default is 5 * patch_size.
- parallel_typeDEFAULTDISTRIBUTED: Always use libMesh::DistributedMesh REPLICATED: Always use libMesh::ReplicatedMesh DEFAULT: Use libMesh::ReplicatedMesh unless --distributed-mesh is specified on the command line
Default:DEFAULT
C++ Type:MooseEnum
Description:DISTRIBUTED: Always use libMesh::DistributedMesh REPLICATED: Always use libMesh::ReplicatedMesh DEFAULT: Use libMesh::ReplicatedMesh unless --distributed-mesh is specified on the command line
- max_leaf_size10The maximum number of points in each leaf of the KDTree used in the nearest neighbor search. As the leaf size becomes larger,KDTree construction becomes faster but the nearest neighbor searchbecomes slower.
Default:10
C++ Type:unsigned int
Description:The maximum number of points in each leaf of the KDTree used in the nearest neighbor search. As the leaf size becomes larger,KDTree construction becomes faster but the nearest neighbor searchbecomes slower.
- allow_renumberingTrueIf allow_renumbering=false, node and element numbers are kept fixed until deletion
Default:True
C++ Type:bool
Description:If allow_renumbering=false, node and element numbers are kept fixed until deletion
Optional Parameters
- dim1This is only required for certain mesh formats where the dimension of the mesh cannot be autodetected. In particular you must supply this for GMSH meshes. Note: This is completely ignored for ExodusII meshes!
Default:1
C++ Type:MooseEnum
Description:This is only required for certain mesh formats where the dimension of the mesh cannot be autodetected. In particular you must supply this for GMSH meshes. Note: This is completely ignored for ExodusII meshes!
- enableTrueSet the enabled status of the MooseObject.
Default:True
C++ Type:bool
Description:Set the enabled status of the MooseObject.
- patch_update_strategyneverHow often to update the geometric search 'patch'. The default is to never update it (which is the most efficient but could be a problem with lots of relative motion). 'always' will update the patch for all slave nodes at the beginning of every timestep which might be time consuming. 'auto' will attempt to determine at the start of which timesteps the patch for all slave nodes needs to be updated automatically.'iteration' updates the patch at every nonlinear iteration for a subset of slave nodes for which penetration is not detected. If there can be substantial relative motion between the master and slave surfaces during the nonlinear iterations within a timestep, it is advisable to use 'iteration' option to ensure accurate contact detection.
Default:never
C++ Type:MooseEnum
Description:How often to update the geometric search 'patch'. The default is to never update it (which is the most efficient but could be a problem with lots of relative motion). 'always' will update the patch for all slave nodes at the beginning of every timestep which might be time consuming. 'auto' will attempt to determine at the start of which timesteps the patch for all slave nodes needs to be updated automatically.'iteration' updates the patch at every nonlinear iteration for a subset of slave nodes for which penetration is not detected. If there can be substantial relative motion between the master and slave surfaces during the nonlinear iterations within a timestep, it is advisable to use 'iteration' option to ensure accurate contact detection.
- control_tagsAdds user-defined labels for accessing object parameters via control logic.
C++ Type:std::vector
Description:Adds user-defined labels for accessing object parameters via control logic.
- nemesisFalseIf nemesis=true and file=foo.e, actually reads foo.e.N.0, foo.e.N.1, ... foo.e.N.N-1, where N = # CPUs, with NemesisIO.
Default:False
C++ Type:bool
Description:If nemesis=true and file=foo.e, actually reads foo.e.N.0, foo.e.N.1, ... foo.e.N.N-1, where N = # CPUs, with NemesisIO.
- construct_node_list_from_side_listTrueWhether or not to generate nodesets from the sidesets (usually a good idea).
Default:True
C++ Type:bool
Description:Whether or not to generate nodesets from the sidesets (usually a good idea).
- patch_size40The number of nodes to consider in the NearestNode neighborhood.
Default:40
C++ Type:unsigned int
Description:The number of nodes to consider in the NearestNode neighborhood.
Advanced Parameters
- partitionerdefaultSpecifies a mesh partitioner to use when splitting the mesh for a parallel computation.
Default:default
C++ Type:MooseEnum
Description:Specifies a mesh partitioner to use when splitting the mesh for a parallel computation.
- centroid_partitioner_directionSpecifies the sort direction if using the centroid partitioner. Available options: x, y, z, radial
C++ Type:MooseEnum
Description:Specifies the sort direction if using the centroid partitioner. Available options: x, y, z, radial
Partitioning Parameters
Input Files
- modules/porous_flow/test/tests/dirackernels/bh07.i
- modules/porous_flow/examples/coal_mining/fine_with_fluid.i
- modules/tensor_mechanics/test/tests/truss/truss_3d.i
- modules/porous_flow/test/tests/desorption/desorption01.i
- modules/tensor_mechanics/test/tests/beam/action/2_block_common.i
- modules/navier_stokes/test/tests/step/step.i
- test/tests/auxkernels/solution_aux/aux_nonlinear_solution_adapt_xda.i
- modules/tensor_mechanics/examples/coal_mining/coarse.i
- test/tests/materials/output/output_multiple_files.i
- modules/combined/test/tests/beam_eigenstrain_transfer/master_uo_transfer.i
- modules/misc/test/tests/fracture_flow/single.i
- test/tests/outputs/oversample/over_sampling_test_file.i
- test/tests/materials/output/output_block_displaced.i
- modules/solid_mechanics/examples/bridge/bridge_large_strain.i
- modules/combined/doc/richards/user/excav/ex01.i
- modules/tensor_mechanics/test/tests/mohr_coulomb/uni_axial3_planar.i
- modules/tensor_mechanics/test/tests/truss/truss_3d_action.i
- test/tests/auxkernels/solution_aux/solution_aux_exodus_interp.i
- modules/tensor_mechanics/test/tests/radial_disp_aux/cylinder_3d_cartesian.i
- modules/richards/test/tests/dirac/bh_fu_07.i
- modules/porous_flow/test/tests/desorption/desorption02.i
- modules/combined/test/tests/phase_field_fracture_viscoplastic/crack2d.i
- modules/richards/test/tests/theis/th_lumped_01.i
- modules/richards/test/tests/theis/th02.i
- modules/porous_flow/examples/flow_through_fractured_media/coarse_3D.i
- test/tests/mesh_modifiers/add_all_side_sets/simple.i
- test/tests/constraints/tied_value_constraint/tied_value_constraint_test.i
- modules/richards/test/tests/theis/th_lumped_22.i
- test/tests/mesh_modifiers/modifier_depend_order/modifier_depend_order.i
- test/tests/restrictable/api_test/block_restrictable.i
- test/tests/materials/output/output_block.i
- test/tests/materials/has_material/has_block_prop.i
- test/tests/auxkernels/solution_aux/solution_aux_exodus_direct.i
- modules/tensor_mechanics/test/tests/truss/truss_2d.i
- test/tests/mesh_modifiers/add_side_sets/cylinder_points.i
- modules/richards/test/tests/excav/ex01.i
- modules/tensor_mechanics/test/tests/beam/action/2_block.i
- test/tests/auxkernels/solution_aux/solution_aux_exodus_interp_restart1.i
- modules/tensor_mechanics/test/tests/CylindricalRankTwoAux/test.i
- modules/combined/test/tests/poro_mechanics/borehole_highres.i
- modules/tensor_mechanics/test/tests/truss/truss_hex_action.i
- modules/richards/test/tests/theis/th01.i
- modules/tensor_mechanics/test/tests/beam/static/euler_finite_rot_y.i
- modules/combined/test/tests/phase_field_fracture/void2d_iso.i
- modules/heat_conduction/test/tests/meshed_gap_thermal_contact/meshed_annulus_thermal_contact.i
- test/tests/misc/line_source/line_source.i
- python/chigger/tests/input/mug_blocks.i
- test/tests/auxkernels/element_aux_boundary/element_aux_boundary.i
- test/tests/geomsearch/fake_block_to_boundary/fake_block_to_boundary.i
- test/tests/auxkernels/solution_aux/solution_aux_exodus_interp_direct.i
- modules/porous_flow/examples/flow_through_fractured_media/coarse.i
- modules/porous_flow/examples/flow_through_fractured_media/fine_thick_fracture_steady.i
- test/tests/materials/output/output_boundary.i
- modules/combined/examples/thermomechanics/circle_thermal_expansion_stress.i
- test/tests/mesh_modifiers/mesh_extruder/extrude_remap_layer1.i
- test/tests/mesh_modifiers/add_side_sets/cylinder_normals_fixed.i
- test/tests/materials/derivativematerialinterface/multiblock.i
- test/tests/restrictable/check_error/check_error.i
- test/tests/mesh_modifiers/add_side_sets/cylinder_normals.i
- modules/porous_flow/test/tests/aux_kernels/darcy_velocity_lower.i
- modules/richards/test/tests/theis/th21.i
- modules/richards/test/tests/theis/th_lumped_02.i
- modules/tensor_mechanics/examples/bridge/bridge_large_strain.i
- modules/tensor_mechanics/test/tests/mohr_coulomb/uni_axial2_planar.i
- test/tests/materials/output/block_via_outputs.i
- test/tests/ics/check_error/two_ics_on_same_block_global.i
- modules/tensor_mechanics/test/tests/finite_strain_elastic/elastic_rotation_test.i
- test/tests/controls/time_periods/constraints/constraints.i
- modules/tensor_mechanics/test/tests/mohr_coulomb/uni_axial2.i
- python/chigger/tests/simple/mug_blocks.i
- modules/functional_expansion_tools/examples/3D_volumetric_cylindrical/main.i
- modules/richards/test/tests/dirac/bh07.i
- modules/tensor_mechanics/test/tests/beam/static/euler_finite_rot_y_action.i
- modules/solid_mechanics/examples/bridge/bridge.i
- test/tests/mesh_modifiers/mesh_extruder/extrude_remap_layer2.i
- modules/porous_flow/examples/coal_mining/coarse_with_fluid.i
- modules/tensor_mechanics/test/tests/truss/truss_2d_action.i
- modules/richards/test/tests/excav/ex02.i
- test/tests/mesh_modifiers/sidesets_around_subdomain/around_normals.i
- modules/tensor_mechanics/examples/coal_mining/fine.i
- test/tests/outputs/oversample/oversample_file.i
- test/tests/variables/simple_restricted/simple_restricted.i
- test/tests/auxkernels/solution_aux/solution_aux_exodus_interp_restart2.i
- test/tests/geomsearch/2d_interior_boundary_penetration_locator/2d_interior_boundary_penetration_locator.i
- test/tests/materials/has_material/has_boundary_prop.i
- test/tests/ics/check_error/two_ics_on_same_block.i
- test/tests/mesh_modifiers/sidesets_between_subdomains/between.i
- test/tests/constraints/coupled_tied_value_constraint/coupled_tied_value_constraint.i
- modules/tensor_mechanics/test/tests/radial_disp_aux/cylinder_2d_cartesian.i
- test/tests/restart/duplicate_node/duplicate_node.i
- modules/functional_expansion_tools/examples/3D_volumetric_cylindrical/sub.i
- modules/tensor_mechanics/test/tests/coupled_pressure/coupled_pressure_test.i
- test/tests/auxkernels/solution_aux/solution_aux_direct.i
- test/tests/mesh_modifiers/mesh_extruder/extruder_angle.i
- modules/functional_expansion_tools/examples/3D_volumetric_cylindrical_subapp_mesh_refine/sub.i
- test/tests/mesh_modifiers/mesh_extruder/extruder_quad.i
- modules/functional_expansion_tools/examples/3D_volumetric_cylindrical_subapp_mesh_refine/main.i
- modules/tensor_mechanics/examples/bridge/bridge.i
- modules/richards/test/tests/dirac/bh27.i
- test/tests/mesh_modifiers/block_deleter/BlockDeleterTest11.i
- modules/tensor_mechanics/test/tests/mohr_coulomb/uni_axial3.i
- test/tests/mesh/mesh_only/mesh_only.i
- modules/combined/test/tests/chemical_reactions_richards/langmuir_jac3.i
- test/tests/mesh_modifiers/mesh_extruder/extruder_tri.i
- modules/combined/test/tests/glued_contact_constraint/glued_contact_constraint.i
- test/tests/geomsearch/patch_update_strategy/always.i
- modules/richards/test/tests/dirac/bh_lumped_07.i
- modules/tensor_mechanics/test/tests/radial_disp_aux/sphere_3d_cartesian.i
- modules/tensor_mechanics/test/tests/beam/static/euler_finite_rot_z.i
- test/tests/auxkernels/solution_aux/solution_aux.i
- test/tests/misc/no_exodiff_map/no_exodiff_map.i
- test/tests/mesh_modifiers/smooth_mesh/mesh_smoother.i
- modules/richards/test/tests/dirac/bh_fu_08.i
- modules/chemical_reactions/test/tests/desorption/langmuir_lumping_problem.i
- test/tests/outputs/oversample/over_sampling_second_file.i
- test/tests/postprocessors/nodal_pps/nodal_extreme_pps_test.i
- test/tests/mesh_modifiers/sidesets_around_subdomain/around.i
- modules/misc/test/tests/fracture_flow/single_quick.i
- test/tests/mesh/patterned_mesh/mesh_tester.i
- modules/tensor_mechanics/test/tests/stress_recovery/stress_concentration/stress_concentration.i
- test/tests/misc/check_error/nodal_value_off_block.i
- modules/tensor_mechanics/test/tests/truss/truss_hex.i
- test/tests/bcs/periodic/auto_dir_repeated_id.i
- modules/tensor_mechanics/test/tests/radial_disp_aux/sphere_2d_axisymmetric.i
- test/tests/geomsearch/quadrature_penetration_locator/1d_quadrature_penetration.i
- test/tests/geomsearch/patch_update_strategy/never.i
- test/tests/restrictable/api_test/boundary_restrictable.i
- test/tests/geomsearch/patch_update_strategy/auto.i
- test/tests/auxkernels/solution_aux/build.i
- modules/combined/test/tests/poro_mechanics/borehole_lowres.i
- modules/heat_conduction/test/tests/meshed_gap_thermal_contact/meshed_gap_thermal_contact.i
- test/tests/restrictable/internal_side_user_object/internal_side_user_object.i
- test/tests/functions/solution_function/solution_function_exodus_test.i
- modules/tensor_mechanics/test/tests/pressure/pressure_test.i
- test/tests/functions/solution_function/solution_function_test.i
- modules/richards/test/tests/theis/th22.i
- modules/porous_flow/test/tests/aux_kernels/darcy_velocity_lower_2D.i
- test/tests/auxkernels/element_quality_aux/element_quality_aux.i
- modules/porous_flow/test/tests/aux_kernels/darcy_velocity_lower_except.i
- test/tests/mesh_modifiers/add_all_side_sets/less_simple.i
- modules/porous_flow/examples/flow_through_fractured_media/fine_steady.i
- modules/chemical_reactions/test/tests/desorption/langmuir_jac2.i