pw:: ProjectLoader

$loader get/setAppendMode append

This attribute controls whether the data being loaded is treated as an append or a replace.

Type

This attribute is a boolean, with true meaning that the load is an append.

Default

The default value for this attribute is true.

Information

Grid and database data existing prior to this load will not be changed.  The AppendMode only controls how the data being loaded is treated.  If you want the existing grid data to be cleared, you must call first pw::Application.reset.

If set to true, the current CAE solver is not changed.  If the solver in the file is different from the current solver, all BCs and VCs loaded from the file will have their physical types set to Unspecified.  The BCs and VCs that existed prior to the load, will retain their physical types.

If set to false, the current CAE solver is changed to the one specified in the file being loaded.  If the solver in the file is different from the current solver, all existing BCs and VCs will have their physical types set to Unspecified.  The BCs and VCs loaded from the file will retain their physical types.

See also

pw::Application load -ignoreCAESolver

Example

Code

# Clear out all existing data
pw::Application reset

# Loads all data in $pwFile1 and sets the CAE solver as specified in $pwFile1
set loader1 [pw::Application begin ProjectLoader]
$loader1 initialize $pwFile1
$loader2 AppendMode false
$loader1 load
$loader1 end
unset loader1

# Merges all the data in $pwFile2 without changing the CAE solver
set loader2 [pw::Application begin ProjectLoader]
$loader2 initialize $pwFile2
$loader2 load
$loader2 end
unset loader2

$loader get/setEnvironmentMode environment

This attribute controls whether the load is environment only.

Type

This attribute is a boolean, with true meaning that the load is environment only.

Default

The default value for this attribute is false.

Information

None

$loader get/setRepairMode mode

This attribute controls how connectors with grid points that are out of sync with their distribution functions are loaded.

Type

This attribute is a string, with valid values being < KeepGridPoints | KeepDistributions | Defer >.

Default

The default value for this attribute is KeepGridPoints.

Information

If set to Defer, then after the load action completes, the getRepairConnectors action can be called to get the connectors that need to be repaired and the repair action can be called to repair the connectors.

$loader get/setRulesOption option

This attribute controls how rules are processed by load.

Type

This attribute is a string, that is one of <KeepOld|KeepNew|KeepBoth>.

Default

The default value for this attribute is KeepOld.

Information

If option is KeepOld, the rules in the file are discarded.

If option is KeepNew, the rules in the file replace the existing rules.

If option is KeepBoth, both sets of rules are merged which may lead to conflicting or duplicate rules that will have to be sorted out manually.

If there are no rules in the current project, then the KeepNew option is used regardless of the specified option.

$loader initialize filename

This action initializes the mode with the file name.

Parameters

Returns

This action returns a boolean where true if initialized, false if not.

Notes

None.

$loader getFileInformation option

This action initializes returns information about the file after the mode has been initialized with the file name.

Parameters

Returns

This action returns a different value based on the option parameter:

• Description - When this value is given, the action will return a list of string values if the file format supports it (not supported for files written with a version of Pointwise older than V17.0).
• ProgramVersion - When this value is given, the action will return a string representing the version number of the program that wrote the file.  The format will be “VMM.m”, “VMM.mRn”, or “VMM.mRnCc”, where ‘MM’ is the major version number, ‘m’ is the minor version number, ‘R’ is either ‘A’ (alpha), ‘B’ (beta), or ‘R’ (release), ‘n’ is the release number, and ‘c’ is the candidate number.
• FileVersion - When this value is given, the action will return an integer value representing the internal file version number.  New file versions have a higher value.
• SystemName - When this value is given, the action will return a string that represents the operating system that wrote the file.  Examples are Windows, Linux, macOS.
• SystemBitness - When this value is given, the action will return an integer that represents the word length of the operating system that wrote the file.  This will be either 32 or 64.
• SystemBigEndian - When this value is given, the action will return a boolean that represents whether the system that wrote the file was big endian.

Notes

None.

$loader checkForMissingReferences

This action checks to see if the file has any missing references.

Parameters

This action has no parameters.

Returns

This action returns a boolean of true if there are no missing references and false if there are.

Note

This action must be called after initialize, but before load.

$loader checkForDuplicateEntities

This action checks for duplicate entities.

Parameters

This action has no parameters.

Returns

This action returns a boolean of true there are duplicate entities.

Note

This action must be called after initialize, but before load.

$loader checkForDuplicateRules

This action checks for duplicate rules.

Parameters

This action has no parameters.

Returns

This action returns a boolean of true there are duplicate rules.

Note

This action must be called after initialize, but before load.

$loader checkCAEUnsupportedEntities

This action checks for the number of unsupported entities that will be ignored or deleted if the file is loaded.

Parameters

This action has no parameters.

Returns

This action returns the number of unsupported entities.

Note

This action must be called after initialize, but before load.

$loader load

This action loads the entities and settings from the native file.

Parameters

This action has no parameters.

Returns

This action returns nothing.

Note

This action must be called after initialize.

$loader getError

This action reports the last I/O error detected when processing the file.  If no errors were detected, an empty string is returned.

Parameters

This action has no parameters.

Returns

This action returns a string with the last io error.

$loader getRepairConnectors ?-averageChange avgVar? ?-maximumChange maxVar?

This action returns the connectors that have grid points that are out of sync with their distribution functions when the RepairMode attribute is set to Defer.  Note that when reading in a file with frameworks, the connectors may be from differing frameworks.

Parameters

Returns

This action returns a list of pw::Connector objects.

Information

An empty list will be returned if this action is called prior to calling the load command.

$loader repair mode ?connectors?

This action will repair the distributions of the out of sync connectors when the RepairMode attribute is set to Defer.

Parameters

Returns

This action returns nothing.