The Spatial Report command allows users to specify the display format of the Spatial Reports by selecting the physical attributes of the reports and the data to display in each report.
The Frame Display buttons load attributes dialog box that allows users to specify parameters such as frame colour and linetype, box colour, attachment line colour for Spatial Reports for Nodes and Links. On the main Report Attributes window, the left Frame Display button loads the Links dialog box, while the one on the bottom displays the Nodes dialog. The type of frame used by the link data and the form of the attachment line may be modified from within the following dialog boxes.
Frame Display Attributes
Colour. These buttons allow you to change the colour of the box surrounding the reports attached to nodes.
Line Type. These buttons allow you to change the line type of the box surrounding the reports attached to nodes.
Width. These options control the size of the box surrounding the Spatial Reports.
Automatic. When you select this option, the size of the surrounding box is calculated automatically by maintaining a border around the text. The size of the box is calculated assuming DXF MONOTXT font will be used for hard copy output.
Box Width. If you turn Automatic off, then a value entered here will specify the minimum width (in mm) of the box. A boundary is still maintained around the box but the height depends on the number and size of variables displayed.
Hide. When you select this option, the frame surrounding the spatial report is not displayed.
Type. The form of the grouping of the spatial reports data is controlled by these options.
- Box. A rectangular box will be drawn around the data with an attachment line drawn to the centre of the box.
- Opaque. If this checkbox is not enabled the spatial reports will be transparent with the background and network able to be seen through the reports.
- Bracket. A square bracket [ or ] will be drawn at the beginning or end of the group of spatial report data depending on the location of the data relative to the link. The attachment line will be drawn to the centre of the front or end of the bracket.
The Data Variables buttons will load dialog boxes that allow users to select the data fields you wish to display in the Spatial Report for Links and Nodes. The list displayed in the following dialog contains the full names of all data items that will be included in your spatial report for nodes.On the main Report Attributes window, the top Data Variables button loads the Links dialog box, while the one on the right displays the Nodes dialog.
The following options are available when selecting the Data Variables buttons:
These buttons allow you to insert a report data variable before the highlighted field in the list, or at the end of the list respectively.
When you select either of these buttons the following dialog showing all available data is displayed. When OK is selected the highlighted field is added to the list shown in the preceding (parent) dialog
If the variable selected has multiple instances (ie. Conduits, Pumps, etc.) then a combination of Variable and Instance must be selected. To show all instances of a selected data item, all combinations of Variable: Instance must be selected.
The delete button removes a report data variable from the list.
This button takes you to a format dialog that allows you to select the format of the highlighted variable. The format specification is always attached to the data variable, even when that variable is removed from the list.
The description of the variable to be formatted is shown in the title bar of the dialog.
Precision. This value specifies the number of places after the decimal point to display on the Spatial Report.
Accuracy. This value specifies the tolerance of the displayed data.
Mnemonic. This allows you to add a mnemonic to the start of each line of data displayed in the Spatial Reports.
Unit. This allows you to add a unit to the end of each line of data displayed in the Spatial Reports.
Font. This allows you to specify the font in which you wish to display the currently selected variable of the Spatial Report. The normal Windows conventions regarding birmap and true type fonts are supported. If the
Apply to All checkbox is enabled then this font style will be applied to all the spatial report data for links.
Size. The height of the text (in mm) in the report line is entered here. If the
Apply to All checkbox is enabled then this font size will be applied to all the spatial report data for links.
Text Colour. These buttons allow you to set the colour of the report text. If the
Apply to All checkbox is enabled then this font colour will be applied to all the spatial report data for links.
These two radio buttons define the location of the spatial report data.
Real World Coordinates. When you select this option, the location for each report box is fixed in the coordinate space of the network. This means that a change of scale affects the position of each report on the screen, but not on the coordinate plane.
Display Offset from Attachment Point. When you select this option, the location for each report box is a given offset from the attachment point to the relevant object. The offset is independent of the scale of the displayed network.
Note: These items can be used to modify the relative offsets of the Spatial Reports. To do this:
- Set the location to real-world coordinates then click OK.
- Zoom in or zoom out your network view until the attachment lines are an acceptable length.
- Open the Spatial Reports dialog and set the location to display offset.
- Return to the network window and the Spatial Reports should be correctly displayed. If not then repeat this procedure.
Display Size. With this option selected the text size is shown in a constant size (mm or inches) regardless of the scale selected.
Real World Coordinates. When this option is selected the text will be shown relative to the scale of the drawing. As you zoom in the text will get larger.
When new nodes or links are created the location of the Spatial Reports is controlled using the options described below.
Locate Interactively. When this option is on, the user defines the location of the Report Boxes interactively when the Nodes or Links are created.
Use Default Offset. When this option is invoked, the reports are created in a default location, as opposed to you explicitly placing them.
Hide on Creation. When this option is selected, the Reports are hidden when a Link or Node object is created. Otherwise, the Reports are displayed as they are created.
These options control the speed of redrawing and the appearance of the spatial reports.
Minimize Memory. When this option is selected, XPRafts reports occupy the minimum space in memory, thus allowing you to load a greater number of nodes. Selecting this option may significantly increase the time taken for redraws.
Maximize Speed. When this option is selected, reports are drawn significantly faster than the Minimize Memory Option. The trade-off is that more memory is required and hence a smaller number of nodes can be handled.
Hide Inactive Fields. This field controls whether fields with no data will be displayed. If this flag is OFF fields without data will be displayed as blank lines within the report.
Hide Blank Reports. This flag controls whether reports with no data will be displayed, ie all the fields are blank. Objects with no data will then not display any Spatial Report.
An object with no attached Spatial Report on the screen does not imply that there is no data there. Spatial Reports can also be hidden/shown from the “Display Reports” menu command, and may also be hidden if the “Hide on Creation” flag is enabled when the node/link is created. Thus, to confirm whether data exists, it's necessary to “Show” Spatial reports for that node/link; if no Spatial Report appears, then you can safely assume no data exists.
This button saves the report settings to a user - specified file. All the global attributes excluding the flags on this dialog are saved.
This button loads the report settings from a user-specified file. All the global attributes excluding the flags on this dialog are loaded.
This command controls the hidden or shown status of Spatial Reports, in much the same way as other network objects are controlled, and allows the Hiding or Showing of any selection of nodes/links in the network. The command can also be launched from the
Results menu, under Spatial Report Display Settings.
This button causes all selected Reports to be hidden.
This button causes all selected Reports to be shown (made visible).
Nodes, Links or both may be included in the spatial reports. At least one of these object types must be enabled for spatial reports to be displayed:
Nodes - This flag causes node objects to be included in the selection for Spatial Report.
Links - This flags causes link objects to be included in the selection for Spatial Report.
Whole Network - If this option is selected then Show or Hide will affect all nodes and links in the network.
Current Selection - If this option is selected then Show or Hide will only affect the nodes and links currently selected in the network.