Spatial View

Pipistrelle allows the user to display the spatial attributes of the components in its current composition through the use of the Spatial View.

The Spatial View runs in a tabbed window on the main Pipistrelle window.

It makes extensive use of the open source dotSpatial .NET geospatial library - for more details on the specific behaviour of the dotSpatial component please visit the Codeplex host for dotSpatial.

Click on the Open Spatial View tab to see how to access the Spatial View from Pipistrelle.

The Spatial View is accessed in Pipistrelle via the View -> Tabs -> Add -> Spatial View menu option.

Spatial View - Menu location

Selecting this will add a new tabbed window to the Pipistrelle user interface.

Spatial View - Tab

Once you have loaded the Spatial View, the next step is to load your OMI components' spatial data as layers into the view. Click on the Load OMI Layers tab to see how to do this.

When you have added, to your composition, some components which have Input or Output exchange items which have a spatial aspect, you can view them by switching to the Spatial View tab and clicking on the (Re)Load OpenMI Layers button.

Spatial View - Load OMI layers

Pipistrelle will then search the composition for all components with a spatial aspect and load these spatial descriptions as layers into the dotSpatial component.

Two layers, Connections and Components, will be visible.

The Connections layer contains all the spatially aware connections between components. The Components layer contains all the components which have spatially aware exchange items.

Within the Components layer there will be a single layer for each component, using the same name as the component caption. Each component layer will comprise two layers - Sources and Targets.

The Sources layer presents spatially defined input exchange items; the Targets layer presents spatially defined output exchange items.

This tab displays an example of an OpenMI component (our familiar Pond made spatially aware). It shows all four output (Source) boundaries of the Pond (North, South, East and West) as points.

Spatial View - Example

By loading a world map (via the Layers -> Add Layer ... menu item) you can see how other layers can be added to the Spatial View.

Consider a model grid similar to our pond example as representing the boundary of a grid situated in the Gulf of Guinea, as the boundary conditions of a wave model downscaling to give local wave conditions. By loading a world map (via the Layers -> Add Layer … menu item) it can be seen in this context how other layers can be added to the Spatial View.

Spatial View Example World

Right-clicking on each OpenMI layer item will allow you to edit the properties of the selected item. You can change the caption of the component, for example, by right clicking on the component name and selecting the OpenMI Properties menu item.

Spatial View - Edit OMI Properties