# User Guide Vista is designed for visualisation and analysis of geospatial data, with special functionality for transportation data. It allows technical and non-technical users to visualise and interrogate data.

Visualise a large amount of data in your browser. Explore, filter and engage with your data and share it with others. ## Table of contents: ### [Getting Started](/user-guide/getting-started) ### [Getting Started with a Shared Map](#getting-started-with-a-shared-map) ### Vista workflow * [Add Data to Vista](/user-guide/datasets) * [Adding data layers](broken://pages/2KTi0zPerpHBFtR3XOfs) * [Create a layer](/user-guide/create-a-layer) * [Hide, edit and delete layers](/user-guide/hide-edit-and-delete-layers) * [Save and Share your map](broken://pages/KuO2CeM2iJl6fO0fKTDp) ### [Layers](/user-guide/layers) * [GeoJSON](/user-guide/layers#geojson) * GeoJSON Difference * PieChart * Origin-Destination ### [Layer attributes](/user-guide/layer-attributes) ### [Colour Palettes](/user-guide/colour-palettes) ### [Filters](/user-guide/filters) ### [Map styles](/user-guide/map-styles) * [Base map styles](/user-guide/map-styles#base-map-styles) * [Toggle Map layers](/user-guide/map-styles#toggle-map-layers) ### [Interactions](broken://pages/yGIBBTusVeciJLN8DZKY) * [Tooltips](broken://pages/yGIBBTusVeciJLN8DZKY#tooltips) ### [Map Settings](/user-guide/map-settings) * [Display legend](/user-guide/map-settings#display-legend) ### [Save, Export and Share](broken://pages/KuO2CeM2iJl6fO0fKTDp) # Getting Started Vista is a tool designed for geospatial data visualisation and analysis. This guide will help you get started creating visualisations. ### 1. Data Portal You can manage your data from the datasets page. This allows creating folders, uploading data and deleting data. Read more about [adding data to Vista](/user-guide/datasets). ### 2. Create a Session To create a working session, select one or more datasets, click the "Actions" button in the top right and then "Open in Vista". ### 3. Add Filters

Add filters to your map to limit the data that is displayed. Filters must be based on the columns in your dataset. To create a new filter, click + Filter next to your dataset in the datasets tab. Filters can be added for numerical or text columns. Learn more about [filters](/user-guide/filters). ### 4. Layers

Layers can be added by clicking + Layer. A number of layer types can be selected, including GeoJSON, Difference, Pie Chart and Filter. Layer symbology can be edited within each layer dropdown. Customisations include stroke and fill colours, stroke widths, stroke offset, labelling and more. Learn more about [Layers](/user-guide/layers). ### 5. Map Settings

Tooltips for each layer can be set in the map settings. Global attributes can be toggled on or off. Turning on global attributes ensures the same data range is used for applying colour scales and widths across all datasets. Learn more about [Map Settings](/user-guide/map-settings). ### 6. Map Style

A range of base map styles are available for selection. ### 7. Saving a Session

Working sessions can be saved by clicking the save session button in the top right of the side panel. ### 8. Session Management and Map Sharing

Sessions can be managed through the sessions page in the portal. Session details such as the name, a unique id, creation time and the data files used are listed. A shared map can be generated by turning on the shared map toggle.\ A title and description can be added, as well as an optional password.\ Sessions can be edited and worked on without impacting the shared map. The shared map can be manually synced with the session by clicking the sync button (next to the shared map toggle). The timestamp of the last sync is shown. Learn more about [Sessions](/user-guide/sessions)[ and Sharing Maps](/user-guide/sessions). # Getting Started with a Shared Map Vista is a tool designed for geospatial data visualisation and analysis. This guide will help you get started viewing visualisations you've received. ### Map Components A Vista map contains a number of components, including: 1. Side Panel 2. Map 3. Legend

### 1. Side Panel The side panel contains: 1. Title 2. Description / Information Tab 3. Layers Tab 4. Base map Tab In the Layers Tab, layers can be switched on and off with the "eye" icon. Labels can be independently switched on and off with the label visibility button, "Aa". When multiple layers are present they can be reordered by dragging the layer up or down. In the Base map Tab, different base map themes can be set.

### 2. Map You can interact with the map by zooming, panning and hovering over objects. When hovering over an object, the object will be highlighted and a tooltip will show the attributes that the map creator has set.

### 3. Legend The Legend shows the symbology applied to each layer. The layer name and attribute used to theme the layer is shown. When a layer is hidden, the legend item will be hidden as well.

# Mobility Lab Portal The portal is the gateway to various Mobility Lab pages and applications: * Vista app * Datasets page * Sessions page

### Vista App The Vista application is a spatial data analysis and visualisation tool and the core application in the suite. ### Datasets Page The datasets page enables management of datasets, including creating folders, uploading and deleting datasets. ### Sessions Page The sessions page enables management of Vista sessions, including renaming, deleting and generating shared maps. # Datasets ### Upload Data to your Vista account Open [mobilitylab.app](https://mobilitylab.app/portal). Navigate to the Datasets page: Data is supported as follows:

File Type	Coordinate Reference System
GeoJSON	EPGS:4326 (WGS84), Local Mercator system (e.g., EPSG:2193)
CSV	See Origin-Destination layer type for format details

# Sessions # Create a Session # Add Data to Session Data can be loaded to a session within the datasets tab by clicking + Add Data

Datasets uploaded to the portal can then be searched and added to the session. # Filters dd filters to your map to limit the data that is displayed. Filters must be based on the columns in your dataset. To add a filter: 1. Navigate to the datasets tab

1. Under each dataset, a list of filters will be displayed. To create a new filter, Click **+ Filter**. 2. Choose a field on which to filter your data. Filter values are defined by field data type (number, string, etc.).

3. Your filter is applied to your map as soon as you specify the field and value. 4. Delete a filter anytime by clicking the **trashcan** to the right of the filter you wish to delete. **Note**: filters apply to all layers in the same dataset on your map. # Create a Layer 1. Click the Layers icon in the left navigation bar.

2. The Layers panel displays a list of existing layers. To create a new layer, click **+ Layer**.

3. An Add Layer box will pop up.

4. Select a layer type. Read about the different [layer types](/user-guide/layers#types-of-layers).

5. A filtered list of datasets relevant to the layer type will be available for selection.

6. Additional selections may be required based on the layer type. 7. Collapse the layer settings menu when finished. # Rearrange and Group Layers Rearrange layers by dragging and dropping them in the Layers panel. The layers at the top of the list will be displayed in the foreground of the map.

Groups can be created by clicking the "Add Group" button. Once a group has been created, drag layers in an out of the group. The visibility of layers can be controlled at the Group level with the visibility toggle.

# Hide, Edit and Delete Layers Each layer has its own tab in the **Data Layers** menu:

Click the **down arrow** to open up the settings menu for that layer. Click the **trashcan** to delete a layer. Click the **eye** to toggle show/hide the layer, click the Aa button to show/hide labels. # Layers ## Types of Layers ### GeoJSON ![GeoJSON layer](https://3566446502-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FreZrjEwkXal3rd9EjRgb%2Fuploads%2Fs9525nlhxrAaaF5kR9BO%2FScreenshot%202023-12-08%20134647.png?alt=media\&token=7ff8d703-3189-4e3d-8074-31b00060ab62) ![Polygon geoJSON layer](https://3566446502-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FreZrjEwkXal3rd9EjRgb%2Fuploads%2FjSAFhiaWlK8bT1vuamiz%2FScreenshot%202023-12-08%20134743.png?alt=media\&token=59d88498-7ae1-40c0-9987-c3ee867dbaec) GeoJSON layers can display either lines, polygons or points. For example, a lineGeoJSON layer can display data like road sections or trip routes. A polygon GeoJSON layer is essentially a [choropleth](https://en.wikipedia.org/wiki/Choropleth_map) layer and works best for rendering zone data. To add a GeoJSON layer, your dataset must contain geometry data. ### Difference ### Pie Chart ### Origin-Destination ### Filter # Layer Attributes | Colour/Colour based on | Choose the colour of your layer or assign colour based on a field from your dataset(s). | All layers | | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- | | Radius/Radius based on | Change the radius of points or assign radius values based on a field from your dataset(s). | GeoJSON, Difference, Pie Chart | | Opacity | Change the transparency of a layer. 1 = opaque, 0 = invisible. | All layers | | Radius range | Set a lower and upper threshold for projected radius size. | GeoJSON, Difference, Pie Chart | | Stroke width/stroke width based on | Change the thickness of lines and arcs, or assign a width based on a field from your dataset(s). | GeoJSON, Difference, Origin-Destination | | Stroke width range | Set a lower and upper threshold for projected stroke width. | GeoJSON, Difference, Origin-Destination | | Colour Palette | Choose from multiple, predefined or customized colour palettes to apply to your layer. | All layers | | Colour Scale | Choose either a quantile or quantized colour scale. A quantile colour scale is determined by rank, while a quantized colour scale is determined by value. | All layers | # Colour Palettes Colour palettes include both predefined and customised options and can be applied to either fill or stroke. Predefined palettes comes in diverging, sequential and qualitative types. To choose a palette: 1. Expand the layer pane and click on the colour bar from either filled colour or stroke colour section. Click on the three dots to select the field to colour by. ![expand](https://3566446502-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FreZrjEwkXal3rd9EjRgb%2Fuploads%2F0oXcKR9H6nzezKqlBr8Y%2FScreenshot%202023-12-08%20142154.png?alt=media\&token=ce8b4b1d-4f78-444e-b273-e1a65f969159) To choose a custom palette, toggle on the custom palette button. Click on each colour to pick a new colour either by clicking on the colour picker or inputting HEX/RGB values. Colours steps can be added, removed or shuffled. ![toggle](https://3566446502-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FreZrjEwkXal3rd9EjRgb%2Fuploads%2Fp1f9RjB4eMDMUARhZR9I%2FScreenshot%202023-12-08%20142448.png?alt=media\&token=33f91c52-ad63-4a63-9ea2-c50dec98c6c7) ![toggle](https://3566446502-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FreZrjEwkXal3rd9EjRgb%2Fuploads%2FunZhnjJfOC1smUc4Uds8%2FScreenshot%202023-12-08%20142554.png?alt=media\&token=b21cf901-e7d9-42ae-8a95-59fca7dea79d) Your colour is applied to your map as soon as you select the predefined palette or confirm the choices of customised colours. ![toggle](https://3566446502-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FreZrjEwkXal3rd9EjRgb%2Fuploads%2F45uNTsDBv4oD60uvWF9C%2FScreenshot%202023-12-08%20142726.png?alt=media\&token=a740db44-08b2-4a31-b94f-bf28334d3660) The default colour ranges can be modified by enabling the Custom Domain option.

# Map Settings Click the Settings tab in the side panel

### Tooltip Tooltips can be set for each layer. The tooltip allows selection of attributes within the associated data set to be displayed when hovering over the layer objects in the map. ### Global Attributes With global attributes turned on, all datasets with common column names will use the same data range. For example, dataset 1 has a range for the volume of 0 - 5,000 while dataset 2 has a range of 0 - 6,000. With global attributes, both datasets will use a range of 0 - 5,000 for symbology such as colour scales and stroke widths. This ensures that layers created from the two datasets are consistent and directly comparable. ## Display Legend View your map Layer Legend by clicking the Display Legend icon in the top right corner of your map:

The legend will appear in the bottom right corner. The legend size can be increased by clicking the magnifying glass icon.

The legend will only contain layer symbology for layers that are visible. # Map Styles Vista provides a set of Mapbox basemap styles as background maps. ## Base Map Styles Open the **Base Map panel** to select from a list of default map styles.

Open the **base map style** drop down menu to change map colour scheme and imagery. Options include: * **No base map:** plain white background * **Streets:** A general-purpose map that emphasises accurate, legible sytling of road and tranist network * **Light**: light base map with dark-coloured text. * **Dark**: dark base map with light-coloured text. * **Satellite:** satellite and aerial imagery base map * **Satellite Streets:** combines the satellite base map with streets data * **Land and Sea:** A two-toned map differentiating sea and land with no details * **Fantasy:** A Middle Earth inspired base map. Just for fun.