pw:: Application

Global actions of the application

Derives From

pw::Object

Summary

pw:: Application	Global actions of the application
Static Actions
getVersion	This action gets the program and version of the application.
checkForDuplicates	This action checks if loading the given file would result in duplicate named entities.
checkForMissingReferences	This action checks if loading the given file would result in missing references.
checkCAEUnsupportedEntities	This action checks for the number of unsupported entities that will be ignored or deleted if the file is loaded.
load	This action loads the entities and settings from the native file.
save	This action saves the current entities and settings to the native file format.
isModified	This action checks if the entities or settings have been modified since the last save.
clearModified	This action resets the flags that track whether or not modifications have occurred.
getProjectName	This action returns the project name which includes the file path and the filename of the currently associated file.
isEmpty	This action checks if there are no entities.
begin	This action begins a mode in the application.
setClipboard	This action sets the given list of entities to be the contents of the application clipboard.
clearClipboard	Clear the contents of the application clipboard.
isClipboardEmpty	This action checks if the application clipboard contains any entities.
getClipboardCount	This action returns the number of items explicitly copied to the clipboard.
reset	Reset the settings of the application
getCAESolverNames	This action gets the names of the available CAE solvers.
getCAEUnsupportedEntities	This action gets the existing entities unsupported by a CAE solver and dimension.
isValidDimension	This action determines if the given dimension is supported by a CAE solver.
isValidElement	This action determines if the given element type is supported by a CAE solver.
isValidElementTopology	This action determines if the given element topology type is supported by a CAE solver.
setCAESolver	This action sets the current CAE solver.
getCAESolver	This action gets the name of the current CAE solver.
setCAESolverDimension	This action sets the current CAE solver dimension.
getCAESolverDimension	This action gets the dimension of the current CAE solver.
areCAESolverVariablesSupported	This action returns whether settable variables are supported by the current CAE solver.
getCAESolverAttributeNames	This action gets the available CAE solver attribute names.
getCAESolverAttribute	This action gets the named CAE solver attribute.
setCAESolverAttribute	This action sets the named CAE solver attribute.
addCAESolverAttribute	This action adds the named attribute to the current CAE solver.
getCAESolverAttributeDefinition	This action gets the definition of a CAE solver attribute.
getFileTypes	This action gets the available filetype ids.
getFileTypeAttributeNames	This action gets the named file type attribute.
getFileTypeAttribute	This action gets the named file type attribute.
getRuntimeAttributeNames	This action gets the available runtime attribute names.
getRuntimeAttribute	This action gets the value of the named runtime attribute.
getRuntimeAttributeDefinition	This action gets the definition of a runtime attribute.
setOversetAssembler	This action sets the current overset assembler.
getOversetAssembler	This action gets the name of the current overset assembler.
areOversetBCsCompatible	This action return whether overset boundary conditions are compatible between the current assembler and another
getOversetAssemblerNames	This action gets the names of the available overset assemblers.
isValidOversetDimension	This action determines if the given dimension is supported by an overset assembler.
getOversetAssemblerAttribute	This action gets the named overset assembler attribute.
export	This action exports CAE data in a format specific to the currently selected analysis software.
getXYZ	This action gets the 3D position of the given point or grid coordinate.
combine	This action combines two points or grid coordinates in different ways.
getEntity	This action gets the entity of the given point or grid coordinate.
getDescription	This action gets the description of the given point or grid coordinate.
getUndoList	This action returns the list of undo levels available.
getRedoList	This action returns the list of redo levels available.
undo	This action undoes one step.
resetUndoLevels	This action resets the undo levels.
redo	This action redoes one step.
markUndoLevel	This action saves an undo checkpoint.
exit	This action shuts down the full application immediately, without any prompts to the user to warn about unsaved data.
isInteractive	Check to see if the Pointwise application is running in interactive mode with a GUI as opposed to being run in a Tcl batch interpreter.
getAllCommandNames	This action returns the names of all supported glyph commands.
setVerbosity	This command controls the level of text output of the application.
getVerbosity	This command reports the current level of filtering for text output by the application.
Static Attributes
UndoMaximumLevels	This sets/gets the maximum number of undo levels maintained.
GridPreference	This attribute is the grid preference of the application.
CAE Solver Common Attributes
FileExtensions	This gets the extensions of files exported for the CAE solver.
FileDestination	This gets the type of file destination that is expected by the current CAE when calling the pw::Application.export command.
AllowedFileFormats	This gets the allowed file formats when exporting for the CAE solver.
AllowedDataPrecision	This gets the allowed data precision when exporting for the CAE solver.
AllowedFileByteOrder	This gets the allowed file byte order when exporting for the CAE solver.
AllowedExportConditionsOnly	This gets a boolean flag that indicates whether the CAE solver allows export of the conditions data without having to export the grid data.
AllowedVolumeConditions	This returns a boolean flag that indicates whether the CAE solver supports the volume conditions.
ImplementationMethod	This gets the method used for the implementation of the exporter.
AllowedExportMirroring	This returns a boolean flag that indicates whether the CAE solver supports setting an export mirror plane.
AllowedElements	This gets a list of the element types supported by the CAE solver.
AllowedElementTopologies	This gets a list of the element topologies supported by the CAE solver.
MaxMeshPolynomialDegree	Returns an integer specifying the maximum mesh elevation polynomial degree supported by the current CAE solver.
MeshLinkSupported	This returns a boolean flag that indicates whether the current CAE solver supports the export of MeshLink files.
CAE Solver Attributes for {ADS/ Leo (structured)}
Title	Case Name.
CAE Solver Attributes for {ADS/ Leo (unstructured)}
Title	Case Name.
CAE Solver Attributes for CFL3D
ProjectDescription	The grid project description written to the inp file.
CAE Solver Attributes for CGNS
CGNS. FileType	Specifies the exported file’s internal storage type.
CGNS. Units	Linear units of exported values.
CGNS. UseFamilyConditions	Specifies how condition data is written to the file.
CAE Solver Attributes for CMSoft-Aero
LoggingLevel	Controls message logging level.
CAE Solver Attributes for Cobalt
GridFileExtension	Sets the file extension used for Cobalt grid files.
CAE Solver Attributes for {EXODUS II}
BlockNumberScheme	The block id numbering scheme.
LogVerbosity	Controls vebosity of export logging to the message window.
MaxCacheSize	Set the max cache size (MB).
CAE Solver Attributes for Edge
ExportPriority	Controls the export method.
CAE Solver Attributes for FrontFlow
ExportPriority	Controls the exporter’s priority.
CAE Solver Attributes for GASP
CGNS. FileType	Specifies the exported file’s internal storage type.
CGNS. Units	Linear units of exported values.
CGNS. UseFamilyConditions	Specifies how condition data is written to the file.
CAE Solver Attributes for Gambit
BcType	Specify the BC export format.
Dim2PointFormat	Controls the 2-D point export format.
CAE Solver Attributes for Gmsh
ExportGmshFileFormat	Choose to export as Gmsh file Version 2 or Version 4.
CAE Solver Attributes for {Gridgen Generic}
ExportVCs	Controls the export of volume conditions.
CAE Solver Attributes for {INCA v2}
Compressibility	Flow compressibility.
CAE Solver Attributes for Kestrel
FileContactInfo	File contact informtion.
FileDescription	File description.
MeshCoordinateSystem	Mesh coordinate system.
MeshDescription	Mesh description.
MeshName	Mesh name.
MeshReferenceArea	Reference area for force/moment calculation.
MeshReferenceLength	Reference length for Reynolds number.
MeshReferencePointDescription	Reference point description.
MeshReferencePointX	Reference point X coordinate.
MeshReferencePointY	Reference point Y coordinate.
MeshReferencePointZ	Reference point Z coordinate.
MeshScale	Mesh global scale.
MeshUnits	Mesh dimensional units.
CAE Solver Attributes for NPARC
Mach	Mach number.
NPARC. BcStyle	NPARC BC style.
NPARC. Version	NPARC file version.
CAE Solver Attributes for NSU3D
MaxCacheSize	Set the max cache size (MB).
CAE Solver Attributes for Fidelity
CGNS. FileType	Specifies the exported file’s internal storage type.
CGNS. Units	Linear units of exported values.
CGNS. UseFamilyConditions	Specifies how condition data is written to the file.
CAE Solver Attributes for FidelityPBS
CellExport	Controls the export of cell sets and zones.
FaceExport	Controls the export of face sets and zones.
PointPrecision	Controls the export of face sets and zones.
SideBCExport	Controls how BCs are assigned to the top and base boundaries for 2D export.
Thickness	Offset distance for 2D export.
CAE Solver Attributes for OpenFOAM
CellExport	Controls the export of cell sets and zones.
FaceExport	Controls the export of face sets and zones.
PointPrecision	Controls the export of face sets and zones.
SideBCExport	Controls how BCs are assigned to the top and base boundaries for 2D export.
Thickness	Offset distance for 2D export.
CAE Solver Attributes for TAU
DataModel	Controls the underlying NetCDF data model used by TAU export.
Thickness	Offset distance for 2D export.
CAE Solver Attributes for Tecplot
VariableMethodFor2D	Controls how the XYZ variables are exported for 2D grids.
CAE Solver Attributes for {Thermal Desktop}
ShellOrientation	Default PSHELL orientation.
ShellThickness	Default PSHELL Thickness.
WideFormat	Export using wide column format.
CAE Solver Attributes for UGRID
ExtensionType	File name extension type.
CAE Solver Attributes for UMCPSEG
CreateLog	Controls generation of a log file for debugging.
CAE Solver Attributes for USM3D
MaxSegmentSize	Maximum size of a connectivity segment in bytes.
CAE Solver Attributes for {WIND (structured)}
Units	Grid dimensional units.
CAE Solver Attributes for {WIND (unstructured)}
Units	Grid dimensional units.
Overset Assembler Attributes
AssemblyAllowed	This gets the flag that indicates whether the current overset assembler allows overset grid assembly.
AllowedBoundaryConditions	This gets the flag that indicates whether the current overset assembler allows boundary conditions.
AllowedVolumeConditions	This gets the flag that indicates whether the current overset assembler allows volume conditions.
AllowedCollarBoundaryConditions	This gets the flag that indicates whether the current overset assembler allows collar boundary conditions.
File Type Common Attributes
Name	This gets the file type name.
Key	This gets the file type unique key.
Mode	This gets the file type IO modes that support this attribute.
Destination	This gets the IO destination that is expected by the file type.
Extensions	This gets the valid file type extensions.
Filters	This gets the glob filters used to identify filenames supported by this file type.
Description	This gets the file type description.
CanCheckValidFile	Returns 1 if file type supports file validation.
CanImportConditions	Returns 1 if file type supports BC/VC import.
Runtime Attributes
AppName	Application name.
AppVersion	Application version.
AppNameAndVersion	Application name and version.
AppVersionMajor	Application major version number.
AppVersionMinor	Application minor version number.
AppVersionRelease	Application release version number.
AppVersionCandidate	Application candidate version number.
AppMachine	Application machine architecture.
DirSysUserHome	User home directory.
DirSysUserPrivate	User private directory.
DirSysUserPublic	User public directory.
DirAppPublic	Application public directory.
DirAppPlugins	Application plugins directory.
DirPublicPlugins	Public plugins directory.
DirSysTemp	System temporary directory.
DirSysAppPublic	System application public directory.

setClipboard

pw::Application setClipboard entity_list

This action sets the given list of entities to be the contents of the application clipboard. The entities are copied in their current state and are not available for usage until pasted using the pw::Application begin Paste command. Note that when writing a script that uses copying, if the copied data is not meant to be left on the clipboard for use outside of the script, one should use the pw::Copier mode instead of setClipboard.

Parameters

entity_list

This parameter is a list of pw::Entity or pw::Spacing objects, or a single pw::Entity or pw::Spacing object.

Returns

This action returns nothing.

Information

This command supports progress updates.

When pw::Spacing objects are copied to the clipboard, all spacing objects with non-zero values are retained.

For objects that have a zero value, they may be modified or ignored as follows. If the spacing object is associated with a dimensioned connector, the actual grid spacing value will be used as the spacing value. If the spacing object is not associated with a dimensioned connector and other spacing objects that do have either an explicit or implicit non-zero value are included in the copy operation, then the zero value spacing objects will be ignored. Finally, if only zero value spacing objects are specified, they will be copied as is. Note that pasting the zero spacing object will effective erase any specified spacing values on the selected targets of the paste operation.

Example

Code

# Copy 2 connectors to the clipboard
pw::Application setClipboard [list $con $con2]
puts "Clipboard size (a): [$pw::Application getClipboardCount]"
# Copy a the beginning spacing of a connector's second
# subconnector to the clipboard
set spacing1 [[$con getDistribution 1] getBeginSpacing]
pw::Application setClipboard $spacing1
puts "Clipboard size (b): [$pw::Application getClipboardCount]"
# Copy 2 non-zero spacings and 1 zero spacing to the clipboard
set spacing2 [[$con getDistribution 1] getEndSpacing]
set zeroSpace [pw::SpacingExplicit create]
pw::Application setClipboard [list $spacing1 $spacing2 $zeroSpace]
puts "Clipboard size (c): [$pw::Application getClipboardCount]"
# Copy a single zero-value spacing to the clipboard
pw::Application setClipboard [list $zeroSpace]
puts "Clipboard size (d): [$pw::Application getClipboardCount]"

Output

Clipboard size (a): 2
Clipboard size (b): 1
Clipboard size (c): 2
Clipboard size (d): 1

pw::Application setClipboard $domain
set nc [pw::Application getClipboardCount -type pw::Connector]
set nd [pw::Application getClipboardCount -type pw::Domain]
set total [pw::Application getClipboardCount]
puts "Total clipboard items: $total"
puts "Clipboard connectors : $nc"
puts "Clipboard domains : $nd"

Solver: 'Altair/AcuSolve'
Solver: 'ADPAC'
Solver: 'ANSYS CFX'
Solver: 'ANSYS FLUENT'
Solver: 'CFD++'
Solver: 'CFDSHIP-IOWA'
Solver: 'CFL3D'
Solver: 'CGNS'
...snip...
Solver: 'UGRID'
Solver: 'USM3D'
Solver: 'VSAERO'
Solver: 'VSAEROhybrid'
Solver: 'WIND (structured)'
Solver: 'WIND (unstructured)'

puts [pw::Application getCAESolverAttributeNames]
puts ""
puts [pw::Application getCAESolverAttributeNames "Allowed*Conditions"]
puts ""
puts [pw::Application getCAESolverAttributeNames -fullname "Allowed*Conditions"]
puts ""
puts [pw::Application getCAESolverAttributeNames -group CAE]
puts ""
puts [pw::Application getCAESolverAttributeNames -fullname -regex "(c|a)t"]

AllowedFileFormats AllowedDataPrecision AllowedExportConditionsOnly
AllowedBoundaryConditions AllowedVolumeConditions FileExtensions
FileDestination {Combine Anisotropic Cells} Structured

AllowedBoundaryConditions AllowedVolumeConditions

IO.AllowedBoundaryConditions IO.AllowedVolumeConditions

{Combine Anisotropic Cells} Structured

IO.AllowedFileFormats IO.AllowedDataPrecision IO.FileDestination CAE.Structured

addCAESolverAttribute

pw::Application addCAESolverAttribute group name type access desc val range

This action adds the named attribute to the current CAE solver.

Parameters

All parameters must be present and in the order specified.

group	The attribute group name. Must be CAE or an empty string.
name	The attribute’s name string.
type	The attribute’s data type string. One of Bool, Int, UInt, String, Real, Enum, StringList, EnumList.
access	The attribute’s access specification string. Combination of: R, W (R=read, W=write).
desc	The attribute’s description string.
val	The attribute’s default/initial value. Value must be consistent with the attribute type.
range	A string representing the attribute’s valid range specification. Range specifications are type-specific (see below). If no range is given, the attribute can assume any machine valid value.

Returns

This action returns nothing.

Attribute Types

Bool	Logical true/false value
Int	Signed integer value
Uint	Unsigned integer value
Real	Floating point value
String	A text string value
StringList	A collection of String values
Enum	A string value with an associated integer value. The string must be one of a predefined set of valid string values.
EnumList	A collection of Enum values

Attribute Access

R	Attribute value is readable
W	Attribute value is writable
D	Attribute value is deletable

String Range Format

pattern[ minLen maxLen]

where,

pattern	A regular expression (regex) or a glob expression pattern. This pattern is used to validate string values. A regex pattern is delimited with slash characters (/regexPattern/). A glob pattern is delimited with colon characters (:globPattern:).
minLen	The smallest valid string length (>= 0).
maxLen	The largest valid string length (>= minLen). Use +Inf for an unlimited string length.

example,

The regex pattern “/^hello.*!$/” and the glob pattern “:hello*!:” will allow strings starting with “hello”, followed by zero or more characters, and ending with “!”. Some valid strings include “hello world!”, “hello!”, and “hello!!!”.

Enum Range Format

[@<sepChar>]name[=int][<sepChar>name[=int]...]

where,

@<sepChar>	The optional separator-char declaration. The character following the ‘@’ is the separator. If not present, the separator defaults to the ‘\|’ character.
name[=val]	The enumerator item name and the optional integer value that corresponds to this name. If val is not specified for an name, it assumes the value of the previous name plus 1. If there is no previous name, it is assigned to 0 by default. Each name MUST be unique within an enum definition. However, val values may be repeated.

enum example 1,

The follwing 2 Enums are equivalent. The first enum uses the default ‘|’ (vbar) separator character. The second uses a custom ‘,’ (comma) separator character.

Resulting in the following enum item associations

up=0, down=6, left=7, right=10, upLeft=11, upRight=12, downLeft=6, downRight=7

enum example 2,

The follwing 2 Enums are NOT equivalent.

A,B|C,D|E,F produces “A,B”=0, “C,D”=1, “E,F”=2 @,A,B|C,D|E,F produces “A”=0, “B|C”=1 “D|E”=2 “F”=3

Bool Range Format

The Bool range format is the same as the Enum range format. However, for Bool, each item’s value is interpreted as a logical true or false. The names defined in the range are added to the standard “string to boolean” name mappings.

The standard “string to boolean” mappings are;

”true” and “yes” map to logical true
”false” and “no” map to logical false

All integer values are mapped as expected. That is, 0 is mapped to false and all other non-zero integer values are mapped to true.

example,

This range will cast the strings “true,yes,accept,bad” to true and “false,no,reject,bad” to false.

”accept=1|reject=0|good=1|bad=0”

Int, UInt and Real Range Format

minVal maxVal[ typicalMinVal typicalMaxVal]

where,

minVal	The smallest valid value or -Inf to allow any machine valid value less than maxVal.
maxVal	The largest valid value or +Inf to allow any machine valid value greater than minVal.
typicalMinVal	The smallest value that is typically used for this attribute where “minVal <= typicalMinVal < typicalMaxVal”.
typicalMaxVal	The largest value that is typically used for this attribute where “typicalMinVal < typicalMaxVal <= maxVal”.

StringList Range Format

pattern[ minLen maxLen[ minCount maxCount]]

where,

pattern minLen maxLen - See the String Range Format for details.

minCount	The smallest number of string items required (>= 0).
maxCount	The largest number of string items allowed (>= minLen). Use +Inf for an unlimited number of items.

EnumList Range Format

{EnumRange}[ minCount maxCount]

where,

EnumRange	See the Enum Range Format for details.
minCount	The smallest number of enum items required (>= 0).
maxCount	The largest number of enum items allowed (>= minLen). Use +Inf for an unlimited number of items.

Examples

Code

proc addAttr { name type val {range {}} {access RW} } {
    set desc "$type attribute $name"
    pw::Application addCAESolverAttribute CAE $name $type $access $desc $val $range
}

pw::Application reset

addAttr iAttr  Int -5 {-10 10}
addAttr uAttr  UInt 5
addAttr rAttr  Real 1.1 {0.0 +Inf 1.0 3.0}
addAttr sAttr1 String "str3" {/str[0-9]/ 4 4}
addAttr sAttr2 String "val!" {:v*: 0 +Inf}
addAttr eAttr1 Enum "e00" {e00|e01|e02|e03}
addAttr eAttr2 Enum "e03" {@,e00,e01,e02,e03}
addAttr slAtt1 StringList "str3|str7|str9"  {/str[0-9]/ 4 4 1 5}
addAttr slAtt2 StringList "victor|vicky|vlad" {:v*: 0 +Inf 1 5}
addAttr elAttr EnumList "e00|e03|e01" {{e00|e01|e02|e03} 1 5}

set fmt "| %-7.7s | %-10.10s | %-17.17s | %-22.22s | %-2.2s | %-28.28s |"
set hr [string repeat "-" 50]
puts [format $fmt "name" "type" "default" "range" "rw" "description"]
puts [format $fmt $hr $hr $hr $hr $hr $hr]
set names [pw::Application getCAESolverAttributeNames]
foreach name $names {
    set defn [pw::Application getCAESolverAttributeDefinition $name]
    lassign $defn group name type access desc default range
    puts [format $fmt $name $type $default $range $access $desc]
}

Output

| name    | type       | default           | range                  | rw | description                  |
| ------- | ---------- | ----------------- | ---------------------- | -- | ---------------------------- |
| iAttr   | Int        | -5                | -10 10                 | RW | Int attribute iAttr          |
| uAttr   | UInt       | 5                 |                        | RW | UInt attribute uAttr         |
| rAttr   | Real       | 1.1               | 0.0 +Inf 1.0 3.0       | RW | Real attribute rAttr         |
| sAttr1  | String     | str3              | /str[0-9]/ 4 4         | RW | String attribute sAttr1      |
| sAttr2  | String     | val!              | :v*: 0 +Inf            | RW | String attribute sAttr2      |
| eAttr1  | Enum       | e00               | e00|e01|e02|e03        | RW | Enum attribute eAttr1        |
| eAttr2  | Enum       | e03               | @,e00,e01,e02,e03      | RW | Enum attribute eAttr2        |
| slAtt1  | StringList | str3|str7|str9    | /str[0-9]/ 4 4 1 5     | RW | StringList attribute slAtt1  |
| slAtt2  | StringList | victor|vicky|vlad | :v*: 0 +Inf 1 5        | RW | StringList attribute slAtt2  |
| elAttr  | EnumList   | e00|e03|e01       | {e00|e01|e02|e03} 1 5  | RW | EnumList attribute elAttr    |

pw::Application reset

proc addCaeAttribute { name type val range } {
set desc "Testing '$type' attribute"
pw::Application addCAESolverAttribute CAE $name $type RW $desc $val $range
}

proc putDefn { def } {
lassign $def group name type access desc value range
puts " group = '$group'"
puts " name = '$name'"
puts " type = '$type'"
puts " access = '$access'"
puts " desc = '$desc'"
puts " value = '$value'"
puts " range = '$range'"
puts ""
}

addCaeAttribute test Enum {Element Side} {Element Side=22|Node=33}
puts "RANGE WITH ORDINALS"
putDefn [pw::Application getCAESolverAttributeDefinition test]

puts "RANGE WITH NAMES ONLY"
putDefn [pw::Application getCAESolverAttributeDefinition test -rangeNamesOnly]

RANGE WITH ORDINALS
group = 'CAE'
name = 'test'
type = 'Enum'
access = 'RW'
desc = 'Testing 'Enum' attribute'
value = 'Element Side'
range = 'Element Side=22|Node=33'

RANGE WITH NAMES ONLY
group = 'CAE'
name = 'test'
type = 'Enum'
access = 'RW'
desc = 'Testing 'Enum' attribute'
value = 'Element Side'
range = 'Element Side|Node'

getFileTypes

pw::Application getFileTypes ?-mode < DatabaseImporter | DatabaseExporter | GridImporter | GridExporter >? ?-file filename?

This action gets the available filetype ids.

Parameters

-mode io_mode	This optional string flag signifies that only filetypes that are compatible with the named io_mode should be returned. At this time, only the GridImporter mode is supported. If not specified, all filetype ids are returned.
-file filename	This optional string flag will restrict the returned filetype ids those whose filters match the filename. If there are multiple matches, the filetype id with the “best” match will be first in the returned list. See <getFileTypeAttribute Filters>.

Returns

A string list of filetype ids.

Example

Code

proc putsFileTypes { filename } {
  set ftypes [pw::Application getFileTypes -file $filename]
  puts ""
  puts "The file $filename matches file types: [list $ftypes]"
  foreach fileType $ftypes {
    set filters [pw::Application getFileTypeAttribute $fileType Filters]
    puts "  $fileType Filters: [list $filters]"
  }
}

proc putsFilterMap {} {
  set allFilters [dict create]
  foreach fileType [pw::Application getFileTypes] {
    foreach filter [pw::Application getFileTypeAttribute $fileType Filters] {
      dict lappend allFilters [string tolower $filter] $fileType
    }
  }
  set wd1 [string length [set hdr1 {Filter}]]
  set wd2 [string length [set hdr2 {Associated Import File Types}]]
  dict for {filter fileTypes} $allFilters {
    if { $wd1 < [string length $filter] } {
      set wd1 [string length $filter]
    }
    if { $wd2 < [string length $fileTypes] } {
      set wd2 [string length $fileTypes]
    }
  }
  set fmt "| %-${wd1}.${wd1}s | %-${wd2}.${wd2}s |"
  puts {}
  puts [format $fmt $hdr1 $hdr2]
  puts [format $fmt [string repeat - $wd1] [string repeat - $wd2]]
  foreach filter [lsort -ascii [dict keys $allFilters]] {
    puts [format $fmt $filter [dict get $allFilters $filter]]
  }
}

puts [pw::Application getFileTypes]
puts [pw::Application getFileTypes -mode GridImporter]
catch {pw::Application getFileTypes -mode GridExporter} err
puts [string trim $err]
putsFileTypes /path/to/grid.cgns
putsFileTypes /path/to/points
putsFileTypes /path/to/grid.b8.ugrid
putsFileTypes /path/to/grid.grd
putsFilterMap

Output

CFD++ CFX CGNS FUN3D  ...snip...  UCD UGRID VRML Xpatch
CFD++ CFX CGNS FUN3D  ...snip...  UCD UGRID VRML Xpatch
ERROR: usage (argument 3): pw::Application getFileTypes -mode GridExporter is not supported yet.

The file /path/to/grid.cgns matches file types: CGNS
  CGNS Filters: *.cgns

The file /path/to/points matches file types: OpenFOAM
  OpenFOAM Filters: {faces owner neighbour points}

The file /path/to/grid.b8.ugrid matches file types: {FUN3D UGRID}
  FUN3D Filters: *.b8.ugrid
  UGRID Filters: *.ugrid

The file /path/to/grid.grd matches file types: {Fluent CFX GridPro Network3D}
  Fluent Filters: {*.cas *.GRD}
  CFX Filters: *.grd
  GridPro Filters: *.grd
  Network3D Filters: *.grd

| Filter      | Associated Import File Types |
| ----------- | ---------------------------- |
| *.b8.ugrid  | FUN3D                        |
| *.bin       | CFD++                        |
| *.bin.*     | CFD++                        |
| *.cas       | Fluent                       |
| *.cgns      | CGNS                         |
| *.dat       | Segment                      |
| *.dem       | DEM                          |
| *.facet     | Xpatch                       |
| *.gg        | Gridgen                      |
| *.grd       | CFX Fluent GridPro Network3D |
| *.grp       | CFD++                        |
| *.nas       | Nastran                      |
| *.net       | Network                      |
| *.p3d       | PLOT3D                       |
| *.pat       | Patran                       |
| *.precrunch | CRUNCH                       |
| *.stl       | STL                          |
| *.su2       | SU2                          |
| *.ucd       | UCD                          |
| *.ugrid     | UGRID                        |
| *.uns       | FVUNS FVUNS30                |
| *.vrml      | VRML                         |
| *.wrl       | VRML                         |
| *.x         | PLOT3D                       |
| *.xyz       | PLOT3D                       |
| faces       | OpenFOAM                     |
| neighbour   | OpenFOAM                     |
| owner       | OpenFOAM                     |
| points      | OpenFOAM                     |

foreach fileType [pw::Application getFileTypes] {
puts ""
puts "File Type: $fileType"
foreach attrName [pw::Application getFileTypeAttributeNames $fileType] {
set val [pw::Application getFileTypeAttribute $fileType $attrName]
puts [format " %-17.17s = %s" $attrName $val]
}
}

File Type: CGNS
Name = CGNS
Key = 0
Mode = GridImporter
Destination = Filename
Extensions = cgns
Filters = *.cgns
Description = CGNS Volume and Surface Grid
CanCheckValidFile = 0

File Type: OpenFOAM
Name = OpenFOAM
Key = 2882339216
Mode = GridImporter
Destination = Folder
Extensions =
Filters = faces owner neighbour points
Description = OpenFOAM grid importer
CanCheckValidFile = 0

File Type: VRML
Name = VRML
Key = 21
Mode = GridImporter
Destination = Filename
Extensions = wrl vrml
Filters = *.wrl *.vrml
Description = VRML Unstructured Surface Grid
CanCheckValidFile = 0

getRuntimeAttributeNames

pw::Application getRuntimeAttributeNames ?-regex? ?pattern?

This action gets the available runtime attribute names.

Parameters

-regex	This optional flag signifies that the given pattern should be considered a regular expression pattern rather than a glob pattern.
pattern	This optional parameter is the string pattern used to filter the returned attribute names. If a pattern is not given, all runtime attribute names are returned.

Returns

A string list of the matching runtime attribute names.

Example

Code

proc dumpAttrs { args } {
  set names [pw::Application getRuntimeAttributeNames {*}$args]
  if { 0 == [llength $names] } {
    puts "No runtime attributes found matching '$args'"
    puts ""
    return
  }
  set maxWd 20
  set maxWd2 20
  foreach name $names {
    if { [string length $name] > $maxWd } {
      set maxWd [string length $name]
    }
    set val [pw::Application getRuntimeAttribute $name]
    if { [string length $val] > $maxWd2 } {
      set maxWd2 [string length $val]
    }
  }
  set fmt "| %-${maxWd}.${maxWd}s | %-6.6s | %-3.3s | %-${maxWd2}.${maxWd2}s | %-10.10s |"
  set dash [string repeat - [expr {$maxWd + $maxWd2}]]

  puts "Runtime attributes matching '$args'"
  puts [format $fmt Name Type RW Value Range]
  puts [format $fmt $dash $dash $dash $dash $dash]
  foreach name $names {
      set val [pw::Application getRuntimeAttribute $name]
      set def [pw::Application getRuntimeAttributeDefinition $name]
      lassign $def group name type access desc defVal range
      puts [format $fmt $name $type $access $val $range]
  }
  puts ""
}

dumpAttrs
dumpAttrs App*
dumpAttrs -regex Mac|Minor
dumpAttrs *QQQ*

# will fail
if { [catch {pw::Application getRuntimeAttribute} err] } {
  puts $err
  puts ""
}

# will fail
if { [catch {pw::Application getRuntimeAttribute XXXX} err] } {
  puts $err
  puts ""
}

Output

Runtime attributes matching ''
| Name                 | Type   | RW  | Value                                                                             | Range      |
| -------------------- | ------ | --- | --------------------------------------------------------------------------------- | ---------- |
| AppName              | String | R   | Pointwise                                                                         |            |
| AppVersion           | String | R   | V18.1                                                                             |            |
| AppNameAndVersion    | String | R   | Pointwise V18.1                                                                   |            |
| AppVersionMajor      | UInt   | R   | 18                                                                                |            |
| AppVersionMinor      | UInt   | R   | 1                                                                                 |            |
| AppVersionRelease    | UInt   | R   | 1                                                                                 |            |
| AppVersionCandidate  | UInt   | R   | 0                                                                                 |            |
| AppMachine           | String | R   | Win64                                                                             |            |
| AppType              | String | R   | Debug                                                                             |            |
| DirSysUserHome       | String | R   | C:\Users\dgarlisch\                                                               |            |
| DirSysUserPrivate    | String | R   | \\filehost\home\dgarlisch\Documents\                                              |            |
| DirSysUserPublic     | String | R   | C:\Users\Public\Documents\                                                        |            |
| DirAppPublic         | String | R   | C:\ProgramData\Pointwise\                                                         |            |
| DirAppPlugins        | String | R   | C:\dgarlisch\p4\dgarlisch_aerostar\gridgen\pointwise_rc\dist\win64\plugins\debug\ |            |
| DirPublicPlugins     | String | R   | C:\ProgramData\Pointwise\plugins\debug\                                           |            |
| DirSysTemp           | String | R   | C:\Users\DGARLI~1\AppData\Local\Temp\                                             |            |
| DirSysAppPublic      | String | R   | C:\ProgramData\                                                                   |            |

Runtime attributes matching 'App*'
| Name                 | Type   | RW  | Value                | Range      |
| -------------------- | ------ | --- | -------------------- | ---------- |
| AppName              | String | R   | Pointwise            |            |
| AppVersion           | String | R   | V18.1                |            |
| AppNameAndVersion    | String | R   | Pointwise V18.1      |            |
| AppVersionMajor      | UInt   | R   | 18                   |            |
| AppVersionMinor      | UInt   | R   | 1                    |            |
| AppVersionRelease    | UInt   | R   | 1                    |            |
| AppVersionCandidate  | UInt   | R   | 0                    |            |
| AppMachine           | String | R   | Win64                |            |
| AppType              | String | R   | Debug                |            |

Runtime attributes matching '-regex Mac|Minor'
| Name                 | Type   | RW  | Value                | Range      |
| -------------------- | ------ | --- | -------------------- | ---------- |
| AppVersionMinor      | UInt   | R   | 1                    |            |
| AppMachine           | String | R   | Win64                |            |

No runtime attributes found matching '*QQQ*'

ERROR: usage (argument 2): pw::Application getRuntimeAttribute attribute_name

ERROR: Attribute does not exist: 'XXXX'

pw::Application setCAESolver CGNS
set maxPolyDegree [pw::Application getCAESolverAttribute MaxMeshPolynomialDegree]
if { 1 == $maxPolyDegree } {
puts "Current solver does not support mesh elevation."
} else {
puts "Current solver support mesh elevation up to $maxPolyDegree."
}

set solvers {CGNS USM3D TACOMA OpenFOAM}
foreach solver $solvers {
pw::Application setCAESolver $solver
set $max [pw::Application getCAESolverAttribute MaxMeshPolynomialDegree]
if { 1 == $max } {
set msg "Does not support high order meshes."
} else {
set msg "Supports high order meshes up to degree $maxPolyDegree."
}
puts "$solver: $msg"
}

set solvers {CGNS OpenFOAM NASA/FUN3D Kestrel}
foreach solver $solvers {
foreach dimty {2 3} {
if { [catch {pw::Application setCAESolver $solver $dimty} msg] } {
set msg [string trim $msg]
} elseif { [pw::Application getCAESolverAttribute MeshLinkSupported] } {
set msg "Supports MeshLink export."
} else {
set msg "Does not support MeshLink export."
}
puts "$solver ${dimty}-D: $msg"
}
puts ""
}

CGNS 2-D: Does not support MeshLink export.
CGNS 3-D: Supports MeshLink export.

OpenFOAM 2-D: Does not support MeshLink export.
OpenFOAM 3-D: Does not support MeshLink export.

NASA/FUN3D 2-D: Invalid dimension for given CAE solver
NASA/FUN3D 3-D: Supports MeshLink export.

Kestrel 2-D: Does not support MeshLink export.
Kestrel 3-D: Supports MeshLink export.

pw:: Application

Derives From

Static Actions

getVersion

Parameters

Returns

Example

checkForDuplicates

Parameters

Returns

Information

Example

checkForMissingReferences

Parameters

Returns

Information

Example

checkCAEUnsupportedEntities

Parameters

Returns

Information

Example

load

Parameters

Returns

Information

Example

save

Parameters

Returns

Information

Example

isModified

Parameters

Returns

Example

clearModified

Parameters

Returns

getProjectName

Parameters

Returns

See Also

isEmpty

Parameters

Returns

Example

begin

Parameters

Returns

Information

Example

setClipboard

Parameters

Returns

Information

Example

clearClipboard

Parameters

Returns

isClipboardEmpty

Parameters

Returns

Example

getClipboardCount

Parameters

Returns

Example

reset

Parameters

Returns

Information

Example

getCAESolverNames

Parameters

Returns

Example

getCAEUnsupportedEntities

Parameters

Returns