Coreform Cubit 2024.8 User Documentation

Sculpt Command Summary

Following is a listing of the available input commands to either sculpt or psculpt. When used from the unix command line, commands may be issued using the short form argument, designated with a single dash(-), or with the longer form, designated with two dashes (--). When used in an input file, only the long form may be used, omitting the two dashes (--)

Process Control              -pc     --process
  --num_procs                -j    <arg> Number of processors requested                      
  --input_file               -i    <arg> File containing user input data                     
  --debug_processor          -D    <arg> Sleep to attach to processor for debug              
  --debug_flag               -dbf  <arg> Dump debug info based on flag                       
  --quiet                    -qt         Suppress output                                     
  --print_input              -pi         Print input values and defaults then stop           
  --version                  -vs         Print version number and exit                       
  --threads_process          -tpp  <arg> Number of threads per process                       
  --iproc                    -ip   <arg> Number of processors in I direction                 
  --jproc                    -jp   <arg> Number of processors in J direction                 
  --kproc                    -kp   <arg> Number of processors in K direction                 
  --build_ghosts             -bg         Write ghost layers to exodus files for debug        
  --vfrac_method             -vm   <arg> Set method for computing volume fractions           

Input Data Files             -inp     --input
  --stl_file                 -stl  <arg> Input STL file                                      
  --diatom_file              -d    <arg> Input Diatom description file                       
  --input_vfrac              -ivf  <arg> Input from Volume Fraction file base name           
  --input_micro              -ims  <arg> Input from Microstructure file                      
  --input_cart_exo           -ice  <arg> Input from Cartesian Exodus file                    
  --input_spn                -isp  <arg> Input from Microstructure spn file                  
  --spn_xyz_order            -spo  <arg> Ordering of cells in spn file                       
  --compress_spn_ids         -csp  <arg> Compress IDs from SPN file                          
  --input_stitch             -ist  <arg> Input from Stitch file                              
  --stitch_timestep          -stt  <arg> Timestep in Stitch file to read                     
  --stitch_timestep_id       -stn  <arg> Timestep ID in Stitch file to read                  
  --stitch_field             -stf  <arg> Field in Stitch file to read                        
  --stitch_info              -sti        List header info for Stitch file                    
  --lattice                  -l    <arg> STL Lattice Template File                           

Output                       -out     --output
  --exodus_file              -e    <arg> Output Exodus file base name                        
  --large_exodus             -le   <arg> Output large Exodus file(s)                         
  --volfrac_file             -vf   <arg> Output Volume Fraction file base name               
  --quality                  -Q    <arg> Dump quality metrics to file                        
  --export_comm_maps         -C          Export parallel comm maps to debug exo files        
  --write_geom               -G          Write geometry associativity file                   
  --write_mbg                -M          Write mesh based geometry file <beta>         
  --compare_volume           -cv         Report vfrac and mesh volume comparison             
  --compute_ss_stats         -css        Report sideset statistics                           

Overlay Grid Specification   -ovr     --overlay
  --nelx                     -x    <arg> Num cells in X in overlay Cartesian grid            
  --nely                     -y    <arg> Num cells in Y in overlay Cartesian grid            
  --nelz                     -z    <arg> Num cells in Z in overlay Cartesian grid            
  --xmin                     -t    <arg> Min X coord of overlay Cartesian grid               
  --ymin                     -u    <arg> Min Y coord of overlay Cartesian grid               
  --zmin                     -v    <arg> Min Z coord of overlay Cartesian grid               
  --xmax                     -q    <arg> Max X coord of overlay Cartesian grid               
  --ymax                     -r    <arg> Max Y coord of overlay Cartesian grid               
  --zmax                     -s    <arg> Max Z coord of overlay Cartesian grid               
  --cell_size                -cs   <arg> Cell size (nelx, nely, nelz ignored)                
  --align                    -a          Automatically align geometry to grid                
  --bbox_expand              -be   <arg> Expand tight bbox by percent                        
  --input_mesh               -im   <arg> Input Base Exodus mesh                              
  --input_mesh_blocks        -imb  <arg> Block ids of Input Base Exodus mesh                 
  --input_mesh_material      -imm  <arg> Material definition with input mesh                 
  --input_mesh_pamgen        -imp  <arg> Input Base mesh defined by Pamgen                   
  --join_parallel            -jp   <arg> Join parallel files                                 

Mesh Type                    -typ     --type
  --stair                    -str  <arg> Generate Stair-step mesh                            
  --mesh_void                -V    <arg> Mesh void                                           
  --trimesh                  -tri        Generate tri mesh of geometry surfaces              
  --tetmesh                  -tet  <arg> Under Development                                   
  --deg_threshold            -dg   <arg> Convert hexes below threshold to degenerates        
  --max_deg_iters            -dgi  <arg> Maximum number of degenerate iterations             
  --htet                     -ht   <arg> Convert hexes below quality threshold to tets       
  --htet_method              -hti  <arg> Method used for splitting hexes to tets             
  --htet_material            -htm  <arg> Convert hexes in given materials to tets            
  --htet_transition          -htt  <arg> Transition method between hexes and tets            
  --htet_pyramid             -htp  <arg> Local transition pyramid                            
  --htet_tied_contact        -htc  <arg> Local transition tied contact                       
  --htet_no_interface        -htn  <arg> Local transition none                               
  --periodic                 -per        Generate periodic mesh                              
  --check_periodic           -cp   <arg> Check for periodic geometry                         
  --check_periodic_tol       -cpt  <arg> Tolerance for checking periodicity                  
  --periodic_axis            -pax  <arg> Axis periodicity is about                           
  --periodic_nodesets        -pns  <arg> Nodesets ids of master/slave nodesets               

Boundary Conditions          -bc     --boundary_condition
  --void_mat                 -VM   <arg> Void material ID (when mesh_void=true)              
  --separate_void_blocks     -SVB        Separate void into unique block IDs                 
  --material_name            -mn   <arg> Label Material (Block) with Name                    
  --sideset_name             -sn   <arg> Label Sideset with Name                             
  --nodeset_name             -nn   <arg> Label Nodeset with Name                             
  --sideset                  -sid  <arg> User Defined Sideset                                
  --nodeset                  -nid  <arg> User Defined Nodeset                                
  --gen_sidesets             -SS   <arg> Generate sidesets                                   
  --free_surface_sideset     -FS   <arg> Free Surface Sideset                                
  --match_sidesets           -mss  <arg> Sidesets ids of matching pairs                      
  --match_sidesets_nodeset   -msn  <arg> Nodeset defining match_sidesets                     

Adaptive Meshing             -adp     --adapt
  --adapt_type               -A    <arg> Adaptive meshing type                               
  --adapt_threshold          -AT   <arg> Threshold for adaptive meshing                      
  --adapt_levels             -AL   <arg> Number of levels of adaptive refinement             
  --adapt_material           -AM   <arg> Info for adapting material                          
  --adapt_export             -AE         Export exodus mesh of refined grid                  
  --adapt_non_manifold       -ANM        Refine at non-manifold conditions                   
  --adapt_load_balance       -ALB        Adaptive parallel load balancing                    
  --adapt_memory_stats       -AMS        Write memory usage stats for adaptivity             

Smoothing                    -smo     --smoothing
  --smooth                   -S    <arg> Smoothing method                                    
  --csmooth                  -CS   <arg> Curve smoothing method                              
  --laplacian_iters          -LI   <arg> Number of Laplacian smoothing iterations            
  --max_opt_iters            -OI   <arg> Max. number of parallel Jacobi opt. iters.          
  --opt_threshold            -OT   <arg> Stopping criteria for Jacobi opt. smoothing         
  --curve_opt_thresh         -COT  <arg> Min metric at which curves won't be honored         
  --max_pcol_iters           -CI   <arg> Max. number of parallel coloring smooth iters.      
  --pcol_threshold           -CT   <arg> Stopping criteria for parallel color smooth         
  --max_gq_iters             -GQI  <arg> Max. number of guaranteed quality smooth iters.     
  --gq_threshold             -GQT  <arg> Guaranteed quality minimum SJ threshold             
  --geo_smooth_max_deviation -GSM  <arg> Geo Smoothing Maximum Deviation                     

Mesh Improvement             -imp     --improve
  --pillow                   -p    <arg> Set pillow criteria (1=surfaces)                    
  --pillow_surfaces          -ps         Turn on pillowing for all surfaces                  
  --pillow_curves            -pcv        Turn on pillowing for bad quality at curves         
  --pillow_boundaries        -pb         Turn on pillowing at domain boundaries              
  --pillow_curve_layers      -pcl  <arg> Number of elements to buffer at curves              
  --pillow_curve_thresh      -pct  <arg> S.J. threshold to pillow hexes at curves            
  --pillow_smooth_off        -pso        Turn off smoothing following pillow operations      
  --capture                  -c    <arg> Project to facet geometry <beta>              
  --capture_angle            -ca   <arg> Angle at which to split surfaces <beta>       
  --capture_side             -sc   <arg> Project to facet geometry with surface ID           
  --defeature                -df   <arg> Apply automatic defeaturing                         
  --min_vol_cells            -mvs  <arg> Minimum number of cells in a volume                 
  --defeature_bbox           -dbb        Defeature Filtering at Bounding Box                 
  --defeature_iters          -dfi  <arg> Maximum Number of Defeaturing Iterations            
  --thicken_material         -thm  <arg> Expand a given material into surrounding cells      
  --thicken_void             -thv  <arg> Insert void material to remove overlap              
  --micro_expand             -me   <arg> Expand Microstructure grid by N layers              
  --micro_shave              -ms         Remove isolated cells at micro. boundaries          
  --remove_bad               -rb   <arg> Remove hexes with Scaled Jacobian < threshold    
  --wear_method              -wm   <arg> Method for removing void at free surface            
  --crack_min_elem_thickness -cmet <arg> Minimum element thickness in crack                  
  
  --min_num_layers           -mnl  <arg> Minimum number of layers to keep using wear_method=2

Mesh Transformation          -tfm     --transform
  --xtranslate               -xtr  <arg> Translate final mesh coordinates in X               
  --ytranslate               -ytr  <arg> Translate final mesh coordinates in Y               
  --ztranslate               -ztr  <arg> Translate final mesh coordinates in Z               
  --xscale                   -xsc  <arg> Scale final mesh coordinates in X                   
  --yscale                   -ysc  <arg> Scale final mesh coordinates in Y                   
  --zscale                   -zsc  <arg> Scale final mesh coordinates in Z                   

Boundary Layers              -bly     --boundary_layer
  --begin                    -beg  <arg> Begin specification blayer or blayer_block          
  --end                      -zzz  <arg> End specification blayer or blayer_block            
  --material                 -mat  <arg> Boundary layer material specification               
  --num_elem_layers          -nel  <arg> Number of element layers in blayer block            
  --thickness                -th   <arg> Thickness of first element layer in block           
  --bias                     -bi   <arg> Bias of element thicknesses in blayer block