Batch Mode Whitespace Calculation
- Last UpdatedJun 16, 2023
- 5 minute read
The Whitespace Batch Mode window is used to configure and run batch jobs.
Alternatively, you can use PML methods on the command line. Refer to Batch Mode Whitespace Calculation using the Command Line for further information.
Note:
AVEVA E3D Whitespace Optimizer operates using a cost charging mechanism. Refer to AVEVA E3D Whitespace Optimizer Cost Charging Mechanism Description for further information.
Important:
The ability for AVEVA E3D Whitespace Optimizer to retract whitespace calculation results back to a pre-processed state requires
AVEVA E3D Whitespace Optimizer to make a SAVEWORK at the beginning of a batch calculation. Any modifications made
within the same session as the batch calculation will be saved. Steps should be taken
prior to running a batch calculation to ensure unwanted changes are not kept.
The All sheets list displays all of the available sheets in the hierarchy.
The Selected sheets list displays all of the sheets that are included in the whitespace calculation.
|
|
Click to add the selected element and the member elements from the All sheets list to the Selected sheets list. Note: |
|
|
Click to remove the selected element and the member elements from the Selected sheets list. |
|
Result library |
Select from the drop-down list to specify the associated Whitespace results library. A Whitespace results library must be created to run a batch process. If a Whitespace results library has not been created, the field displays the message NO VALID RESULT LIBRARY AVAILABLE. The selected result library is used as the default result library in the current session until modified. |
|
Name |
Input a unique name for the Whitespace Batch Run Result (WSBART) element. The name is restricted to a maximum of 120 characters, special characters and spaces must not be used. The name must start with the / character, this is automatically inserted upon validation if not provided. If a name is not provided before Run is clicked, a warning message is displayed summarizing the problem.
Click Yes to proceed with the batch whitespace calculation, the WSBART element is created with a default name. Click No to cancel the batch whitespace calculation. |
|
Description |
Input a description for the batch whitespace calculation. The description is restricted to a maximum of 120 characters, special characters must not be used. |
|
Auto Accept Drawings with Result of |
Select the check boxes to define which drawing result states are automatically accepted as part of the batch whitespace calculation. Refer to Accept or Reject Modifications to Individual Sheets for further information. |
|
Max. Objective Preference Limit |
Input a value in the field to specify the maximum penalty limit. The whitespace calculation for a sheet is stopped when the worst processing result penalty value equals or is smaller than the specified limit. The whitespace calculation is then processed for the next sheet. |
|
Time-out |
Input a value in the field to specify the maximum time allowed for whitespace calculation for each sheet. The whitespace calculation for a sheet is stopped when the maximum allowed time limit is reached. The whitespace calculation is then processed for the next sheet. The minimum time-out value is 5 seconds and the maximum time-out value is 3480 seconds. If a value outside of the range is entered, a warning message is displayed summarizing the problem.
By default the time-out value is modified to 5 seconds or 3480 seconds. |
|
Smart Stop |
Stops the whitespace calculation when further improvement is unlikely to happen. |
Click Run to perform whitespace calculation on the specified drawings or Cancel to discard any changes and close the Whitespace Batch Mode window.
Alternatively, select Create macro file from the Run drop-down list to create a macro file instead of running the batch whitespace calculation. The macro file can be run at another time. The macro file can be used in graphical tty mode.
The Save As window allows you to navigate to a location and name the macro file. Once saved, the Whitespace Batch Mode window is automatically closed.
Note:
It is advised that the PML is adjusted to include an ALPHA LOG facility within the
newly created macro, this captures all process messages and errors which can be utilized
to understand the results at another time. Refer to TTY Mode for further information.
During whitespace calculation, a progress bar is displayed which tracks the progress.
|
Abort |
Click to stop the whitespace calculation, all sheets are retracted to their state before the whitespace calculation. If the whitespace calculation is aborted, the Close option becomes active. |
|
Show details |
Click to expand the progress bar which displays a summary of the whitespace calculation. |
|
|
|
|
Hide details |
Click to collapse the progress bar summary display. |
When the whitespace calculation is completed, the Close option becomes active. Click Close to close the progress bar window and automatically open the batch mode results report. Refer to Batch Mode Results Report for further information.
The whitespace calculation results are stored in the automatically generated WSBART and WSPORT elements. All processed sheets and their members are locked.
The Whitespace Batch Run Result (WSBART) element represents the results for a batch run.
The Whitespace Picture Owner Result (WSPORT) element represents the result for a single picture owner, for example, a sheet. The picture owner is referenced from the WSPORT attribute.
Batch Results Maintenance
Once reports have been reviewed it may be necessary to delete old WSBART elements.
This can be done by deleting the CE on the Draw Explorer.
Important:
It is advised that WSBART elements are only deleted once the corresponding results
report has been fully reviewed (all retracted/accepted sheets).
Deletion of WSBART elements containing non assessed sheets leaves sheets in the post
optimized state and retraction is no longer available.