Escolar Documentos
Profissional Documentos
Cultura Documentos
ANSYS FENSAP-ICE, ANSYS FENSAP-ICE-TURBO, ANSYS OPTIGRID 2016 ANSYS Inc. All rights reserved. Unauthorized
use, distribution or duplication is prohibited.
ANSYS, ANSYS Workbench, Ansoft, AUTODYN, EKM, Engineering Knowledge Manager, CFX, FLUENT, HFSS, AIM
and any and all ANSYS, Inc. brand, product, service and feature names, logos and slogans are registered trademarks
or trademarks of ANSYS, Inc. or its subsidiaries in the United States or other countries. ICEM CFD is a trademark
used by ANSYS, Inc. under license. CFX is a trademark of Sony Corporation in Japan. All other brand, product,
service and feature names or trademarks are the property of their respective owners.
Disclaimer Notice
THIS ANSYS SOFTWARE PRODUCT AND PROGRAM DOCUMENTATION INCLUDE TRADE SECRETS AND ARE CONFID-
ENTIAL AND PROPRIETARY PRODUCTS OF ANSYS, INC., ITS SUBSIDIARIES, OR LICENSORS. The software products
and documentation are furnished by ANSYS, Inc., its subsidiaries, or affiliates under a software license agreement
that contains provisions concerning non-disclosure, copying, length and nature of use, compliance with exporting
laws, warranties, disclaimers, limitations of liability, and remedies, and other provisions. The software products
and documentation may be used, disclosed, transferred, or copied only in accordance with the terms and conditions
of that software license agreement.
ANSYS, Inc. and ANSYS Europe, Ltd. are UL registered ISO 9001: 2008 companies.
For U.S. Government users, except as specifically granted by the ANSYS, Inc. software license agreement, the use,
duplication, or disclosure by the United States Government is subject to restrictions stated in the ANSYS, Inc.
software license agreement and FAR 12.212 (for non-DOD licenses).
Third-Party Software
See the legal information in the product help files for the complete Legal Notice for ANSYS proprietary software
and third-party software. If you are unable to access the Legal Notice, Contact ANSYS, Inc.
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. iii
Tools Reference
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
iv of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 1: Environment Setup
Command-line tools are provided in the .../bin/ directory of the FENSAP-ICE installation directory,
whose complete paths are contained in the environment variable $NTI_PATH.
Add the $NTI_PATH to your shell environment $PATH variable, in your shell startup script.
Windows:
Launch a terminal from FENSAP-ICE (View Open Terminal) will initiate a DOS prompt with the envir-
onment PATH already set. All FENSAP-ICE command line tools will be available from there.
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 1
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
2 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 2: Grid Operations
The following sections of this chapter are:
2.1. Convertgrid
2.2. fluent2fensap
2.3. fensap2fluent
2.4. cfx2fensap
2.5. fensap2cfx
2.6. cgns2fensap
2.7. fensap2cgns
2.1. Convertgrid
convertgrid is a tool that enables many editing operations on a FENSAP format grid.
2.1.1. Description
Operations:
Cell operations
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 3
Grid Operations
Note
convertgrid -h
For a complete and fully up-to-date command reference, use the built-in command line
help above.
-d
Diagnostic mode - Does not write output file but lists the solution content (reference values, solution
datafields, zones and boundary conditions).
-ascii
Writes text format grid (default=binary, for speed). File output format is binary, unless -ascii is specified.
-c3d
Writes a C3D format grid (solid domains).
-cart
Writes a grid in Cartesian coordinates.
-cyl
Writes a grid in cylindrical coordinates.
-solid
Writes a solid domain grid.
-readc3d
Reads a C3D format grid.
-rotx
Specifies the X axis of rotation, if any. Required for some features.
-roty
Specifies the Y axis of rotation, if any. Required for some features.
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
4 of ANSYS, Inc. and its subsidiaries and affiliates.
Convertgrid
-rotz
Specifies the Z axis of rotation, if any. Required for some features.
-d
Printout grid stats and end (size, boundary conditions, cell types).
-dd
Outputs extra read info.
-factor=VALUE
Scale the nodes coordinates by VALUE factor.
-factor=X,Y,Z
Scales the X,Y,Z coordinates by VALUE factor.
-translate=X,Y,Z
Scales the grid by the specified vector.
-translatePost
Translates after all other operations (on all materials).
-rotate[X,Y,Z]=angle
Rotates the grid along X,Y,Z axis, by the specified angle (degrees).
-optimize
Reorders the node numbering with the RCM algorithm.
-optimize2
Reorders the node numbering with the Octree algorithm.
-renameBC=OLD,NEW
Renumbers the specified boundary condition to NEW.
-renameBC=OLD,NEW,"EQUATION"
Same as -renameBC but only where EQUATION is true.
-detectBC=BC ???
Detects missing boundary facets on the grid and assigns them the identifier boundary condition.
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 5
Grid Operations
-fixBC
Detects and remove duplicate facets.
-filterInternalBCs
Removes boundary condition surrounded by two volume elements, except actuator disks or heater
pads.
-splitVolumes
Writes OUTPUT.X grids, one for each volume.
-splitMaterials
As -splitVolumes, but using material IDs as volumes.
-splitSoln=FILENAME
In -splitVolumes mode, can split a solution file.
-splitHFlux=FILENAME
In -splitVolumes mode, can split a hflux.dat file.
-splitShear=FILENAME
In -splitVolumes mode, can split a surface.dat file.
-splitJoin=V1,V2
Volume 2 will be merged to Volume 1.
-splitSkip=V
Discards the volume V when working on multiple domains.
-mergeBC=BC1,BC2
Merges nodes of node-matching surfaces.
-renameMat=OLD,NEW
Renumbers the specified material ID to NEW.
-renameMat=OLD,NEW,EQUATION
Same as -renameMat but where EQUATION is true.
-periodic[=tolerance]
Sets periodic flags on 4100, 4200, 4300s boundary condition, must be node-matching; also permits to
double-check the accuracy of a grid periodicity.
-notperiodic
Removes periodicity in the output grid.
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
6 of ANSYS, Inc. and its subsidiaries and affiliates.
Convertgrid
-periodicZone=4***
For -periodic, specifies the symmetry boundary condition number that is periodic.
-periodicPlanes=tolerance
Optionally used with -periodic, to refine the tolerance of a point on a plane.
-periodicTranslation=X,Y,Z
Specifies the translation vector.
-periodicClipPlane=[X|Y|Z],low,hi
Clips the periodic nodes on the given planes. Used with -periodic.
-periodicRotational=X/Y/Z,ANGLE
Specifies the axis of rotation and angle in DEG.
-periodicFix
For already periodic grids, will increase the periodic plane accuracy (periodicTranslation/ Ro-
tational argument required).
-clearPeriod=BC,BC,...
Removes periodicity on specified boundary condition list.
-prBC=BC1,BC2
Used with -periodicRotational/Translation, specifies boundary condition pairs to match.
Boundary conditions are erased.
2.1.3. Examples
Table 2.12: Example Commands
Note
Nodal solutions, heat fluxes and so on are not useable with the reordered file as the node
and facet order of the output file is different.
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 7
Grid Operations
Grid provided with a single BC=4000 for both rotational periodic sides, the boundary condition is first
split in two boundary conditions, the renamed boundary condition is based on the rotational coordinate
THETA (grid is specified as rotating along the X axis, with the -rotx argument).
2.2. fluent2fensap
The ANSYS Fluent case and solution file (.CAS and .DAT) can easily be converted to a FENSAP grid and
airflow solution format.
2.2.1. Description
This operation is usually done within FENSAP-ICE by selecting a .CAS file as the grid input file. The import
panels will provide the means to fine-tune the boundary conditions, reference conditions and solution
field association.
The fluent2fensap process is fully automated and normally does not require adjustments.
Reference values are extracted from the Fluent configuration and written in the solution file header.
The values in the solution file header are required only for:
Viewmerical Postprocessing:
The calculation of the pressure coefficient requires PINF, TINF, VELINF. The calculation of the airflow
Mach number requires RGAS, GAMMA. The calculation of the relative velocity components require
RPMX, RPMY, RPMZ.
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
8 of ANSYS, Inc. and its subsidiaries and affiliates.
fluent2fensap
CHT3D Anti-Icing:
Note
-d
Diagnostic mode. Does not write the output file but list its content (reference values, solution datafields,
zones and boundary conditions).
-roughness=FILE
If Fluent was configured with a roughness profile, typically obtained from ICE3D beading model in a
previous FENSAP-ICE computation, it is required to apply the same roughness value in the airflow
solution file converted from Fluent format. This argument permits to specify a roughness.dat file, with
the roughness distribution. The roughness values will be inserted in the output airflow solution file
written by fluent2fensap. The roughness information will be used by ICE3D, if the beading model
is enabled.
Note
A roughness.dat file related to the node number and ordering in the grid. If the Fluent
grid has been remeshed, or reordered, the roughness.dat of the previous shot cannot
be used as-is, and will need to be reinterpolated on the new grid: Use then the
rough2rough tool.
-nosoln
Will not read a .DAT file nor write a soln file.
-ascii
Output FENSAP grid written in ASCII (default is binary).
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 9
Grid Operations
-solid
Write a solid grid (for use with C3D).
-imat
Write a multi-material grid (for use with FENSAP/DROP and multiple domains). This is automatic if the
Fluent grids have more than one cell section.
-materials=ZONE,ZONE,ZONE
Optional. Provide a specific order for the material IDs.
-rotVX=RPM
Convert a relative-frame solution to absolute.
-rotVY=RPM
Convert a relative-frame solution to absolute.
-rotVZ=RPM
Convert a relative-frame solution to absolute.
-rotabs
Indicate the solution is absolute frame. Use rotVX/-rotVY/-rotVZ to specify the rotation speed which
will be stored in the solution header (used for post-processing).
VELINF
Reference velocity (m/s)
TINF
Reference static temperature (K)
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
10 of ANSYS, Inc. and its subsidiaries and affiliates.
fensap2fluent
PINF
Reference static pressure (Pa)
LENINF
Reference length (m)
2.2.4. Examples
Table 2.23: fluent2fensap Commands
2.3. fensap2fluent
This tool permits to convert a FENSAP grid into the Fluent grid format. The file will contain only the
grid and boundary condition types, no solver settings are written.
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 11
Grid Operations
2.3.1. Description
Important
Some grids with periodicity will be converted to a Fluent file with invalid shadow zone sur-
faces, and Fluent might fail to read them. In such a case, the suggested approach is:
Convert the grid using the noperiod option or prepare an input grid with convertgrid INPUT
OUTPUT -notperiodic.
In Fluent, detect anew the periodicity using the TUI command lines.
-solid
Reads a C3D solid grid file format.
-read=FILE.cas
Reads a reference case file, some options (solver settings, zone numberings) will be copied in the new
output .CAS file. This might result in an incomplete Fluent configuration.
-modifyNodes=FILE.cas
Reads a reference case file and writes it as output, with the only modification being the XYZ coordinates
of the nodes, read from the input FENSAP grid. This is used to displace the nodes after ICE3D ALE grid
displacement.
-ascii
Fluent file will be written in ASCII.
-noperiod
Disable periodicity writing.
2.4. cfx2fensap
cfx2fensap is a tool introduced in FENSAP-ICE 2015R1.0 to enable automatic conversion from CFX
.RES format to FENSAP grid and airflow solution formats. General usage is similar to fluent2fensap.
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
12 of ANSYS, Inc. and its subsidiaries and affiliates.
cfx2fensap
2.4.1. Description
This operation is usually done within FENSAP-ICE, by selecting the .RES file as the grid input file for a
run. The import panels will allow fine-tuning of the boundary conditions, reference conditions and
solution field associations. In FENSAP-TURBO simulations, multi-row grids can be separated and auto-
matically configured in FENSAP-ICE.
Note
CFX must be installed on the machine where cfx2fensap is launched, and the cfx5cmds
tool is accessible, either via a global execution path, or the command line below.
-cfxPath=/path/
Used to indicate the path of the bin/ subdirectory of the current installation of CFX.
Alternatively, if a CCL appears alongside the input .RES file, CFX is not required to reside on the exe-
cution machine. (FILE.ccl alongside FILE.res) The CCL can be generated in the following way.
From CFX-Pre:
Prior to FENSAP-ICE 2015R1.0, CFX import was done via CGNS file format (See cgns2fensap (p. 14)).
-zone=N
Extract a subzone of the grid (1-N), only, for example, a turbofan stage, or a single material.
-split
Write all subzones of the grid to different OUTPUT.ZONENAME files. Used for turbo-fan grid, separated
in multiple rows.
-hflux -shear
Write hflux and shear stress facet-based files.
-solid
Write a solid grid (for use with C3D).
-notperiodic
Disable periodicity detection/writing.
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 13
Grid Operations
CFX boundary conditions are matched to suitable FENSAP boundary condition type and identifiers.
The automatic behavior can be overloaded by using the ZoneName:BC syntax. Use quotes for zone
names with multiple words separated by spaces.
If the boundary condition identifier 0 is chosen, the facet zone will not be written. Refer to fluent2fensap
for details on FENSAP boundary condition identifiers.
Reference Conditions:
The detection is done automatically from the CFX settings, but should be reviewed in the output log.
For correct functioning, CHT-CFX requires that the proper reference conditions values be set in the
FENSAP solution file.
2.5. fensap2cfx
To convert from FENSAP file format to CFX format, the options are:
An existing CFX-Pre configuration can be updated from a new, compatible, mesh if the original mesh
is overwritten and the File Reload Mesh Files option is chosen.
2.6. cgns2fensap
The following sections of this chapter are:
2.6.1. Description
2.6.2. Command Line Reference
2.6.1. Description
CGNS is a general file format for CFD (CGNS) and the file format is supported by most solvers. However
it is a very general file format and only a subset of the features is supported.
The converted grid can be used with FENSAP-ICE; the converted solution (if solution data is included)
might not be suitable for DROP3D. Particular attention to the solution units and availability of all the
required data fields is needed.
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
14 of ANSYS, Inc. and its subsidiaries and affiliates.
cgns2fensap
-solid
Write a solid grid (for use with C3D).
-noSoln
Write only a grid without a solution file.
-cfx
CGNS file coming from a solver in which the heat flux values must be reversed.
or
-fluent
CGNS file coming from a solver in which the heat flux values must be reversed.
-fieldlist
Printout available fields.
-field=CGNS,FENSAP
Choose conversion from CGNS ID to FENSAP 4-letter ID.
-periodic
Automatic periodicity detection. For symmetry in x/y/z only.
-periodicTol=VALUE
(For auto detection) specify tolerance for node equality.
-periodicPlanes=VALUE
(For auto detection) specify planar tolerance.
-periodic=lo,hi
Periodicity detection between two named boundary conditions.
-periodicVector=X,Y,Z
Specify the vector of translation.
-periodicRotational=X/Y/Z, ANGLE
Specify the axis of rotation and angle in DEG.
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 15
Grid Operations
-rotVX=RPM/-rotVY/-rotVZ
Convert a solution in relative frame to absolute frame.
CGNS boundary conditions are matched to suitable FENSAP boundary condition type and identifiers.
The automatic behavior can be overloaded by using the ZoneName:BC syntax. Use quotes for zone
names with multiple words separated by spaces.
The CGNS format does not include reference conditions, but the values can be specified on the command
line with the VAR=VALUE syntax.
Refer to fensap2fluent
2.7. fensap2cgns
This tool can be used to convert a FENSAP grid (and optionally, solution) to CGNS format. It can then
be loaded in CFD-Post and postprocessing tools that support this file format.
2.7.1. Description
Table 2.31: Command Line Reference
-solid
Reads a C3D solid grid file format.
-type=cfx
Will write CGNS file compatible with CFX and CFD-Post.
-2d
Special handling of map.grid/ice.grid. Use in combination with -type=cfx.
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
16 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 3: Solution File Operations
The following sections of this chapter are:
3.1. solnEdit
3.2. soln2soln
3.1. solnEdit
solnEdit is a tool that enables operations on a solution file.
3.1.1. Description
Operations range from:
Note
Note
solnEdit -h
For a complete, and fully up-to-date command reference description, use the built-in
command line help with the above script.
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 17
Solution File Operations
-l
Printout the content of the solution file, the OUTPUT argument can be omitted.
-c3d
Input grid is a C3D solid grid.
FIELDNAME=EXPRESSION
The content of the named field will be replaced by the expression value. Expressions are Maple-like.
See the FENSAP-ICE user manual for a reference. Use enclosing quotes around EXPRESSION if spaces
are used in the expression.
Available variables are: the 4-letter solution field names, X, Y, Z, NN (node ID), MAT (material ID).
FIELDNAME:#=EXPRESSION
For unsteady fields, # permits to select the time level to change.
FIELDNAME=@FILENAME@FIELD
The entire content of FIELDNAME will be replaced by the content from the source solution file. The
source solution must be from a grid with the same number of nodes, however the file format and
available fields may differ.
3.1.3. Examples
Example 3.1: Print the Content of a Solution File
...reading grid
...done
== File information:
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
18 of ANSYS, Inc. and its subsidiaries and affiliates.
soln2soln
...
See Expression Syntax (p. 31) for more details regarding the available expression operators.
3.2. soln2soln
The soln2soln command interpolates a solution file from one grid to another. The grids can be node-
matching or non-node-matching.
3.2.1. Description
If the grids are exactly node-matching, no interpolation will be required, the solution will simply be
copied from one grid to the other. This is useful if a solution must be copied onto a grid that has been
reordered. Use the -nodes option for this specific mode.
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 19
Solution File Operations
If the grids are not node-matching, each target node will be interpolated in 3D in the source grid cells.
If the node lies outside of the original grid volume, the value at the closest surface projection is used.
This feature must be used with caution.
Note
Wall nodes have a special treatment. For some datafields (temperature, pressure, velocity,
heat flux, forces, beta), their value will be projected to the closest wall of the target grid. Use
the -raw option to disable this behavior.
If the source grid is curvilinear two-dimensional (such as ICE3D output grid files), it is suggested to use
the -flat option.
Note
-raw
Disable any automatic behavior (wall only, slip/noslip).
-flat
Use with map.grid/ice.grid source (GRID1) files.
-nodes
Use with reordered grids or grids same nodes coordinates, no interpolation is done, interpolation is a
closest-node search.
-walls
Interpolate all points from the nearest WALL boundary condition of the input grid.
-perbc
Values are computed on boundaries only and closest-surface/point search is done on the matching
boundary condition in the other grid. The two grids must share same boundary condition identifiers.
-outbc
Values computed on the target boundaries only (internal nodes = 0).
-threads=N
Execute the interpolation using multiple CPU cores.
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
20 of ANSYS, Inc. and its subsidiaries and affiliates.
soln2soln
3.2.3. Examples
Table 3.5: Interpolating Solutions
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 21
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
22 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 4: TimeBC Operations
The following sections of this chapter are:
4.1.TimeBC Files
4.2. interpTimeBC
4.3. genTimeBC
4.4. interpTurboDropTimeBC (TURBO)
4.5. mergebcs
4.6. generateRoughnessDat
The timebc file is used for inlet, wall and/or exit boundary conditions, and is created by fensapiceGUI
from the values input in the boundary conditions panel. A custom file can be created using these
command line tools.
FENSAP:
Custom timebc files can be set, overriding some settings of the boundary conditions panel, this feature
is for expert users and can be enabled by enabling the advanced options in FENSAP-ICE (Settings
Preferences Show advanced / beta solver options (available at next restart)). The Initial conditions
panel will then be accessible in the Conditions panel of FENSAP.
DROP3D:
Custom timebc file can be set in the Droplet initial solution panel, by choosing Input Profile
TimeBC file.
The TimeBC files can be viewed with the Viewmerical post-processor by using either the TimeBC file
input solution type, in the data-loader panel, or by launching it from the command line with the
viewmerical TIMEBC grid timebc.dat command.
4.2. interpTimeBC
interpTimeBC interpolates the nodal values of a grid/solution onto the nodes of a grid, writing these
values to a timebc file.
4.2.1. Description
A typical case for this command is when running a simulation using a solution from a different flow
solver (Fluent, CFX and so on) in which the inlet velocity is not uniform. The source and destination
grids are then the same and the boundary condition inlet values are extracted to a TimeBC file.
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 23
TimeBC Operations
The input and output grids can be the same, will be faster and interpolation-free.
-drop3d
Converts XVEL,YVEL,ZVEL fields (if specified) to a DROP3D input timebc.dat.
-lwc=VALUE
Adds a LWC (liquid water content) entry to the timebc, with the specified value.
-icc=VALUE
Adds a ICC (ice crystal content) entry to the timebc file, with the specified VALUE.
-dtemp=VALUE
Adds a constant droplet temperature.
-ctemp=VALUE
Adds a constant crystal temperature.
-crystals
Converts XVEL,YVEL,ZVEL fields (if specified) to a DROP3D CRYSTAL input timebc.dat file.
-out=FILENAME
Specifies the output filename (default is timebc.dat).
Note
4.2.3. Examples
Example 4.1: Extraction of Droplet Inlet Conditions from an Air Solution File
interpTimeBC grid.row01 soln.row01 grid.row01 1001 XVEL YVEL ZVEL -drop3d -lwc=0.001
The example above is:
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
24 of ANSYS, Inc. and its subsidiaries and affiliates.
genTimeBC
extracting the X/Y/Z velocity components from the airflow for the droplet solution.
Example 4.2: Droplet & Crystal Timebc Input File (TURBO Only)
interpTimeBC grid.row01 soln.row01 grid.row01 1001 XVEL YVEL ZVEL -drop3d -lwc=0.001 -crystals -
icc=0.009 -dtemp=270 -ctemp=270
Sets up a droplet and crystal timebc input file.
4.3. genTimeBC
genTimeBC generates a timeBC or a sandgrain roughness file from scratch.
4.3.1. Description
Note
genTimeBC is a tool enabling to create a timebc (boundary profile) input file. On a specified GRIDFILE
it can define boundary conditions for one or multiple boundary conditions. The value of each boundary
condition to write in the file, is defined by a tuple BC,Variable,Expression. The command line
can state multiple tuples. By default, the type of the boundary profile is -fensap, the tool can be
switched to alternate modes using the other options.
Tuple = BC,Variable,Expression
BC = BC to define
fensap = P,U,V,W,T,TURB1,TURB2
drop3d = LWC,U,V,W,DIAM,CRYST_LWC,CRYST_U/V/W
c3d = TEMP,HEAT
ale = DISPX,DISPY,DISPZ
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 25
TimeBC Operations
other = VAR_# the specified number will be used on the timebc entries
C3D only = For facet-based boundary profile, prefix a F to the tuple : "F**,***,***"
Expression = An algebric expression computing the value of the BC at each nodal location of the
boundary condition (See Expression Syntax (p. 31)). The expression can use X,Y,Z as input variable.
Table 4.5: The Expression Can Make Use of the Following Variables
XYZ
Coordinate of the evaluated node.
T
For time based equations (use -timeStart/Step/End also).
-timeStart=VALUE
Time value used for the first step.
-timeStep=VALUE
Time step used (require -timeEnd).
-timeEnd=VALUE
Final Time.
-drop3dConfig=file.par
Reads the DROP3D configuration and write a suitable timebc.dat file.
-bcExtra=BC,Variable,Extra
For advanced format timebc, last line value specification.
-out=timebc.dat
Sets the custom output file name.
4.4.1. Description
This is a TURBO feature only.
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
26 of ANSYS, Inc. and its subsidiaries and affiliates.
interpTurboDropTimeBC (TURBO)
This tool permits to do row-per-row pitch averaging of solution data, to create a timebc.dat file to
use in the next row. The tool will extract conditions from droplet or crystal solutions.
In addition to the pitch-averaged value, the tool permits value injection by modifying the value with
an expression. Expressions can read a datafile to construct a 1D inlet-profile dataset.
interpTurboDropTimeBC GRID1 SOLN1 bcGRID1 GRID2 bcGRID2 [-nmix NMIX] [-LWCref VALUE]
[-mflux] [-out FILE] [-varChange=FIELD,EXPR]
This tool will read a DROPLET solution for GRID1 and will interpolate onto GRID2 a timebc.dat file,
for use as input to DROP. Values are interpolated from BC1 of grid1 to BC2 of grid2.
-nmix
Number of sample points to use for the integration (suggested value: 50).
-rot X
DEPRECATED, If the GRID1 solution is in a rotating frame of reference and the GRID2 computation is
not, specify the rotation in RPM. (from 2012 onwards, all solutions are in absolute frame of reference).
-rotout X
Specify the GRID2 rotation speed. The timebc.dat written will be added that rotation speed.
-rotx/-roty/-rotz
Specify the rotation axis (default Z).
-mflux
Integrate the velocity by poderating using the mass-flux info.
-autoLWC
if -LWCref is not needed, this mode will: compute the mean LWC from the input outlet, and write it
to the fensap.par of the current dir; read the LWC from the input solution's directory fensap.par,
and use it for the clipping.
-LWCref / -ICCref
The reference LWC value default is 0.001 gm/m^3. Values below LWCREF*1.25e-6 will be clipped to
zero.
-crystal
Writes a crystal timebc file instead. LWC options will apply to ICC for a hybrid droplet+crystal timebc
file, use mergebcs tool.
-out FILENAME
Specify an output file (default is timebc.dat).
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 27
TimeBC Operations
-varChange=FIELD,EXPR
Permits to modify the interpolated datafield, either by fully replacing the value, or mixing it with other
values in the equation. EXPR is an algebraic equation which can be constructed with the X,Y,Z,R,THETA
variables and the current variable name. For Linux O/S: put the full -varChange in single quotes to
ensure proper shell parsing. Variables are: LWC,U,V,W[,TEMP,DIAM]. The TEMP and DIAM fields are
accessible only if the input solution has them.
-varChange=LWC,0.333
Forces the LWC to a constant value.
'-varChange=LWC,"(R>0.5)*LWC+(R<=0.5)*0.001'
Forces the LWC to 0.001 if the R coordinate is less than 0.5.
'-varChange=TEMP,fileData1D(R,"rTempProfile.txt")'
Loads the text file rTempProfile.txt as a 1D linear lookup table. It will change the value of the
variable TEMP, for which a new value will be computed as a function of R.
4.4.3. Examples
Table 4.11: Interpolation of Droplet Values with Temperature Modification
number_of_points
r valuer value
...
If the value of R falls between two entries, a linear interpolation is computed. See Expression Syn-
tax (p. 31) for reference on the possible input syntaxes for the varChange second argument.
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
28 of ANSYS, Inc. and its subsidiaries and affiliates.
generateRoughnessDat
4.5. mergebcs
mergebcs merges two timebc files defined on the same grid. The two files must not have any conflicts
(different BC-Variable-Node entries). Typically mergebcs is used to combine separate droplet and
crystal timebc files into a single one.
It can also be used to merge the output of a TimeBC interpolation (interpTimeBC and a field-specific
evaluation with equations or 1D profiles generated using genTimeBC).
4.6. generateRoughnessDat
generateRoughnessDat creates a surface sandgrain roughness input file with values computed
from a specified solution file.
4.6.1. Description
The sandgrain roughness file is defined with reference to the airflow (3D) grid, but if quantities from
an ICE3D (surface) solution are to be used, the solution must be transmogrified onto the 3D grid. Use
soln2soln in -flat mode to do this (See Examples (p. 30)).
-bc:ID=VALUE
Applies a value to all boundaries with ID=VALUE.
-range:XMIN,YMIN,ZMIN,XMAX,YMAX,ZMAX=VALUE
Range will apply to any wall.
-solnVar:SOLNFILE:FIELD:>FIELDVALUE:ROUGHVALUE
From the soln file solution file, read the datafield FIELD. For each node for which the value is greater
than FIELDVALUE, the roughness.dat file will contain the value ROUGHVALUE. The < operator is
also available.
-node:ID=VALUE
Assign the specified VALUE to the node number ID.
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 29
TimeBC Operations
-out:FILENAME
Specify an optional different output filename.
4.6.3. Examples
Table 4.16: Set up Roughness Values from Ice Thickness in Solution
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
30 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 5: Expression Syntax
The following sections of this chapter are:
5.1. Operators
5.2. Functions
FENSAP-ICE, solnEdit, convertgrid and other ANSYS tools share the same syntax for expression
evaluation.
An expression is a string defining an algebraic equation to compute a value. Typically, this equation is
evaluated at a node or for a specific {X,Y,Z} coordinate.
5.1. Operators
Arithmetic:
is for exponent. is
Logical:
is "and", is "or".
! is used to reverse a logical value (any nonzero value will be permuted to 0, 0 permuted to 1).
5.2. Functions
Table 5.1: Functions
min(val1,val2), max(val1,val2)
Value Operations - Returns the minimum/maximum of two values
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 31
Expression Syntax
fabs()
Absolute Value
inRange(value,min,max)
Returns 1 if the value within [min,max].
inRangeExcl(value,min,max)
Returns 1 if the value outside [min,max].
valueRange(val,min,max,valIN,valOUT)
Returns valIN if the value is within [min,max], returns valOUT otherwise.
valueRangeExcl(val,min,max,valIN,valOUT)
Same as valueRange, but when the value is outside [min,max].
ifValue(condition,valueTrue,valueFalse)
Returns valueTrue if the condition is true (nonzero), otherwise returns valueFalse.
File Data:
fileData1D(value,"filename")
Reads the filename from the current directory (must be a 1D dataset of N points). The data will be
interpolated linearly. Values out of range are clamped to the minimum/maximum data point.
npoints
variable value
variable value
variable value
variable value
...
0.5 291.75
0.6 293.4
0.73 295.9935
0.88 299.616
1.2 309.6
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
32 of ANSYS, Inc. and its subsidiaries and affiliates.
Functions
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 33
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
34 of ANSYS, Inc. and its subsidiaries and affiliates.
Index
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 35
Release 18.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
36 of ANSYS, Inc. and its subsidiaries and affiliates.