Loading GML data into a GIS

Geography Markup Language (GML) is an XML dialect, which can be used to model geographic features. It was designed by the Open Geospatial Consortium (OGC) as a means for people to share information regardless of the particular applications or technology that they use. In the first instance, GML was used to overcome the differences between different geographic information system (GIS) applications by providing a neutral file format as an alternative to proprietary formats.

The data can be loaded into several GIS. This page describes how to translate the GML and load it into some commonly used GIS. For more information about other GIS that OS MasterMap Water Network Layer is compatible with, please speak to your Relationship Manager.

The common software covered in this section are as follows:

• QGIS

• FME

• ERSI ArcMap

• MapInfo Professional

• Cadcorp Map Modeller

QGIS

The following step-by-step instructions outline how to load OS MasterMap Water Network Layer into QGIS using the GML file(s) you have received. They have been prepared using version 3.16.7 of QGIS Desktop – an open-source GIS in which you can create, edit and visualise and publish geographic information. You can download QGIS for free from the 'Download QGIS for your platform' page of the QGIS website.

Loading OS MasterMap Water Network Layer GML into QGIS

1. Launch QGIS.

2. OS MasterMap Water Network Layer data can be loaded into QGIS either zipped or unzipped. To load the data, click on Add Vector Layer button from the left-hand toolbar.

   

   QGIS Add Vector Layer button

1. The Data Source Manager dialog box will open. In the Source section, click on the […] button to the right of the Vector Dataset(s) field and navigate to the GZ or GML file you wish to import.

   

   The Data Source Manager dialog box

1. When you've selected the file you wish to import, click Add.

   

   Data source manager dialog box showing the source file added

Alternatively, you can load the file by dragging and dropping the GZ or GML file into a blank canvas.

1. This will open a Select Vector Layers to Add… dialog box in which you can select the layer(s) you wish to add to the GIS. If you wish to add both water layers (i.e. HydroNode and WatercourseLink), click Select All. Confirm your choice by clicking OK:

   

   Select Vector Layers to add dialog

1. The HydroNode and WatercourseLink layers will be added to the canvas in the main map window.

   

   HydroNode and WatercourseLink layers shown in the main map window

1. You can add additional layers of OS MasterMap (for example, OS MasterMap Topography Layer) to give context to OS MasterMap Water Network Layer data.

Exporting OS MasterMap Water Network Layer to different GIS formats using QGIS

You can also use QGIS to export OS MasterMap Water Network Layer data into many different common GIS formats. This will allow you to open the files in many other GIS applications.

1. Right-click on the layer you want to translate, then select Export and Save Feature As…

Note: If you are trying to save layers for more tiles or a national dataset, you will have to save them separately as there is no option for grouping layers.

1. In the Save Vector Layer as… dialog box that opens, use the dropdown arrow in the Format field to select your chosen format for further analysis, for example, MapInfo TAB or ESRI Shapefile.

2. Click on the Browse button to save your file to a location of your choice.

3. Click OK to save the data in your chosen format.

   

   Save Vector Layer as dialog box

FME

The following section details how to load OS MasterMap Water Network Layer into FME using the GML file you have received. Doing so will allow you to view the data and then translate it into the most appropriate format for your software. The step-by-step instructions have been prepared using FME 2019.1.

Viewing and translating data in FME

1. Open FME Workbench and select New in the Getting Started box.

2. Click the Add Reader button from the main toolbar to add a Reader.

   

   Screenshot of the FME window showing the main toolbar.

1. In the Add Reader dialog box that opens, select GML (Geography Markup Language) from the dropdown list for Format.

2. Use the Browse […] button next to the Dataset field to navigate to your files and select them.

3. Leave the Parameters… as default and the Workflow Options as Individual Feature Types.

4. Select OK to add the Reader.

   

   Add reader dialog box

1. Once the Reader has been added successfully, the log window will display the text 'Mapping File Generation was SUCCESSFUL' and the Select Feature Types dialog box will open.

Note:

If FME cannot find the appropriate schema file for use in translation, the OS MasterMap Water Network Layer XML schema v1 file can be downloaded from the schema repository on the OS website.

1. In the Select Feature Types dialog box, select the feature types that you wish to translate from the list or use the Select All option to add all objects.

Note: OS MasterMap Water Network Layer currently only contains the feature types of WatercourseLink and HydroNode. FME will give you additional feature type options inherited from INSPIRE.

1. Click OK.

   

   Select feature node dialog box

1. OS MasterMap Water Network Layer objects will have been added to the canvas.

   

   OS MasterMap Water Network Layer objects shown on the canvas

Viewing the data using FME Data Inspector before translation

Before translating the data, FME allows you to view the data. The viewing process is faster than translation and allows you to quickly interrogate the data before you start translating it.

1. Highlight all of the feature types you wish to view by either selecting them individually or drawing a box around them.

2. Right-click on one of the feature types and select Connect Inspectors.

   

   Feature types context menu

1. Run the workspace (click the Run button on the main toolbar) with the Inspectors connected in order to view the data in FME Data Inspector.

   

   Screenshot of the main FME window showing the HydroNode and WatercourseLink feature types added to the mainn canvas.

1. When finished, the two layers of OS MasterMap Water Network Layer will be viewable in the Visual Preview window. You can open this window in a separate FME Data Inspector window by clicking the FME Data Inspector button.

   

   Screenshot of the main FME windo

Translating GML in FME

You can use FME to translate the files from GML to any other format supported by FME (for example, TAB, SHP, GPKG or a spatial database).

1. In the main FME window, remove the Inspectors you have connected if you have chosen to use FME Data Inspector to view and interrogate the data. You can do this by clicking and deleting each Inspector separately or by selecting all of them and deleting them together.

2. Click on the Add Writer button from the main toolbar.

   

   Add writer button highlighted in the toolbar

1. In the Add Writer dialog box that opens, select the format you are translating into from the dropdown list for Format, for example, OGC GeoPackage or File GeoDatabase.

2. Use the Browse […] button next to the Dataset field to navigate to the folder where you want to save the translated data.

3. Leave the Parameters… set to default.

4. Under the Add Feature Type(s) section, set Table Definition to Copy from Reader. This will enable the new Writer to inherit the schema of the Reader feature types.

5. Click OK to add the Writer.

   

   Add Writer dialog

1. A Select Feature Type dialog box will appear prompting you to select which existing feature type(s) to copy. Select both the WatercourseLink and HydroNode feature types, then click OK.

   

   Select feature type dialog box

1. The Writer feature types will now be added to the canvas. The new Writer feature types will have inherited the schema of the Reader feature types.

   

   Screenshot of the main FME window showing the main toolbar and the Writer and Reader HydroNode and WatercourseLink feature added

1. Connect the Readers to the Writers by dragging the triangle on the Reader and connecting it to the red triangle on the corresponding Writer.

   

   Connection nodes available on their corresponding Links and Nodes

1. Once the workspace has been set up, run the translation by clicking the Run Translation button.

• Note: This is a basic translation of the data, and within FME workbench you could manipulate the data further if needed. However, you can use the software just as a translator and open the data in other GIS software for analysis.

  

  Screenshot of the main FME window showing the main toolbar and the now connected Writer and Reader feature types for HydroNode and WatercourseLink.

ESRI ArcMap

The following step-by-step instructions outline how to load OS MasterMap Water Network Layer GML data into ESRI ArcMap. The instructions were prepared using ESRI ArcMap version 10.6.1.

GML data can be now imported as zipped GML (GZ) directly into ESRI ArcMap using the Data Interoperability extension called Quick Import. The Data Interoperability extension is now available at no cost as a part of ArcMap from version 10.2. You will require Internet access when using the Quick Import tool so that the data can access the schema attached to the file.

Note:

If your version of ArcMap is older than 10.2 and you do not have a licence for Data Interoperability, you will have to use translation tools available in QGIS or FME to first translate the GML data into ESRI shapefiles, before you can load them in ArcMap.

You can find more information about Quick Import on the ArcGIS Data Interoperability page of the ESRI website.

Loading OS MasterMap Water Network Layer GML into ESRI ArcMap

1. Launch ArcMap.

2. Click on the ArcToolbox window button in the main toolbar.

   

   ArcToolbox window button shown in the toolbar

1. In the ArcToolbox window that opens, click on the plus sign next to Data Interoperability Tools, then double-click on Quick Import.

   

   ArcToolbox window showing the Quick Import tool under the Data Interoperability Tools menu

1. In the Quick Import dialog box that opens, click on the […] button next to the Input Dataset field.

   

   Quick import dialog showing the [...] button next to the Input Dataset field

1. In the Specify Data Source dialog box that opens, click on the dropdown arrow in the Format field and select More Formats.

   

   The Specify Data Source dialog box in ESRI ArcMap.

1. In the FME Reader Gallery dialog box that opens, select GML SF-0 (Geography Markup Language Simple Features Level SF-0 Profile) from the list of options, then click OK.

   

   FME Reader Gallery dialog box shown GML SF-0 selected in the list of options

1. Back in the Specify Data Source dialog box, use the […] button next to the Dataset field to navigate to the folder where you saved your GZ file; select the folder and click Open. Make sure that extensions available to load are *.gz / *.gml.

2. Leave the rest of the settings as default and click OK.

   

   Specify Data Source dialog showing GLM SF-0 format and SU2000.gz dataset loaded

1. Back in the Quick Import dialog box, click on the folder button to the right of the Output Staging Geodatabase field.

   

   Quick Import dialog

1. In the Output Staging Geodatabase dialog box that opens, navigate to the correct folder and select the output geodatabase for the feature classes to be stored in.

2. Select Geodatabases from the dropdown options for Save as type.

3. Click Save.

   

   Output Staging Geodatabase save file dialog

1. Once you have made your selections for the Input Dataset and Output Staging Geodatabase fields, you can click OK at the bottom of the Quick Import dialog box.

   

   The Quick Import dialog box in ESRI ArcMap

1. As soon as the import process has started, you will see a process running notification at the bottom of your screen. When the import process has successfully completed, the following popup window should appear in the bottom right-hand corner of your screen:

   

   Quick Import success notification

Loading translated GML into ESRI ArcMap

If your version of ArcMap is older than version 10 or if you do not have access to the Quick Import (Data Interoperability) extension, you will have to use the translation tools available in QGIS or FME to translate the GML data into ESRI shapefiles first, before you can load them into ArcMap.

Note: The following instructions were prepared using ESRI ArcMap version 10.6.1.

1. Launch ArcMap.

2. To load a shapefile into ArcMap, click on the Add Data button in the main toolbar.

   

   Add Data button in the main toolbar

1. In the Add Data dialog box that opens, click the Connect To Folder button.

   

   Add Data dialog box showing the Connect To Folder button highlighted to the right

1. In the Connect To Folder dialog box, navigate to the folder where you saved your translated OS MasterMap Water Network Layer data, then click OK.

   

   Connect to folder dialog

1. Back in the Add Data dialog box, select the WatercourseLink and HydroNode shapefiles that will now be in the list of options, then click Add.

   

   Add Data dialog box showing WatercourseLink and HydroNode shapefiles

1. AThe two OS MasterMap Water Network Layer features should now have loaded into the map window of ArcMap.

MapInfo Professional

The following instructions outline how to load OS MasterMap Water Network Layer GML into MapInfo Professional. They have been prepared using version 12.5 of MapInfo. This new version of MapInfo allows you to convert GML data using a tool called Universal Translator.

Note: These instructions refer to the 64-bit version. The Universal Translator window is the same in the 32-bit version; however, the MapInfo menus are slightly different.

If your version of MapInfo is 12.0.2 or older, you will have to use translation tools available in FME or QGIS to translate the GML data into MapInfo TAB before you can load the data into MapInfo.

Translating GML into MapInfo Professional

1. Open MapInfo Professional.

2. On the main toolbar, select Tools > Universal Translator > Universal Translator.

   

   Universal Translator tools shown in the MapInfo toolbar

1. In the FME Quick Translator dialog box that opens, select File > Translate or click on the Translate data button.

   

   FME Quick Translator dialog box showing the Translate button under the Get Started subsection

1. The Set Translation Parameters dialog box will open. In the Reader section, click on the dropdown button next to Format.

   

   Set Translation Parameters dialog box

1. The Reader Gallery dialog box will open. Select GML (Geography Markup Language) from the list of options, then click OK.

   

   Reader Gallery dialog box

1. In the Reader section within the Set Translation Parameters dialog box, navigate to the folder where you saved your GML files under the Dataset option. A Select 'File' dialog box will appear. Once you've located the folder and selected it, click OK.

   

   Screenshot of the Select 'File' dialog box in MapInfo Professional.

1. In the Writer section within the Set Translation Parameters dialog box, click on the dropdown button next to Format and select MapInfo TAB.

2. Again in the Writer section, within the Dataset option, navigate to the folder where you want your TAB file to be saved.

3. You can leave the rest of the settings as default.

4. Click OK.

   

   Set Translation Parameters dialog box

1. The translation will start. You will notice commands appearing in the FME Quick Translator dialog box.

2. When the translation has completed, you will see a line of text saying: ‘Translation was SUCCESSFUL’. Close the FME Quick Translator dialog box.

   

   The FME Quick Translator dialog box in MapInfo Professional

1. The GML files will have been successfully translated into MapInfo TAB files.

Loading translated GML files into MapInfo Professional

1. Open MapInfo Professional.

2. To load translated files, select Home > Open on the main toolbar.

   

   Screenshot of the main map window in MapInfo Professional. There is a red rectangular box around the Open button.

1. The Open dialog box will open. In the Look in option, navigate to the folder where you saved your TAB files.

2. If you don’t see your files, select MapInfo (*.tab) from the Files of type dropdown menu.

3. Select WatercourseLink and HydroNode, then click Open.

   

   Open file dialog box

1. The data will now load into MapInfo.

   

   Data loaded successfully into MapInfo

1. To add the Layers window, right-click in the main window and select Layer Control. This will display the two OS MasterMap Water Network Layer objects that you have loaded: WatercourseLink and HydroNode.

   

   Layer control menu in the main window

Cadcorp SIS Map Modeller

The following instructions outline how to load OS MasterMap Water Network Layer GML into Cadcorp SIS Map Modeller. They have been prepared using Cadcorp SIS Map Modeller version 8.0 (x64).

Translating GML using Cadcorp SIS Map Modeller

1. Launch Cadcorp SIS Map Modeller.

2. Select the Home tab on main menu toolbar, then click the Add Overlay button.

   

   Add overlay button in the main menu toolbar

1. In the Overlay Types dialog box that opens, select Files > File > Next.

1. This will open the File Browser dialog box. Navigate to the folder you have saved the GML data in.

   

   File Browser dialog showing sample File folder in the browser

1. In the bottom right-hand corner of the File Browser dialog box, change the files from All files (*.*) to Ordnance Survey (GB) MasterMap layer (*.gml, *.gz).

   

   File browser dialog showing the OS MasterMap layer filter applied to files

1. Back in the File Browser dialog box, select the file(s) and click Finish.

   

   Filebrowser dialog showing .gz files loaded

1. OS MasterMap Water Network Layer features will have been added to the main map window.