23. linking saturn and geographical information systems … 23.pdf · saturn manual (v11.3) linking...

SATURN MANUAL (V11.3)

Linking SATURN and GIS

5120257 / Mar 14 23-1 Section 23.docx

23. Linking SATURN and Geographical Information Systems (GIS)

23.1 Introduction

This section discusses various ways in which SATURN users may interface their SATURN data with “proper” GIS systems such as MAPINFO and ARCINFO and vice-versa with a view to obtaining the best possible outputs by the using two sets of systems in combination.

We note that SATURN has its own system of “.GIS files” which should not in any way be confused with “proper” GIS systems such as ARCINFO. What a .GIS file provides is a very simplified form of data coding whereby useful data such as information on the shape of curved links, node text names, etc. etc. may be accessed by SATURN programs to make their outputs more meaningful. Indeed one of the objectives of this section is to suggest ways by which SATURN .GIS files may be set up automatically from (proper) GIS systems and their associated data bases.

A slightly different form of software with which SATURN may be usefully linked are packages such as GoogleEarth(R) which can provide background .bmp files for network plots as well as extremely useful network information such as lane structure at intersections.

23.2 Exporting SATURN data to GIS Systems

In general there are three forms of data which a user might wish to export from SATURN into a GIS system:

♦ Topological network data (including both nodes and links)

♦ Matrix data

♦ Link-based data

Of these the third is the most common whereby a SATURN user wishes to export assignment outputs such as link flows or speeds for display or manipulation in a GIS system. The simplest and most common way to do so is to use an ASCII file dump from a program such as SATDB or P1X (11.10.9) or utilities such as DBDUMP (see 15.46) to create text (ASCII) files which can be read by a GIS system.

One problem that arises here is that SATURN identifies links in terms of their A-node and B-node numbers but a GIS system may not have the same information but prefer to have its data geo-coded by co-ordinates. There is a very useful option within “Read Miscellaneous Data” in SATDB where option 6 creates 4 data columns consisting of the (X,Y) co-ordinates for both the link A-node and B-node; clearly these may then be included on an output ASCII file to geo-code each link entry. Alternatively a separate file of node numbers plus X,Y co-ordinates may be created; see 11.4.2 and 11.9.7.



5120257 / Mar 14 23-2 Section 23.docx

Topological network data is generally already available and more easily accessed in GIS packages than in SATURN but there are circumstances, as illustrated below in Section 23.4 for MapInfo, where it is useful to build a GIS network starting from a basic SATURN network data base.

We may also note that topological data describing a SATURN-based network may be transferred to an alternative GIS system by “dumping” it into text files which specify the essential node and link structures. See Section 11.4.2 for using P1X to dump data. Further data manipulation may then be required to convert the data into a form from which the GIS system can create its own networks.

23.3 Importing data from GIS Systems into SATURN

This section lists a number of “typical” data sets which may be easily created within GIS systems and exported into SATURN as ascii data files. References to the appropriate sections in the Manual which provide further information (e.g., formats) are given.

Imports into .GIS files (See Appendix Z)

♦ Node text names

♦ Link text names

♦ Curved links (which may then be used to set link distances in SATNET; 15.10.1)

♦ Poly-lines and Polygons

IMPORTS INTO NETWORK .DAT FILES

♦ Complete buffer network 33333 data sets (See 6.6)

♦ Use of Data Field Editing for e.g., link distances in P1X (See 11.9.17)

♦ Bus routes (See 6.9.2)

♦ X,Y co-ordinates (See 6.8)

IMPORTS INTO MATRICES

♦ Cell values in .CVS format (See 10.5)

MISCELLANEOUS

♦ Bitmap .BMP Files for use in P1X plotting (See 15.43)

♦ Trip ends (e.g., for use in matrix Furnessing and/or factoring; see 10.7.5)

23.4 The Atkins MapInfo Tools

Atkins SATURN Tools is a set of MapInfo tools developed by Atkins Transport Planning originally as a set of in-house tools to enhance GIS publishing of SATURN Networks within GIS MapInfo-based environment. The major benefit of this is the ability to view the SATURN Model as part of your GIS based on the same spatial reference / coordinate system, by default set to British National Grid.



5120257 / Mar 14 23-3 Section 23.docx

This version of SATURN Tools is now available to the larger SATURN community subject to conditions defined in the Disclaimer. Updates to the tools will be available from http://www.saturnsoftware.co.uk/tools/saturntools.zip.

Requirements:

♦ MapInfo should be installed (No known problems with MapInfo versions 6.x through to 10.x).

♦ SATURN *.dat file (for displaying network) and SATURN *.lks file (for displaying assignment results such as flows.

♦ Users are expected to have basic knowledge of MapInfo.

Further information may be found in the Online Help files located in the folder \TEST\GIS Tools.

23.4.1 Start SATURN Tools

To install, unzip the AtkinsModellingTools.zip file to a directory on your PC. The following files must be kept together for the application to work properly, if at all:

♦ SATURNTools.mbx,

♦ AtkinsSATURNTools.chm,

♦ AtkinsModelTools.Icons,

♦ AtkinsModelTools.exe

♦ SATURNTools.ini

♦ SATURNTools.log

Start the program by double clicking the SATURNTOOLS.MBX this will automatically start up MapInfo with the SATURNTools Menu under Tools >> SATURN tools.

Figure 23.1 – SATURN Model Tools

In addition, SATURN Tools can be found under a new menu called Atkins Modelling Tools or alternatively the most commonly used tools can be accessed directly from the SATURN Toolpad menu buttons.



5120257 / Mar 14 23-4 Section 23.docx

23.4.2 Load SATURN Tools each time MapInfo Starts

Follow the instructions below to instruct MapInfo to load SATURN Tools on every start up. To do this do not double click on SATURNTools.mbx to start MapInfo.

1) Select the menu ToolsTool Manager.

2) Press button Add Tool

♦ Fill in the Add Tool form as shown below.

♦ Remember to browse to the location of SATURNTools.mbx on your own computer.

Figure 23.2 – Add Tool

♦ Press OK.

3) Make sure SATURN Tools is in the Tools list on the Tool Manager form. Check the Autoload check box.

Figure 23.3 – Tool Manager



5120257 / Mar 14 23-5 Section 23.docx

4) Press OK.

MapInfo will now load SATURN Tools every time it is started

23.4.3 Introduction to Menus

SATURN Tools creates a special menu under Tools >> SATURN Tools. This special menu can also be found under a new menu called Atkins Modelling Tools >> SATURN Tools or alternatively the most commonly used tools can be accessed directly from the new SATURN Toolpad menu buttons.

1) Accessing the menu from the new toolpad

Figure 23.4 – SATURN Toolpad

On first use after starting SATURN Tools will prompt the user for an output path.

♦ Create Nodes ♦ Import Network ♦ Create Bands ♦ Create Turns ♦ Label Links ♦ Settings ♦ Styles ♦ Log ♦ Instructions ♦ SATURN batch files

2) Accessing menu from the Tools >> SATURN Tools.

Figure 23.5 – SATURN Tools Menu



5120257 / Mar 14 23-6 Section 23.docx

3) Accessing menu from the new menu called Atkins Modelling Tools >> SATURN Tools.

Figure 23.6 – Atkins Modelling Tools Menu

CREATE NODES

The first thing stage is to create a Node table. This is done by clicking Create Nodes and the specifying a SATURN *.dat file. SATURN Tools then extracts the node coordinate information from the 55555 section of the Dat file and plots them in a new map window.

SATURN Tools also reads the following settings from the &PARAM section of the *.dat file and uses them to interpret coordinate information.For this reason, users are expected to have some knowledge of the SATURN parameters:

♦ DUTCH - Thus being able to read both DUTCH=True and DUTCH=False files.

♦ FREEXY - X and Y coordinates are in free format separated by blanks

♦ XYFORM "2F10.2" – X and Y coordinates like 45363453002345364342 into 453634530.0, 234536434.2

♦ XYUNIT - Scaling factor (eg 10 means an X of 34543 becomes 345430).

As an extra feature one can also add:

♦ XOFFSET and YOFFSET which are parameters that SATURN Tools will read and use in shifting / translating the coordinates for the points. The tools will offset/shift the coordinates read by the value given to XOFFSET and YOFFSET respectively. This is useful since some models strip the first digit of a number (e.g. 4561 represents the real coordinate 545610 so an XOFFSET of 500000 is needed joined with an XYUNIT of 10.



5120257 / Mar 14 23-7 Section 23.docx

OUTPUT FROM CREATE NODES

Create nodes creates a Node table with the Nodes and Centroids. Centroid IDs are stored as 10000000+the SATURN ID.To display the node numbers as label use the NodeLabel field where centroid number are stored as "C 12" where 12 is the centroid number. The column NodeType will contain "C" for centroid nodes. The table uses following MapInfo files:

♦ Node_<SATURN dat file name>.TAB

♦ Node_<SATURN dat file name>.MAP

♦ Node_<SATURN dat file name>.ID

♦ Node_<SATURN dat file name>.IND

♦ Node_<SATURN dat file name>.DAT

The created files are stored in the directory specified in the Settings menu.

23.4.4 Import Network

Next step is to import the Network from a SATURN.lks file. This is done by clicking Import Network and the specifying a SATURN *.dat file.

Figure 23.7 – Select Network File Screen

The network file must be a dump from SATURN with the format described below. The node table can be any table containing points with fields named NodeId, X and Y with IDs corresponding to the chosen *.lks file or *.kp file.

To make SATURN Tools automatically create a Turn Layer, check the Generate Turn box option.

The Generate Centroid Connectors option allows users to turn off the generation of Connectors.

An example of a network with turns and nodes are shown below:



5120257 / Mar 14 23-8 Section 23.docx

Figure 23.8 – Turns and Nodes Network Example

INPUT TO IMPORT NETWORK

The format of the LKS file is shown below: * - COLUMN HEADER DATA: * 1893 1 4 DISTANCE DISTANCE - assignment link distance(m) * 2893 1 4 DIST_KM1 DIST_KM1 * 3893 1 4 DIST_KM2 DIST_KM2 * 1002 1001 636.00 0.64 0.64 1003 1002 400.00 0.40 0.40 1059 1002 491.00 0.49 0.49

SATURN tools reads the column names from the Column header section and automatically substitutes illegal characters such as -,?,+,/,! etc. If the import malfunctions you can modify this section to have unique names (not starting with a number) to see if it helps. SATURN Tools may not be able to establishes the DUTCH Setting within the *.kp or *.lks file and will present the user with a choice that should be the same as the settings within the *.dat file otherwise the program fails.

OUTPUT FROM IMPORT NETWORK

Create Nodes creates a network table with Links and optional Centroid connectors and an optional Turn table with information and creates optional turn graphics. This creates the following MapInfo files:

♦ Net_<SATURN dat file name>.TAB

♦ Net _<SATURN dat file name>.MAP

♦ Net _<SATURN dat file name>.ID



5120257 / Mar 14 23-9 Section 23.docx

♦ Net _<SATURN dat file name>.IND

♦ Net _<SATURN dat file name>.DAT

♦ Turn_<SATURN dat file name>.TAB

♦ Turn _<SATURN dat file name>.MAP

♦ Turn _<SATURN dat file name>.ID

♦ Turn _<SATURN dat file name>.IND

♦ Turn _<SATURN dat file name>.DAT

The created files are stored in the directory specified in the Settings menu.

LOGFILE TRACE

Create Network leaves the following type of information in the SATURNTool.log file Date: 20030311 09:47:56,Create Network Network-Inputfile: C:\wsatkins\MapBasic\SATURN2MI\Data\Dutch=T.FLW\AMNETEXT.lks Node-Inputfile: C:\wsatkins\MapBasic\SATURN2MI\Data\Results\Node_Amnete_f.TAB Centroids: T,Turns: T Net Outputfile: C:\wsatkins\MapBasic\SATURN2MI\Data\Results\Net_AMNETEXT Turn-Outputfile: C:\wsatkins\MapBasic\SATURN2MI\Data\Results\Turn_AMNETEXT

23.4.5 Create Bands

Create Bands is a tool that will work for any MapInfo table containing Lines or Polylines. It creates a new region layer containing bands or buffers with varying width depending on the value of a field in the table.



5120257 / Mar 14 23-10 Section 23.docx

Figure 23.9 – Create Bands Example

To use the Create Band tool, click Create Bands and the following form then appears:

Figure 23.10 – Create Bands Screen



5120257 / Mar 14 23-11 Section 23.docx

First select a Link Table (any table containing lines or poly lines will do). Link tables created by SATURNTOOLS will have a Net_ prefix. Once the table has been selected you must select a field containing a number by which value the bandwidth is determined. If the selected field is not a number you get an error message asking you to select a numerical value.

As soon as a proper field has been selected a series of statistics are presented on the form:

♦ Max: - specifies the maximum value of the selected field;

♦ Min: - specifies the minimum value of the selected field;

♦ Avg: - specifies the average value of the selected field; and

♦ Max width: - specifies the width of the band for the given maximum value.

BANDWIDTH INFORMATION

These values allow the user to specify the some form of scaling of the attribute to be displayed as Bands.

♦ Units: This value specifies how values, used for labelling, are rounded. A value of 1 would be suitable for variables such as vehicle flows for example;

♦ Meters per Unit - this value specifies the width of the bands per unit. e.g. Units 10 and Meters per Unit 1 gives a band width of 10 for a value of 1. Fixing the units and changing the Meters per unit allows one to decrease or increase the band widths of the network at map scale. By clicking recalculate settings after a change, max bandwidth on the network is calculated based on these settings; and

♦ Offset: - This value specifies a parallel offset from the link to the band.

LEGEND CHECKBOX

If this checkbox is ticked a legend will be added to the Bandwidth table. The legend will be place in the lower left corner of the Mapper window. The attribute SIDE will have the value “LEGEND” for all legend items. The legend can be moved in MapInfo by setting the band layer editable then selecting the items with Side=”LEGEND” and selecting the pointer tool.



5120257 / Mar 14 23-12 Section 23.docx

Figure 23.11 – Bands Legend Checkbox

The easiest way to use this function is to zoom in to your network with the Lower Left corner in the Mapper placed where you want your legend to be then run Create Bands. To show the values set the label for the bands to Value and use the label placer tool in MapInfo. To change the Legend entries click the settings button.

SETTINGS

The settings button opens the Bandwidth settings form.

RECALC MAX WIDTH

If the statistics doesn’t seem to change click the Recalc Max Width button. Note if you've got special regional settings for your computer MapInfo might misinterpret the values you put in (i.e 1,000 as 1 instead of 1000).

STYLES

The styles of the bands can be changed using the style selector buttons under Positive and Negative values.

CREATE BANDS

Pressing this button will create bands for the selected link table.

OUTPUT FROM CREATE BANDS

Create Bands creates a band table based on the links in the input file. This creates the following MapInfo files:

♦ <Inputfile name>_bands.TAB

♦ <Inputfile name>_bands.MAP

♦ <Inputfile name>_bands.ID

♦ <Inputfile name>_bands.IND



5120257 / Mar 14 23-13 Section 23.docx

♦ <Inputfile name>_bands.DAT

LOGFILE TRACE

Create Bands leaves the following type of information in the SATURNTool.log file Date: 20030311 09:51:09,Create Bands ,Network Inputfile: C:\wsatkins\MapBasic\SATURN2MI\Data\Results\Net_AMNETEXT.TAB ,Band Outputfile: C:\wsatkins\MapBasic\SATURN2MI\Data\Results\Net_AMNETEXT_Bands

23.4.6 Create Turns

SATURN Tools has the option of creating the Turn graphics when creating the network. Select a MapInfo Turn table created by SATURN Tools when prompted for a turn table. The Create Turns menu option will then add turn graphics to the turn table.

Figure 23.12 – Turns Graphic

Stars represent Turns between coinciding nodes (allowed in SATURN, but not displayable in MapInfo).

TURN SPECIFICATIONS

The Turns that are created are what is called Unit Turns. They have the following default properties:



5120257 / Mar 14 23-14 Section 23.docx

Figure 23.13 – Unit Turns Graphic

DISPLAYING RESULTS ON TURNS

To display results on turns one possibility is to use Thematic Mapping:

Figure 23.14 – Thematic Map Graphic

Note that it is possible to use the tools on a selection from a turn table created by SATURN Tools (so you don’t have to wait hours for all 35.000 turns to map if you just want to see one area). Below is a zoom in from MapInfo showing you the detail you can get



5120257 / Mar 14 23-15 Section 23.docx

Figure 23.15 – Thematic Mapping Turns Graphic

LOGFILE TRACE

Create Turns leaves the following type of information in the SATURNTool.log file Date: 20030311 09:59:05,Create Turns ,Turn Inputtable: C:\wsatkins\MapBasic\SATURN2MI\Data\Results\Turn_amnete_F.TAB

23.4.7 Label Links

The Label Links tool enables the user to present labels on both sides of all links in a network.

The user must specify a Link table and the field to be displayed.

Figure 23.16 – Label Links Menu



5120257 / Mar 14 23-16 Section 23.docx

Round to nearest: value rounds the value from the chosen Label field to the fraction entered here. (eg set to 1000 a value of 123456.789 will be displayed as 123000 and set to 0.5 this displays as 123457.0)

Label Box Chars: value decides how many characters will be reserved for creating the box highlighting the value.

Figure 23.17 – Label Box Characters

Distance to Link: Value specifies the distance from the link to the label centre.

Threshold: When ticked this box enables the Neutral and Negative Values Style buttons. It also creates three layers to label.

♦ POS_<table name> with label >= threshold value

♦ NEG_<table name> with label <= threshold value

♦ NEU_<table name> the in betweens.

Allow overlapping Labels: Does exactly what it says on the label!

OUTPUT FROM LABEL LINKS

Label Links creates a Link table.The table uses following MapInfo files:

♦ Lbl_<Net table name>.TAB

♦ Lbl _< Net table name>.MAP

♦ Lbl _< Net table name>.ID

♦ Lbl _< Net table name>.IND

♦ Lbl _< Net table name>.DAT

The created files are stored in the directory specified in the Settings.. menu or the path specified on first use.

23.4.8 Settings

The SATURN Settings menu allows you to set style of the map objects that SATURN Tools creates. It also allows you to specify the output directory for MapInfo tables that it creates. You can save your settings to the ini file that loads automatically on start up. If you are unhappy with your settings press the default settings button to revert to the hardcoded standard.



5120257 / Mar 14 23-17 Section 23.docx

Figure 23.18 – SATURN Settings

SET STYLES

The Settings menu option Set Styles gives the user the possibility of changing the styles of the SATURN network elements that are to be imported. See Styles below.

BANDWIDTH SETTINGS

The Settings menu option Bandwidth Settings gives the user the possibility of changing the variables of SATURNTools Bandwidth tools. See below.

Figure 23.19 – Bandwidth Settings

Pressing the Edit LegendList button gives the user the option to enter new values or a different number of Legend entries. The text string to be entered must be a



5120257 / Mar 14 23-18 Section 23.docx

semicolon separated text string ending on a ;. E.g. 1000;5000;10000; 5000;50000; for the above window.

OUTPUT FOLDER

The Output Directory Browse button allows the user to specify a folder for MapInfo tables created by SATURN Tools. In other words after setting this folder Nodes-, Network- and Turn-tables that you import will be saved in the specified folder.

Figure 23.20 – Output Folder

Do as instructed select the desired directory and click the Save button. (I know it’s not logical, but this is the best work around in MapBasic that I could think of – if you’ve got a better solution don’t hesitate to let me know - Erik).

GENERATE TURNS

This check box indicates if turns will be created along with the network creation. The default is unchecked.

GENERATE CENTROID CONNECTORS

This check box indicates if Centroid Connectors (buffer and simulation) will be created along with the network creation. The default is checked.

SAVE SETTINGS

By clicking this you save the current settings to an INI file in the application directory. This is the path where your mbx file is located. The INI file is named SATURNTools.ini

CHANGING COORDINATE SYSTEMS

Open the SATURNTools.ini file in a text editor of your choice.

Change the line beginning with CoordSys = to your prefered MapInfo projection keep it all on one line

CoordSys = CoordSys Earth Projection 8, 79, "m", -2, 49, 0.9996012717, 400000, -100000



5120257 / Mar 14 23-19 Section 23.docx

SATURN Tools must be restarted for the changes to take effect.

DEFAULT SETTINGS

The Default Settings button resets all Styles and sets the output directory to the path of the SATURNTools.mbx plus \Data. The values used in Create Band are also reset.

23.4.9 Styles

Using this menu option allows you to change the Style setting for all the features created by SATURN Tools. These settings are reset if you choose Default Settings in the Settings menu. The Styles are not saved in the INI file.

Figure 23.21 – SATURN Style Settings

23.4.10 Log

SATURN Tools are now equipped with an ever growing log file. It is the responsibility of the user to clear this log to prevent it from growing to unheard proportions. The log keeps track of time of execution as well as input and output files from the following processes:

♦ Create Node

♦ Import Network

♦ Create Bands



5120257 / Mar 14 23-20 Section 23.docx

♦ Create Turns

Figure 23.22 – SATURN Log Tools

To view the log entries select Log in the menu and then press View Log.

To clear the log press Clear Log.

To exit the Log screen press the X in the upper right corner.

23.4.11 Instructions

Will open this help file.

23.4.12 Example

An example MapInfo workspace has been provided with the tools. SATURN data files are kept separate from the MapInfo files. Use the help file to run a test on this data.

Figure 23.23 – MapInfo Workspace Example

23.4.13 SATURN batch files

SATURN Tools also includes 3 batch files to speed up the process of extracting data from SATURN for use with the tools. SATURN should be installed on the machine for the batch files to run and the batch files themselves will be found in a folder \BATS within the installed tools.

MAKEDATA.BAT

Produces network and link data for MapInfo based on DA Codes. The Command is:

MAKEDATA .ufs file DACODE

eg MAKEDATA DS2011v1 4513

This will produce a file containing actual flow information for the UFS file 'DS2011v1'.



5120257 / Mar 14 23-21 Section 23.docx

MAKELINK.BAT

Dumps network link list for MapInfo. Command is MAKELINK .ufs file eg, MAKELINK DS2011v1. This would produce a file containing link information for the ufs file 'DS2011v1'.

MAKEFLOW.BAT

Dumps link flow list for MapInfo. Command is MAKEDATA .ufs file eg, MAKEDATA DS2011v1. This would produce a file containing link flow information for the ufs file 'DS2011v1'.

File Inputs may be obtained by typing the name of the batch file eg MAKEDATA will produce: C:\>MAKEFLOW <return> SATURN v10 (SATWIN) BATCH FILE TO Atkins September 2006: TO DUMP NETWORK LINK ^& FLOW LIST FOR MAPINFO #1 = Assigned Network File = %1.UFS or %1 #2 = Assigned Network File = %2.UFS or %2 Output Network FLOWs file called #1.LKS ^<Difference = #1 - #2^> C:\>

To run, simply enter assigned network filename(s)

23.5 SATURN GIS Creator

Atkins SATURN GIS Creator Tools is a set of MapInfo tools developed by Atkins to ease the creation of a curved links for a SATURN GIS (*.GIS) file. This version of SATURN GIS Creator Tools is now available to the larger SATURN community subject to conditions defined in the Disclaimer. Updates to the tools will be available from

http://www.SATURNsoftware.co.uk/tools/AtkinsSATURNGISCreator.zip.

REQUIREMENTS

♦ MapInfo should be installed (No known problems with MapInfo versions 6.x through to 10.x).

♦ A SATURN Network, typically imported into MapInfo using Atkins Model Tools (SATURN Tools) or any other network table containing Anode and Bnode columns representing the SATURN Anode and Bnode.

♦ SATURN version 10.6 and above.

Users are expected to have basic knowledge of MapInfo.

DISCLAIMER

Atkins SATURN GIS Creator Tools are provided to the SATURN Community by Atkins Transport Planning and may not be passed to any third party without the consent of Atkins, contact information is provided in Comments and Suggestions. These tools are provided as is subject to the condition that users use them at their own risk and any express or implied warranties are disclaimed.

http://www.saturnsoftware.co.uk/tools/AtkinsSATURNGISCreator.zip



5120257 / Mar 14 23-22 Section 23.docx

23.5.1 Start SATURN GIS Creator Tools

To install, unzip the AtkinsSATURNGISCreatorTools.zip file to a directory on your PC. The following files must be kept together for the application to work properly, if at all:

♦ AtkinsSATURNGISCreator.MBX

♦ AtkinsSATURNGISCreator.chm

♦ AtkinsModelTools.Icons

♦ AtkinsModelTools.exe

To learn about the different functions use this Help file.

Start the program by double clicking the AtkinsSATURNGISCreator.MBX this will automatically start up MapInfo with the SATURN GIS Creator menu under Tools. For information on installation refer to the more detailed help file for the main SATURN Tools or your MapInfo Manuals.

Figure 23.24 – SATURN GIS Creator Tool

23.5.2 Instructions

Once installed the SATURN GIS Creator Tool creates a special menu under Tools, this menu can also be found under Atkins Modelling Tools. Alternatively the most commonly used tools can be accessed directly from the new SATURN GIS Creator Tool pad.

Figure 23.25 – SATURN GIS Creator Toolbar

The new tool pad from the SATURN GIS Creator

♦ Set Network and Node Tables

♦ Move Node



5120257 / Mar 14 23-23 Section 23.docx

♦ Adjust Links

♦ Export Curved Links to SATURN

♦ Match Networks

♦ Export Window to SATURN

♦ View Log File

♦ Instructions

♦ About SATURN GIS Creator Tools

23.5.3 Set Links and Nodes Table

Clicking the the move node tools will call for the network and links table.

This is typically a network taken from SATURN using the Atkins SATURN Tools comprising of a Nodes and Network Table. These need to be set before using the tools.

Figure 23.26 – Set Links and Nodes Table

Clicking OK will open a mapper window with the two selectable tables. Editing can be done in any mapper window where both tables are open and selectable. If you have not set the tables you will get a message in the Message window.



5120257 / Mar 14 23-24 Section 23.docx

TABLE DEFINITIONS (REQUIRED FIELDS)

The following lists essential tables and the recommended fields. Compulsory fields are in BOLD other fields may be added at your leisure.

NODES

♦ NodeId Integer Index 1 ;

♦ X Float ;

♦ Y Float ;

♦ NodeLabel Char (10) ;

♦ NodeType Char (1) ;

♦ Comment Char (254) ;

NETWORK (MASTERNETWORK)

♦ ANode Integer Index 1 ;

♦ BNode Integer ;

♦ CNode Integer ;

♦ Comment Char (254) ;

23.5.4 Move Node

The Move Node is a tool button.It affects the way the cursor interacts with the mapper. Click on a node and drag a line to the new location for the node.

The tool works on the basis of values in the Anode and Bnode fields of the Link table. This means that all links with either an Anode or a Bnode identical to the moved node's NodeID will be changed. A normal MapInfo edit session will only move one line at a time.

When working with polylines only the first or last section is changed.

HINT! Holding SHIFT down while using this tool makes it work like the Adjust Links tool Holding SHIFT+CTRL makes it move vertices.



5120257 / Mar 14 23-25 Section 23.docx

Figure 23.27 – Move Nodes

Click the button, hold and drag to new location. Easy as that.

Figure 23.28 – Move Node



5120257 / Mar 14 23-26 Section 23.docx

Figure 23.29 – Move Node

23.5.5 Adjust Links

Use this tool to curve the imported SATURN links. The tool introduces a new vertex to the lines under the point where first selected. The position of the vertex is decided by the position of the cursor when you let go of the left button.

Holding down CTRL when using the tool enables you to move vertices in the line instead of creating new ones.(This can be used as a kind of un-do function if minor mistakes are made since there currently is no undo function).

Be careful when adding vertices that they do not overlap. This can cause some problems when adding further vertices.



5120257 / Mar 14 23-27 Section 23.docx

CREATING A NEW VERTEX Figure 23.30 – Creating a New Vertex

Click the link and hold and drag cursor to the location of the new vertex.

Figure 23.31 – Creating a New Vertex

A vertex is added to all links found under the cursor on the first click. Undo will only undo the last of these actions and should as a rule not be performed when using these tools.



5120257 / Mar 14 23-28 Section 23.docx

MOVING AN EXISTING VERTEX Figure 23.32 – Moving an Existing Vertex

Press CTRL and click the link and hold and drag cursor to the new location.

Figure 23.33 - Moving an Existing Vertex

Vertices are moved in all links found under the cursor on the first click. Undo will only undo the last of these actions and should as a rule not be performed when using these tools.



5120257 / Mar 14 23-29 Section 23.docx

23.5.6 Export Curved Links to SATURN

This function will export all curved links found in the specified link table as well as all the nodes in from a specified node table into a SATURN GIS file filling the 77777 card and the 88888 card respectively.

Use SATURN’s P1X to open the normal network then read the .GIS file. This can be done by selecting:

♦ Files Menu Display Menu

♦ Inputs or GIS: Open a file

♦ GIS File

Once open please make sure that the heading in the right-hand menu reads: Curved lines. If it does not, then change this by toggling the No Curves heading. Then click on Re-Plot.

EXPORTING THE LINKS AND NODES A WALK THORUGH Figure 23.34 – Selecting Links and Nodes for Table Export

Parameters for SATURN;

♦ FREEXY (On as default and only option in Beta Version)

♦ IROCKY (Disabled in Beta Version)



5120257 / Mar 14 23-30 Section 23.docx

♦ XYFORM (Disabled in Beta Version)

♦ DUTCH

♦ XYUNIT

♦ XOFFSET

♦ YOFFSET.

A wrong input of any of these parameters will mean that SATURN may not be able to find the matching link’s start and end or most likely will display unexpected results.

Details of the parameters are provided in the main SATURN tools help file.

After a successful export the following message box appears

Figure 23.35 – Successful Export Screen

Clicking Yes will open the file in Notepad. If Notepad is not installed this may cause an error.



5120257 / Mar 14 23-31 Section 23.docx

Figure 23.36 – Nodepad Screen

The tool exports both links (up-stream and down-stream) SATURN will only use one of them to represent the flows depending on SATURN parameters this may be the first or the last link occurring.

A sample SATURN GIS file is shown below.

**********************************************************************************************************

Net_HS11AM021204SP11PMC NETWORK with Node_HS11AM021204SP11PMC Nodes &PARAM DUTCH = F FREEXY = T XYUNIT = 1 XOFFSET =0 YOFFSET =0 &END 77777 90220 90252 479934.20 315382.03 478240.43 311782.76 481204.53 312206.20 480781.09 309877.27 500047.76 303737.34 99999 88888 C 1 457210 339820 C 2 456930 340170 C 3 456580 340150 5122 456250 337310 5123 456270 337400 5124 456200 337300 5125 455910 337170



5120257 / Mar 14 23-32 Section 23.docx

5126 456300 337270 5127 456050 337250 16101 457190 339430 99999

23.5.7 Match Networks

THE MATCH NETWORK TOOL

The purpose is to match two networks (the source is the MasterNetwork and the receiving network is the Destination network). The match is done by coupling records with identical pairs of Anode and Bnode and cloning the geographic object from the MasterNetwork to the Destination network.

The Destination network will end up having an integer field named Matched. The Matched field will be either 1 for a successful match or 0 for no match.

Figure 23.37 – Matching Two Networks

This tool is useful for a lot of purposes. You can use it to identify link differences between two SATURN Networks (e.g. by creating a thematic map showing Matched 0 as thick red).

You can also use it to put objects to a table containing ANODE, BNODE fields without having to do complex queries and update statements. (e.g. if you have a fixed Band table of your whole network, you can still use this tool to get the polygons across from one table to another while keeping the attributes of the destination table).



5120257 / Mar 14 23-33 Section 23.docx

BACKGROUND INFORMATION

The SATURN Tools allow you to import result files from SATURN as straight line links.

In order to apply your curved links to the results you will use the Match Networks function.

Once you have shaped your network in MapInfo using the SATURN GIS Creator Tools you should save a master copy of the Links and the Nodes. The prime function of the master tables is to store the line shapes and node locations used in any of your scenarios and it is highly recommended that you use one file to store the links for all scenarios for a model area.

SHAPED MASTER NETWORK FOR THE EPSOM SAMPLE NETWORK. Figure 23.38 - Shaped Master Network for the Epsom sample network



5120257 / Mar 14 23-34 Section 23.docx

IMPORTED RESULTS FROM SATURN KP FILE FOR THE EPSOM SAMPLE NETWORK.

Figure 23.39 - Imported Results from SATURN kp file for the Epsom sample network.

MASTER NETWORK MATCHED WITH IMPORTED RESULT Figure 23.40 - Master network matched with Imported result

23.5.8 Export Window To SATURN

Use this tool to create a bitmap and *.XYB file that can be added to SATURN as a GIS raster file. SATURN handles BMP's of a maximum dimension of 2000x2000 pixels.

Click the SATURN BMP button to get the following screen:



5120257 / Mar 14 23-35 Section 23.docx

Figure 23.41 – Export Settings to SATURN

REQUIRED PARAMETERS

Maximum Output Width or Height (pixels) - Reduce this number to create smaller BMP files - below 96 is not recommended as the image will appear rough even at the same scale as you see it on the screen now.

Font Size - decides the size of the Copyright notice that will be added to the image.

Copyright Notice - Text to be put on the output image.

Output Path - a Path that must exist (must end with a \)

BMP and XYB File Name (no extension) - the filename of the bmp file and the XYB file.

Find Tiles - a check box to indicate whether the program should open tiles that fit the window or not to do so (in all cases the tiles needed will be listed in the message window).

1st Tile Path - The first folder to be searched for Tile tables if tile is not found here the next folder will be searched and so on.

2nd Tile Path, 3rd Tile Path, 4th Tile Path - As above but lower priority.

You will then get a confirmation that the file was saved



5120257 / Mar 14 23-36 Section 23.docx

Figure 23.42 – Save Confirmation

This will have created the following two files

the content of the XYB file is:

2786.25 3089.13 8923.41 7321.65

The XYB file might need to be modified to match your SATURN XYFORMAT and XYUNIT settings.

The contents of the XYB file is minx miny maxx, maxy taken from the Mapper window corners.

To modify this open XYB file in Notepad.

23.5.9 Find Tiles?

The tool allows you to specify folders in which to search for 50K raster tiles. Tiles must be British National Grid 20km by 20km Square and the names should be in the form SU88.tab.

Figure 23.43 – Find Tiles

23.5.10 Make Tile Folder Settings Persistent for future searches

The table named RasterFolders.TAB in the program folder contains four records the order of which decides where the tools will look for Raster Tiles.

Editing this table and committing the changes effect the default values for the tools.



5120257 / Mar 14 23-37 Section 23.docx

Figure 23.44 – Tile Folder Settings for Future Searches

Note the all paths must end in a '\' character or the tools may fail.



5120257 / Mar 14 23-38 Section 23.docx

23.6 Version Control

JOB NUMBER: 5120257 DOCUMENT REF: Section 23.doc

Revision Purpose / Description

Originated Checked Reviewed Authorised Date

1 Re-formatted (Final to DVV) TF / BG NS IW IW 06/05/06

3 Upgrade to V2 Templates IW 22/06/06

3.2 Web release – Sept 06 DVV NP IW IW 08/09/06

3.3 Web release – Jan 07 DVV NP IW IW 04/01/07

3.4 SATURN v10.7 Release DVV NP IW IW 12/03/07

3.5 Web release – Jul 07 DVV NP IW IW 19/07/07

3.6 SATURN v10.8 Release – converted to SATURN & GIS DVV 25/03/08

3.7 Web release – Jul 08 (Work In Progress DVV NP IW IW 07/07/08

3.8 Web release – Dec 08 DVV NP IW IW 12/12/08

3.8.21 Web release – Feb 09 DVV NP IW IW 16/02/09

3.8.22 Web release – Jun 09 DVV NP IW IW 16/06/09

10.9.10 SATURN v10.9 Release DVV DG IW IW 04/09/09

10.9.12 SATURN v10.9 Release (Full) DVV DG IW IW 22/10/09

10.9.12 Web release – Dec 10 DVV AG IW IW 06/12/10

10.9.24 SATURN v10.9 Release (Full) DVV AG IW IW 06/05/11

11.1.09 SATURN v11.1 Release (Full) DVV AG IW IW 31/03/12

11.2.01 SATURN v11.2 Beta Release DVV JS IW IW 07/12/12

11.2.05 SATURN v11.2 Release (Full) DVV JS IW IW 17/03/13

11.3.03 SATURN v11.3 Release DVV EN IW IW 28/03/14

23. linking saturn and geographical information systems … 23.pdf · saturn manual (v11.3) linking...

Documents