115
SPI(mg) 7.2.3 User Documentation

Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Embed Size (px)

Citation preview

Page 1: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

SPI(mg) 7.2.3

UserDocumentation

Page 2: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Index

INDEX.......................................................................................................................................................................................2

INTRODUCTION..................................................................................................................................................................4

SYSTEM REQUIREMENTS..............................................................................................................................................6

WHAT’S NEW ?...................................................................................................................................................................7

STARTING SPI.....................................................................................................................................................................8

PREFERENCES...................................................................................................................................................................11

INTERFACES: MAIN........................................................................................................................................................12 MENU/TOOL BAR..........................................................................................................................................................13 RENDERING AREA.........................................................................................................................................................13 INFORMATION BAR........................................................................................................................................................14 MANIPULATION..............................................................................................................................................................14

INTERFACES: TOOLBAR...............................................................................................................................................15

INTERFACES: OBJECTS.................................................................................................................................................17

INTERFACES: LAYOUTS...............................................................................................................................................21

INTERFACES: MODELS.................................................................................................................................................22

MODELS: CANERM..........................................................................................................................................................24

MODELS: MLDP0.............................................................................................................................................................28

MODELS: MLCD................................................................................................................................................................30

MODELS: TRAJECTORY.................................................................................................................................................32

DATA TYPES: TRAJECTORY........................................................................................................................................35

DATA TYPES: STANDARD FILES.............................................................................................................................36

DATA TYPES: ICON.........................................................................................................................................................37

DATA TYPES: OBSERVATIONS.................................................................................................................................38

TOOLS: ANIMATOR.........................................................................................................................................................39

TOOLS: CALCULATOR...................................................................................................................................................42

TOOLS: DRAWBOX.........................................................................................................................................................45

TOOLS: GEOGRAPHICAL DATA (MAPPER)........................................................................................................48 VECTORIAL DATA..........................................................................................................................................................49 RASTER DATA...............................................................................................................................................................53

TOOLS: NOWCASTER....................................................................................................................................................56

SMC/CMC/CMOE 2

Version 7.2.3-a (Thursday, June 14, 2007)

Page 3: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

OBSERVATIONS.............................................................................................................................................................56 RADAR...........................................................................................................................................................................57

TOOLS: GRAPHS..............................................................................................................................................................58 VERTICAL CROSS SECTION..........................................................................................................................................59 TIME PROFILE................................................................................................................................................................60 VERTICAL PROFILE.......................................................................................................................................................61 TIME SERIES.................................................................................................................................................................62 SCATTER PLOT.............................................................................................................................................................63 CONTINGENCY DIAGRAM..............................................................................................................................................64

TOOLS: SATELLITE DATA............................................................................................................................................65

TOOLS: METDATA...........................................................................................................................................................66

TOOLS: MESSAGE WRITER........................................................................................................................................67

TOOLS: LOCATION..........................................................................................................................................................69

TOOLS: MACRO................................................................................................................................................................70

TOOLS: FILE MANAGER...............................................................................................................................................72

TOOLS: CONSOLE............................................................................................................................................................73

PARAMETERS: GEOGRAPHY.....................................................................................................................................74

PARAMETERS: FIELD.....................................................................................................................................................75

PARAMETERS: TRAJECTORY.....................................................................................................................................78

PARAMETERS: OBSERVATION.................................................................................................................................79

PARAMETERS: OPENGL...............................................................................................................................................82

DIALOGS: OPTIONS........................................................................................................................................................83

DIALOGS: DATABOX......................................................................................................................................................84

DIALOGS: PRINTBOX.....................................................................................................................................................86

DIALOGS: FILEBOX.........................................................................................................................................................87

ANNEXE: FILE FORMAT (ICON)...............................................................................................................................88

Annexe: File format (Observation)...............................................................................................................................89

Introduction

SMC/CMC/CMOE 3

Version 7.2.3-a (Thursday, June 14, 2007)

Page 4: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

SPI is a meteorological visualisation and analysis tool which has been expanded with some GIS capabilities. The first concerns that came to mind when building the tool were ease of use and performance.

SPI is built in Tcl/Tk. Most of the rendering and scientific functionalities are built as binary extensions to Tcl in the form of objects and functions and then used in SPI’s Tcl source code. This version is also the first one to experiment with Tcl threads. These will be used a lot more in the versions to come.

An exhaustive API described in another document allows for very powerful scripting, going from generation of a map to calculating flux along the path of a shape like country boundary. This API can be used to interact with many kind of data like RPN standard file, CMC trajectories, ESRI shape files, GeoTIFF imagery, BURP observation files and more,.

By using OpenGL we can profit from the rendering acceleration of today’s 3D graphic card and have a real time rendering engine.

SPI uses an «always 3D» rendering method. Everything is rendered in three dimensions, looking from the top it looks like a regular 2D map, but moving the camera around gives a new perspective of things.

SPI also gives you new visualisation functionalities and tools among which:

Use of a three dimensional space which lets you see data in elevation like trajectories, particles movement, cloud fields, etc. You can also add topography and draw primitives with height.

Volume rendering.

Free camera movement allowing specific view angles.

Possibility of displaying many rendering windows and animating them simultaneously.

Every object displayed can be moved around within the canvas allowing the creation of specific products.

WYSIWYG (What You See Is What You Get) display of things, everything you see on the screen will be printed as is.

Use of interactive help bubbles to get information about available functionalities.

Create interactive product models which can be put into SPI as layouts

Tools expanding the possibilities of SPI to retrieve manipulate and analyse data.

Possibility of communicating with SPI through a command pipeline, allowing you to use SPI as an input or output application for other applications. For example,

SMC/CMC/CMOE 4

Version 7.2.3-a (Thursday, June 14, 2007)

Page 5: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

selecting a model grid for a simulation or selecting a domain for extracting data or even output maps automatically.

Scripting. By using Tcl scripts, you can automate jobs like automatic product generation in background.

System requirements

SMC/CMC/CMOE 5

Version 7.2.3-a (Thursday, June 14, 2007)

Page 6: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

SPI uses the OpenGL API. This allows us to use hardware acceleration capabilities of the new graphic processors to obtain hardware rendering acceleration. This version uses OpenGL 2.0. with GLX extension 1.4. Execution under a previous version is possible but not supported. If you do not have a hardware implementation specific to your graphic hardware SPI will run in software mode using the MESA libraries that comes with it. Note that performance will drop radically under a software implementation for some functionality like transparency and texturing.

Whatever the system you have, you will have to set the display to 24 or 32 bit per pixels. As for the hardware accelerated graphic card, the best performance we had under Linux were with NVidia GPU’s. Make sure to install up to date drivers as specified and that the DRI is enabled in your XFree. You can get information about your OpenGL driver by using the command «glxinfo».

At the time of this writing, ATI drivers were not yet mature enough and I still recommend using the software mode since we’ve seen many XServer freezing.

Memory usage is very dependent on the data you intend to use in the application. The base memory usage is around 64 Mb but you can go up to some Gig while working with raster imagery.

The hardware requirements for SPI are the following:

Minimum system requirements

Pentium III 733 MHz256 MB Memory8 Mb graphic card3 Gig disk space required for application and geographical database

Recommended system requirements

Pentium IV 2.0 GHz2 Gig Memory64 Mb 3D Accelerated graphic card (NVidia GPU)3 Gig disk space required for application and geographical database

On the software side, SPI used to need many public domain libraries but we now include them in the installation package. Everything should be self contained or already included in your Linux installation. You might want to check for these two package:

Xvfb for batch mode executionImageMagik for conversion to various image file format

What’s new ?

SMC/CMC/CMOE 6

Version 7.2.3-a (Thursday, June 14, 2007)

Page 7: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Use of Pixel/Fragment shaders for the rendering of various items.New compass object within the drawing tool to calculate directions.The zoomed out view can now also be used as a magnifier.Raster data clipping by user specified polygon.Use of the GCP for raster localization when available.Macro tools/script generalized and updated.Macro launch through the –script parameter of SPI.3D Streamline for vector wind flow vizualisation.Use of RMN librairie 008 which allows standard file sompression.Graph labels can have multiple lines as well as French punctuation.New field matrix widget to see the field values.Wind barbs and arrow size can now be changed.New fstdfield vector { u v w } to define vectorial data component relashionship.Cross section with arrows or wind barbs.New zoom bar at the bottom of every viewport.New nowcasting tool to manage observation (BURP) and radar data.Transparency in graphs.New parameter interfaces ofr vectorial and raster dataNew interface to decode and change OGC WKT projection strings.New color curve manipulation fonctions and data histogram for raster data.Added QUADRATIC curve distribution and X and Y inversion of the curves.New way of loading raster data which allows tiling and threading of the data allowing to read huge dataset with minimal memory resources (ex: SRTM global 43200x21600).New geo-location tools to localize raster data.SPI projects to save the state of the application for later reuse.Viewport data link to look at the same data from different point of view.Time zone and radar coverage areas.Vectorial data feature selection functionalities.Vectorial data table viewer.

And more …

Starting SPI

SMC/CMC/CMOE 7

Version 7.2.3-a (Thursday, June 14, 2007)

Page 8: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Here is the list of parameters used by SPI. (It can be necessary to specify  « -- » as the last parameter when calling from other scripts so that the Tcl interpreter knows where its parameter list stops). Using an unknown parameter will display a list of known parameters.

-setup

The first time you execute SPI, it will bring up a setup window. This argument will force the execution of the setup process.

-lang

Select the language to be used in SPI. Either 0 for French or 1 for English

-default

Specify which file to use as the default start-up parameter definition (defaults to$HOME/.eer_ToolDefs/eer_Default)

-geom WxH+X+Y

This argument can be used to specify the geometry of the main window. You can specify either the width and height (WxH) or the upper left corner position (+X+Y) or both at the same time (WxH+X+Y). For example using 1000x800+0+0 will size the main window to 1000 pixel width by 800 pixels high and anchor it to the upper left corner of the screen. This will not have any effect if the geometry is overridden in the eer_Default file.

-pane WxH …

If you want to start SPI with some secondary side pane you can do it by specifying the width and height for each of them. The width or height might differso as to fit the applications dimensions, depending on the pane position.

-side left | right | top | bottom

While using side panes, you can specify on which side of the main window to place those pane.

-soft

SPI will try to figure out if you have hardware rendering capabilities at startup. You can use this argument if you want to override this behaviour and force the software rendering .

-pipe

SMC/CMC/CMOE 8

Version 7.2.3-a (Thursday, June 14, 2007)

Page 9: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

When using SPI in cooperative mode, you have to use this token so that SPI can configure the input/output command pipeline. Note that in this mode, SPI will not show up on the screen at start-up. You will have to send a command through the standard input (See communication API) to have it to show up. This mode is useful to use SPI for information selection or result output when part of the processing is done by a client application.

-batch

This token tells SPI to enter batch mode. When in batch mode, nothing will be displayed on the screen and rendering will not occur until an output is made. When printing in normal mode SPI has to render to the display and then render again to produce the output. This mode saves you half the rendering time when you don’t have to see the result before printing.

-field ... ... ...

You can tell SPI to open one or more standard RPN file by using this token. You can use the standard shell selection tokens (*,?,...) as well. If no file is specified, SPI will open a «FieldBox» to let you choose a file. Alternatively, you can use this token more than one time to open multiple «FieldBox» with different fields.

-traj ... ... ...

You can tell SPI to open one or more trajectory file by using this token. You can use the standard shell selection tokens (*,?,...) as well. If no file is specified, SPI will open a «TrajBox» to let you choose a file. Alternatively, you can use this token more than one time to open multiple «TrajBox» with different trajectories.

-tool … … …

You can tell SPI to execute specific tools upon start-up.

-icon ... ... ...

You can tell SPI to open one or more icon file by using this token. You can use the standard selection tokens (*,?,...) as well. (See Icon file format).

-obs ... … …

You can tell SPI to open one or more observation file by using this token. You can use the standard selection tokens (*,?,...) as well. If no file is specified, SPI will open an «ObsBox» to let you choose a file. (See Observation file format). Alternatively, you can use this token more than one time to open multiple «ObsBox» with different observations.

-layout ...

You can tell SPI to use a different layout on start-up. The specified layout has to be available or an error message will show up. This option is useful for

SMC/CMC/CMOE 9

Version 7.2.3-a (Thursday, June 14, 2007)

Page 10: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

automatic product generation. It is mostly use in conjunction with the batch and script token. By default, SPI starts with the «SPI» layout. You may wish to launch SPI without any default layout if you build your own within a script, in this case, you can use the layout «EMPTY», this will save start-up time

-nowindow

This will start SPI without any graphic interface. Useful if you want to launch one of your own tool which uses some SPI functionalities without the need to interact with it’s own interface.

-project ...

This can be used to start SPI with a pre-saved project setup. Project file descrube the state of the application including window positioning and data files to open.

-script ... … …

You can tell SPI to execute one or more Tcl script upon start-up. These will be sourced in the order specified so any inter-dependency can be resolved in this order. SPI being mostly written in Tcl/Tk, you can use those scripts to interact with its core and execute specific tasks.

-args … … …

This can be used to specify arguments for you scripts. These can be retrieved in your script in the usual Tcl way through the «argv» list. Ex: [lindex $argv 0].

-tclsh

This can be used to only launch the Tcl interpreter with the SPI libraries path and environment defined so as to be able to execute a processing script. It is mostly used with the «-script» token to specify the script to be executed.

Preferences

SMC/CMC/CMOE 10

Version 7.2.3-a (Thursday, June 14, 2007)

Page 11: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

You can specify your preferences in different ways, either by the launching parameters or by using a script but the preferred way should be to use the «eer_Default» file located in your home directory under the «.eer_ToolDefs» directory.

You could even have multiple copies of this file and just select the one you want to use at start-up with the command line token «-default»

This file already contains the default parameters which were installed during the setup process but you can edit it and change or add parameters. The parameters are self described within the file and it should be fairly simple to understand

Here is an example of what it might look like:

#----- Parametres de SPI

set SPI::Param(Geom) 800x700 ;#Geometrie de l'interfaceset SPI::Param(Pages) { "Page 1" "Page N" } ;#Liste des pagesset SPI::Param(PaneSide) right ;#Position des panesset SPI::Param(Exp) False ;#Affichage des experiencesset SPI::Param(Layout) SPI ;#Layout courant

#----- Parametres des outils

set Console::Param(Geom) { 200x400+[winfo rootx .]+[winfo rooty .] }set Console::Param(Dock) Trueset Mapper::Param(Geom) { 200x400+[winfo rootx .]+[winfo rooty .] }set Mapper::Param(Dock) True

#----- Parametres de la projection

namespace eval Viewport { }

set Viewport::Map(Lat) 41.0 ;#Latitude centrale de l'affichageset Viewport::Map(Lon) -103.0 ;#Longitude centrale de l'affichageset Viewport::Map(Type) orthographic ;#Type de projection geographique

set Viewport::Map(Mask) -1set Viewport::Map(Coast) 1 ;#Cotesset Viewport::Map(Lake) 1 ;#Lacsset Viewport::Map(River) 0 ;#Rivieres

set Viewport::Resources(Bkg) white ;#Couleur du font (background)set Viewport::Resources(Coast) #000000 ;#Cotesset Viewport::Resources(Lake) #0000ff ;#Lacsset Viewport::Resources(River) #0000ff ;#Rivieres

Interfaces: Main

SMC/CMC/CMOE 11

Version 7.2.3-a (Thursday, June 14, 2007)

Page 12: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

SPI’s interface is simple and clean but hides a lot of its functionalities so that the user does not get too many options which he does not need right now in front of him. The main window can be divided into three part:

Menu/Tool bar

The menu bar contains general options to open and close files, print or save as image file, enable display options, start-up associated tools as well as modifying the window layout or adding secondary or external pages. The right hand side «Help» button contains the help bubble option and the about information.

Users can also add their tool to the «Tool» menu by inserting a call in the «eer_Default» file. An empty shell for building your tool with basic interactions like coordinate selection from a viewport is located in the Apps/Tool/YourToolHere directory of SPI.

The toolbar contains the most used functions and will reflect and apply its functions to the current page. The toolbar is described in the next section

Rendering area

This is the visualization window which can be divided in multiple workspaces, each of which contains what is called pages. The main and external workspaces can contain multiple pages arranged in tabs and secondary workspaces contain only a single page. All of these workspaces can be added or removed through the «Window» menu. There is a maximum of 3 secondary side pane but external pages are unlimited.

The main and external workspace tabs can be renamed by double clicking on their labels and entering the new name followed by the return key.

Each page can contain many items, mostly selectable from the display menu which can be moved around and rescaled following the page gridding which can be modified through the «Page Otions» in the option panel.

Only one page is active at a time; That is the one with the mouse icon on its lower left corner. This is the page for which parameters in the option panel and the toolbar are valid. Interacting with any object within a page or clicking in a page will make it the active one. For example selecting a layout will setup the said layout in

SMC/CMC/CMOE 12

Version 7.2.3-a (Thursday, June 14, 2007)

Page 13: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

the active page, while clicking in another page will insert this page’s layout name in the layout selection area of the toolbar.

Even though only one page is active at a time, each of them has the same functionality as the others.

Most of the time, these pages will contain viewports. Clicking the right mouse button within any viewport will bring up a contextual menu allowing you to zoom out, change manipulation mode and open the option panel. Every viewport within a page has the same projection parameters (geography, zoom, location) but they can be different from page to page. This means that you can put different data on two viewport in the same page to look at the same location on two different fields or put the same data on two viewport of different pages to look at the same data but at different locations.

Information bar

The information bar contains three fields and the pointer functions. The pointer function allows the selection of the type of coordinates to use, either degrees minutes or decimal degrees. You can also activate the location window which displays the value, description, world coordinates, and local coordinates in the native coordinate system of every data under the cursor location. This is also where you can activate the global common cursor which follows the cursor location in every viewport of the application, even on different pages on different rendering workspaces.

The first field indicates the coordinates of the mouse cursor in the object under it. For viewport it will be latitude and longitude and for graph, axis coordinates. The second one will indicate the elevation in meters at the cursor location, if and only if the topography/bathymetry is enabled. The third field gives related information about the data currently displayed under the mouse cursor.

At the right end is the process completion bar indicator. It will indicate the advancement of jobs that require some time to complete.

Manipulation

SMC/CMC/CMOE 13

Version 7.2.3-a (Thursday, June 14, 2007)

Page 14: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

The manipulation mode selector lets you select the current manipulation mode. Note that these are the same as in the contextual projection menu and can be selected either way. There are also keyboard shortcuts associated with them.

There are three manipulation modes

Zoom / Rotation Mode (Alt-1)

This mode is the default mode. It allows you to zoom in and move around the projection on the same plane.

Left button ZoomMiddle button Rotation, movementRight button Contextual menu (Fast single click, zoom back)

Camera Mode (Alt-2)

The camera mode can be thought of as the 3D mode. It allows you to move the view point around the focal point, that is the latitude and longitude on which you are centered.

Left button Move around the focal pointMiddle button Move / rotate the focal pointMiddle + Left button Close in or out on the focal pointRight button Contextual menu

Selection Mode

This is the variable mode. By variable we mean that its functions depend on the current action. The said action is usually determined by a specific tool and usually requires the selection of an area or specific point. Whatever these functions will be, the mouse buttons will always do the same general procedure.

Left button SelectMiddle button Modify, moveRight button Contextual menu

SMC/CMC/CMOE 14

Version 7.2.3-a (Thursday, June 14, 2007)

Page 15: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Interfaces: Toolbar

The toolbar contains the most used functions or common functionalities. Some parts of it are specific to the current page/object and will reflect the settings of the current page/object. Selecting a different page/object will therefore change the information within those widgets, even though the page might be within an external window.

The toolbar is divided in five parts.

General part:

The general part contains buttons for some common and useful tasks.

Save the the current/active page to a raster format Print the current/active pageInvokes the properties windowActivates the model pane (Only for EER users)Activates the graph pane and allows for the selection of a graph type

View manipulation part:

The view manipulation or movement part contains functions for zooming, panning and manipulating the current view setup as well as saving and selecting a specific camera view. The current view zoom, position and aspect are all considered parameters of the camera. It’s like placing a camera with a specific lens somewhere around the world to look at what you are interested in.

Zoom modeCamera (3D) modeReset camera viewReset view angleReset zoomZoom back in stepsCamera name(s)Save the current camera viewDelete the current camera view

SMC/CMC/CMOE 15

Version 7.2.3-a (Thursday, June 14, 2007)

Page 16: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Layout part:

The layout part contains functions for the content of the page, allowing the management of the different page setup.

Layout name(s)Save current page layoutDelete current page layoutExecute script within the current page

Page part:

The page part contains functions related to the pages. You can create new pages of different kind, add and delete panes.

Create an external page (New window)Add a page to the active tab paneRemove the current active page pane

SMC/CMC/CMOE 16

Version 7.2.3-a (Thursday, June 14, 2007)

Page 17: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Interfaces: ObjectsThe «Display» menu allows you to add and remove different objects within the current page simply by selecting or deselecting them. All of these objects can be manipulated to move or scale them. Use the left button within the object to move them and the bottom right icon (when available) to scale them. Some other functions might be available for specific objects and are available through the down arrow button if present. All of those items will temporarily become transparent while moving or resizing them. Some of them can be activated only once per page and other can be added multiple times. Every object is also dynamic, they update automatically to specific parameters and can sometimes be used to manipulate other parameters. Use them to compose a page layout which you can save for later use.

Viewport

Viewports are representation of the earth that have a specific projection, geographic information and in which data can be superimposed or geo-referenced. Every single viewport within the same page will inherit the same parameters and focal point. You can add multiple viewport using this option. Moving or zooming in one will have the same effect on every other in the same page. Although geographic parameters will be the same, the data displayed in them will be different. You can display different fields, trajectories and drawing in each one of them. The data selected in the later described interfaces will be displayed in the active viewport, the active viewport being the one with the red manipulation icons. Just click within or manipulate another viewport to make them the active one.

A new viewport will inherit the size of the lastly added viewport.This allows for the creation of equal size viewport.

The viewports are the only object that cannot be moved with the left mouse button since it is already used to manipulate them. There are five manipulation icons in each viewport that are used with the left mouse button. The upper right icon will destroy the viewport while the lower right ones will in order, make the viewport full screen (page), move it, rescale it and zoom in/out.

Viewport Inset/Magnifier

The viewport inset/magnifier can act as a zoomed out view of the other viewports or as an interactive magnifier. It contains the same geographic information with or without the data associated to it. A menu on its lower right allows you to select the zoom, relative or not to the page’s viewport as well as some display properties. The square in the middle shows the close up view of the projections. This square will adapt by resizing and rotating to the camera position as well to show you the view coverage, even while using the camera mode in 3D. You can also use the projection inset to rotate/translate/locate the viewport on the current page as you would in a normal viewport. You can also activate/deactivate the mouse follow mode, useful in magnifier mode. Would you

SMC/CMC/CMOE 17

Version 7.2.3-a (Thursday, June 14, 2007)

Page 18: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

wish to lock the magnifier on a specific spot, you can do so by right clicking at the wanted location in one of the page’s viewport and select the “Lock magnifier” option. To unlock the magnifier, just reactivate the “follow mouse” option

Scale

The scale shows the map scaling factor in relations with distance and zoom factor as seen in atlas maps. Depending on how close you zoomed in, the distance units will change from kilometers to meters down to the metric system limits, but if you go down there you might be a little too close. The scale values are only valid at the focal point and this for the first viewport displayed if they do not all have the same size. The option menu associated with it allows you to select a specific scaling factor (ex: 1:250 000) which will zoom every viewport in the page automatically.

Compass

The compass indicates the orientation of the camera within the viewport. Obviously, it will always point to north unless you use the camera mode to rotate the camera around. The middle label will indicate the exact orientation which you are looking to while the arrows rotate accordingly. Under it is the looking angle and distance from ground indicator of the camera. You can also rotate the view by left clicking in the coordinate indicators and rotating the compass.

Geographic Legend

The legend shows the segment color, width and type of the different geographic information displayed in the viewport. Changing those segment parameters will automatically update this object.

Data Legend

This legend is related to the data associated with a viewport. This also means that there will be a legend for every single viewport, describing the data in it in the order it has been assigned to it.

Clock

The clock indicates the valid time of the data being displayed, the first one applied to the viewport, with an analog style and full date description under it. When animating data in time, there will also be a yellow circle within it indicating the current frame over the full length of the animation.

Logo

Displays an identification logo, … that’s it.

SMC/CMC/CMOE 18

Version 7.2.3-a (Thursday, June 14, 2007)

Page 19: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

String « Test »

Draws a diagonal string containing the word «TEST» repeatedly. This is used to generate test product to be sent to other parties to clearly indicate that this is not a real emergency response or not to take actions.

Colorbar

Colorbars are used to display field and observation scale. They indicate the color/value relationship for different kind of data. These will be displayed for every single field or other data type displayed unless color texturing is not enabled or possible for this data. The format of the numbers and units written can be specified within the «Field Options» and «Observation Options» of the «Option Panel». Through it’s options menu, you can select the bar width as well as the bar style.

Graph

Different kind of graph can be added in a page. Usually, those graphs interact with a viewport to get their data from; we then say they are linked to this viewport. Any change in the viewport’s data will automatically update the graph linked to it. Graphs can then be animated if the viewport which they are linked to is being animated. Interaction can also be the other way around and information from the graph be displayed within a viewport. See the Tools::Graph section for a description of each one. The different text of the graphs like title, axis units and item label can be edited directly in the graph.

SMC/CMC/CMOE 19

Version 7.2.3-a (Thursday, June 14, 2007)

Page 20: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Trajectories

Some items are specific to the trajectory data type

Trajectory elevation graph

This is a two dimensional graph of the height of the particles in relation with time. Every trajectory selected and displayed in the viewports will show up on this graph and they are subject to the same parameters as the one within the viewports which you can access through the «Trajectory Options» in the «Option Panel».

Trajectory elevation list

Shows a list of all the elevations of all particles in order.

Trajectory legend

Standard CMC trajectory legend indicating the source name, departure/arrival date and elevation, model parameters and so on.

Interfaces: LayoutsSMC/CMC/CMOE 20

Version 7.2.3-a (Thursday, June 14, 2007)

Page 21: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Layouts are page arrangements, a collection of objects positioned into the page in a specific way. They can be used to create products model or simply to keep the page layout that you like.

To create a new layout, just insert any object that you like within the page from the display menu, including viewports, legends, etc. Resize them and move them where you like to and if you wish, resize the window as well. You can even use the drawing tool to add text or shapes to your layout and those will be saved as well. Once you are happy with your layout, enter its name in the layout name toolbar widget and press the layout save button beside. Next you will be asked if you wish to save the camera as well, this will only affect the viewport positioning within your layout. Pressing «Yes» or «No» will save this layout and add an entry in the layout list box.

That’s it, your layout is saved!!!

To recall this layout, just select it from the list or call SPI with the «-layout» token followed by your layout name. The page will reshape itself and load your predefined layout.

There is a predefined list of layout which might not be available to you. Those are standard product with interactive capabilities.

For advanced users only!!!

Layouts are saved as plain Tcl commands in your home directory under:

 .eer_ToolDefs/eer_Layout/«yourlayout».tcl 

If you wish or need to, you can go and edit the code to add some interactive or automatic functionality to your layout. Those might range from loading some data to creating specific dialogs for specific needs.

By using the layouts in conjunction with the batch and script mode, you can get a very powerful product generation tool.

Interfaces: Models

SMC/CMC/CMOE 21

Version 7.2.3-a (Thursday, June 14, 2007)

Page 22: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

The models or experiment interface allows you to manage multiple models from launching them to managing the results through an experiment tree.

Not all options are available to all users. Restrictions apply

The model pane is divided into three tabs.

Emergencies

Selecting this tab will display the source icons for all the experiment it contains into the viewports of the active page.This tab allows you to launch models in immediate mode. It is arranged as a tree where the trunks are the experiment or sources in which branches are simulation types and leaves are simulations by themselves. You can open and close part of the trees by left clicking on the plus and minus icons beside the names or open and close everything by using the same icons at the top left of the tab.

At the right of the tab are the accessory functions. The first one opens up the volcanic bulletin parsing interface and the last one brings up the message writing interface were you can create and edit FVCN and AACN messages.

To be able to launch a model execution, you first have to create a new emergency or source location to which the models are going to apply. To do this use the «New» button at the top right of the tab. This will bring up a dialog where you can specify the experiment parameters.

This dialog allows you to select locations from multiple source of information. The top part includes the selection pointer which allows you to pinpoint a specific location into a viewport. By clicking on the column header, you can start the location tool to select locations from as well. The next part is where you can specify the location(s) textually. Just enter the name(s), latitude(s) and longitude(s) of the location(s). You need at least one localisation and up to fifty. Use the scroll bar to scroll through the list in conjunction with the numbered buttons to specify where you want the insertion to occur. The last line allows you to specify a name for this experiment and a type from the icon list at the right. The type of experiment will be used to setup default parameters for the models which can be overridden later in the models interface. The five first types available are in order, volcanic, nuclear, CTBT, fire and biologic. The others are not used yet. Once this is done, click on «Ok» to create the new entry and you will see it appear in the experiment tree and viewport as well.

SMC/CMC/CMOE 22

Version 7.2.3-a (Thursday, June 14, 2007)

Page 23: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Right clicking on this new entry will popup a contextual menu allowing you to launch new model executions, manage the results or erase the whole experiment trunk.

Launching a new model run will add a leaf to the simulation branch type from which you will again have a contextual menu available to continue a simulation, use the results or erase the said branch. This leaf will be named from the distinctive parameters of the simulation.

By moving the mouse cursor over an experiment or simulation, you can have an information bubble popup giving you information about the item.

Watches

Watches are sources for which automatic simulation can be setup. Those are typically volcanoes under high surveillance or other sites of interest.

The general procedure generally follows the Emergencies procedures. Create a new watch by using the button at the bottom of the tab and right click on its entry to enable simulations for this source.

Meteo

The meteo tab contains links to meteorological data. Just parse the three an click on a leaf to open the whole run.

Models: CANERM

SMC/CMC/CMOE 23

Version 7.2.3-a (Thursday, June 14, 2007)

Page 24: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

CANERM, the CANadian Emergency Response Model, is a fully 3-dimensional Eulerian model for medium and long range transport of pollutants in the atmosphere. A detailed description of the model can be found in Pudykiewicz (1). Advection is calculated using the semi- Lagrangian method. Diffusion is modelled according to the gradient (K) theory; diffusivities in the horizontal and in the vertical are dependant on the state of the boundary layer at low levels, and constant in the free atmosphere. The model simulates wet deposition resulting from scavenging by clouds and precipitation. Dry deposition is also simulated by a dry deposition velocity which accounts for the resistance of the turbulent and laminar layers very near the surface.

The source of emission is modelled according to the concept of a virtual source (Pudykiewicz, (2)) to account for unresolved sub rid effects near the point of release. The virtual source is expressed as a 3-D Gaussian function. A variety of atmospheric pollutant can be tracked, including radioactive species and volcanic ash.

CANERM operates on a polar stereographic grid and can be executed on the Northern Hemisphere and on the Southern Hemisphere. The horizontal resolution is 150 km in the hemispheric configuration, 50 km in the continental configuration, and 25 km in the regional configuration, 10 km in the local configuration. The model has 28 vertical levels in the ETA terrain following coordinates.

Although CANERM is run from a high quality NWP model, inherent uncertainties must be considered as a result of the default scenario conditions and the atmospheric conditions. The CANERM model output interpretation must be done with this in mind, given the fact that the source strength and duration are usually not known. The interpretation should be done with the help of an experienced meteorologist having a strong background in synoptic meteorology and also desirably with a background in atmospheric dispersion.

Pudykiewicz, J., 1988. Numerical simulation of the transport of radioactive cloud from the Chernobyl nuclear accident. Tellus 40B, 241-259.Pudykiewicz, J., 1989. Simulation of the Chernobyl dispersion with a 3-D hemispheric tracer model. Tellus 41B, 391-412.

The CANERM interface is divided into three tabs which you should fill sequentially.

Parameters

SMC/CMC/CMOE 24

Version 7.2.3-a (Thursday, June 14, 2007)

Page 25: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

The first item is the source selection. Even though you can select multiple sources for an experiment, CANERM can only run on a single source, hence the source selection. The «Event» selection is only a label that will be used later in the product generation and has no effect in the model execution.

The «Scale» item allows you to select the grid spacing for this execution. Grid sizes range from 5 to 150 kilometers. This grid is automatically displayed in the active viewport. By selecting the selection mode button on the right and the middle mouse button, you can move this grid around to the location you wish. By default this grid will be centered on the source location.

The «Model» item is used to specify which meteorological data to use as input to CANERM you can either choose «glb» for global GEM or «reg» for regional GEM. Be advised that the regional model only covers Canada. You can also specify a path to unarchived data by clicking on the «../» button and enter the prognostic and diagnostic data path. This would happen if you need to run a historic case. You would then need to run XRARC to get the data from the archive system and use this option. Even though the data you would unarchive would probably be only diagnostic data, you still have to specify both prognostic and diagnostic path, setting both the same.

The last item is used to specify the outputs delay of the results in hours. Be advised that this delay will be set to 1 hour for volcanic case and that you should not change it since it is needed for VAAC products.

Release

This is where you input the release parameters. You will have to specify the isotope(s) and their intensity in the pollutant section. By clicking on the drop-down list, you can select the included isotopes and specify their respective intensity. Clicking the «add» button will popup a list of isotopes from which to choose from. Each selection adds it up in the included list. You can put as much as five isotopes in a single run.

The height of the release and the vertical and temporal distribution curves can be specified in the dispersive function section. The temporal curve is also where you will be able to specify the release duration as a parameter to the curve.

The last part is where you select the release date and time.Launch

SMC/CMC/CMOE 25

Version 7.2.3-a (Thursday, June 14, 2007)

Page 26: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

When you select the launch tab, the application will go and look for the available meteorological data either online or in the path you specified if so. Once this is done, a list of the available meteorological files will be orderly displayed with the last file selected. This is where you select the end of the simulation by selecting the ending file from the list. Be advised that the default is to select the last file which means the maximum amount of time. This could go for a very long time.

At the bottom of this list is a length indicator which will show the actual length of the simulation from the ending date you selected.

The last step is to select which computer and queue your want your job to run on and click on «Launch» to launch the execution or «Generate» if you only want to generate the scripts and meteorological input files to delay execution later.

In the case of a local run, you can go in the experiment tree and open down to the list of CANERM of your experiment where you will be able to see the execution bar of the run. As soon as the red bar gets filled and disappears, the model will have finished execution.

SMC/CMC/CMOE 26

Version 7.2.3-a (Thursday, June 14, 2007)

Page 27: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Models: MLDP0The MLDP0 interface is divided into three tabs which you should fill sequentially.

Parameters

The first item is the source selection. Even though you can select multiple sources for an experiment, MLDP0 can only run on a single source, hence the source selection.

Next are the release start date and time and the integration’s internal time step and output time step.

The «Event» selection is only a label that will be used later in the product generation and has no effect in the model execution.

The «Scale» item allows you to select the grid spacing for this execution. Grid sizes range from 5 to 150 kilometers. This grid is automatically displayed in the active viewport. By selecting the selection mode button on the right and the middle mouse button, you can move this grid around to the location you wish. By default this grid will be centered on the source location.

The «Model» item is used to specify which meteorological data to use as input to MLDP0 you can either choose «glb» for global GEM or «reg» for regional GEM. Be advised that the regional model only covers Canada. You can also specify a path to unarchived data by clicking on the «../» button and enter the prognostic and diagnostic data path. This would happen if you need to run a historic case. You would then need to run XRARC to get the data from the archive system and use this option. Even though the data you would unarchive would probably be only diagnostic data, you still have to specify both prognostic and diagnostic path, setting both the same.

Release

This is where you input the release parameters which are divided in two parts. The first part is the emission column in which you have to enter the number of particles, the column radius, the total mass and density as well as the vertical and temporal distribution of the parcels.

The scenario part is used to specify the isotopes released and for how long and when they are released. By selecting «Editing» you can specify intervals of release and non-release for multiple isotopes so as to

SMC/CMC/CMOE 27

Version 7.2.3-a (Thursday, June 14, 2007)

Page 28: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

best define the release and save this scenario for later use. There will always be a default scenario which cannot be modified. This part differs depending on the experiment type selected in the «New Experiment» interface.

The total duration indicates the release length without the pauses while the real duration indicates the full length of the release.

Launch

When you select the launch tab, the application will go and look for the available meteorological data either online or in the path you specified if so. Once this is done, a list of the available meteorological files will be orderly displayed with the last file selected. This is where you select the end of the simulation by selecting the ending file from the list. Be advised that the default is to select the last file which means the maximum amount of time. This could go for a very long time.

At the bottom of this list is a length indicator which will show the actual length of the simulation from the ending date you selected.

The last step is to select which computer and queue your want your job to run on and click on «Launch» to launch the execution or «Generate» if you only want to generate the scripts and meteorological input files to delay execution later.

In the case of a local run, you can go in the experiment tree and open down to the list of MLDP0 of your experiment where you will be able to see the execution bar of the run. As soon as the red bar gets filled and disappears, the model will have finished execution.

SMC/CMC/CMOE 28

Version 7.2.3-a (Thursday, June 14, 2007)

Page 29: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Models: MLCD The MLCD model interface is divided into three tabs which you should fill sequentially.

Model

The first item is the source selection. Even though you can select multiple sources for an experiment, MLCD can only run on a single source, hence the source selection. Next, you will have to specify the departure date and time of the release and the integration duration in minutes as well as the output delay in minutes, the minimum of which being 5 minutes.

You can also enable the computation of concentrations from the particle fields and specify the method to be used and the grid domain on which to resolve theses concentrations.

The last option is to enable or not the speed fluctuations at meso-scale level. This will affect particle displacement.

Emission

The emission section allows you to specify the release parameters by entering the number of particles to be released and the total mass they will make. Next is the isotope specification. Clicking on the isotope name will bring up an isotope selection interface with defaults to select from. Once this is done, you can override the default deposition velocity, half life and scavenging coefficient.

Following is the emission column section. Here you define the size of the release cylinder within which the particles are homogeneously placed. You will have to enter the bottom, top and radius of this cylinder in meter and the total release duration.

SMC/CMC/CMOE 29

Version 7.2.3-a (Thursday, June 14, 2007)

Page 30: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Meteo

The meteo tab, as the name says is where you can define the meteorological environment.

MLCD uses wind profiles at the source to create it’s version of the atmosphere. This version allows for more than one profile over time to be used but still at the source location.

The first part allows you to get this information automatically. Just specify the number of time step, the number of vertical level from the ground up and from which meteorological model to get the information from. Then click on «Recuperate» and the recuperation process will start. This might take a few seconds but once the information appears in the lower part, it will be over.

The lower part contains the recuperated information but also allows you to specify the profiles by yourself. You can select which observation you want to enter/modify and the time of this observation. By cycling through this selector, you can edit as much as 10 observations time step.

The local parameters section items include the rugosity, the atmosphere stability (Obukhov length) and the precipitation rate. Each of these items has predefined values in the list button on their left but you can also enter your specific values if you want to.

You will have to enter at least one wind parameter into the wind profile for the observation section and a maximum of fifty, either by hand or using the automated feature. These are entered as height in meter, speed in meter per second and direction in true degrees (coming from).

Once everything fits your needs, click on the launch button and the model will start. You can go in the experiment tree and open down to the list of MLCD of your experiment where you will be able to see the execution bar of the run. As soon as the red bar gets filled and disappear, the model will have finished execution.

SMC/CMC/CMOE 30

Version 7.2.3-a (Thursday, June 14, 2007)

Page 31: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Models: Trajectory The model can be run to obtain a quick estimate of the expected trajectory of an air parcel, whose point of origin or point of arrival (Back Trajectory) is specified as the input parameter. The only physical process taken into account is advection by atmospheric currents.

The position of the parcel is calculated using Peterssen's (1) algorithm. Let Xi be the position of the parcel at initial time, and Xf be its position after the interval dt with V(Xi) and V(Xf) the velocities of the parcel at the initial and final positions, respectively. Then we estimate:

Since the final position is to be found, the speed V(Xf) is unknown and we proceed by iteration :

Until

The wind fields produced by the global model are normally used. The model estimates the trajectories of the parcels, originating from or arriving at the same geographic location, but for different levels in the vertical. The location and levels are defined by the user.

Peterssen, S., 1956: Weather Analysis and Forecasting. McGraw-

SMC/CMC/CMOE 31

Version 7.2.3-a (Thursday, June 14, 2007)

Page 32: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

The Trajectory model interface is divided into two tabs which you should fill sequentially.

Parameters

Although there are only three entries, you can specify up to twenty-five particles level by using the scrollbar on the right. You can enter the heights either in meters or millibars by clicking on the unit label to switch between the two.

The next part includes the method which can be forward, if you want to know where the parcel will go or backward to figure out where the parcels come from. Following is the internal time step of the model and the meteorological data to be used. You can use the global model «glb», the regional model «reg» or the himap «himape» and «himapw». Be advised of the coverage of these meteorological models since the Trajectory model will stop as soon as a particle exits the domain without going to the end of its execution.

The «../» button can be used to specify a path other than the standard ones. This would be the case if you wanted to run with unarchived data for a historic case. Even though the data you would unarchive would probably be only diagnostic data, you still have to specify both prognostic and diagnostic path, setting both the same.

Last but not the least; You can select the departure/arrival date and time of the parcels.

Launch

When you select the launch tab, the application will go and look for the available meteorological data either online or in the path you specified if so. Once this is done, a list of the available meteorological files will be orderly displayed with the last file selected. This is where you select the end of the simulation by selecting the ending file from the list. Be advised that the default is to select the last file for a forward simulation and the first file for a backward one which means the maximum amount of time. This could go for a very long time.

At the bottom of this list is a length indicator which will show the actual length of the simulation from the beginning/ending date you selected.

SMC/CMC/CMOE 32

Version 7.2.3-a (Thursday, June 14, 2007)

Page 33: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

If you would like to launch multiple trajectories over the selected time lapse, you could set the «T0+» entry to the delay at which you want each trajectory to start end the «Tend» to the duration of each trajectories

The last step is to click on «Launch» to launch the run.

You can go in the experiment tree and open down to the list of TRAJECT of your experiment where you will be able to see the execution bar of the run if you are running the model locally. Otherwise, the simulation label will be red until the simulation finishes.

SMC/CMC/CMOE 33

Version 7.2.3-a (Thursday, June 14, 2007)

Page 34: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Data types: Trajectory Each trajectory file can contain many trajectories each of which can contain many particles. For the sake of display options, every corresponding particle of each trajectory will bear the same parameters.

Displaying trajectories can be done by first opening a file using the menu «File» and «Open» followed by «Trajectory». Select the file(s) you want and a «TrajBox» will popup containing the trajectories of the file. Once a «TrajBox» is open you can use its functions in the «>» menu to open more within the same «TrajBox»

You then only have to double click on it to display it in the active viewport and/or any trajectory related object. You can also display multiple trajectories by selecting them with the control key pressed and using the refresh button in the lower left corner of the «TrajBox».

The display parameters for the trajectories can be accessed through the viewport contextual menu item «Parameters» or the «F9» key. Once the option panel comes up, select the «Trajectory» tab. Those parameters allow you change the icon type and color, the segment and icon width and more. Refer to the Options: Trajectory section

Some other functions are also available through the display menu under the «Trajectory» submenu. The «Graph» option displays an elevation graph of the selected trajectories, the «Elevation» displays a list of all elevation for every particles and «Legend» brings up a standard trajectory legend. The trajectories are mapped in elevation on the viewport. By using the camera mode, you will be able to look at them in 3D and rotate around. Would the elevation not be noticeable enough, you could adjust the elevation factor in the «Projection» tab of the option panel.

Moving the mouse cursor over the particles icon will display the date for the said particle into the information area of the main interface as well as display the height and speed of this particle beside it and light up every time corresponding particles.

SMC/CMC/CMOE 34

Version 7.2.3-a (Thursday, June 14, 2007)

Page 35: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Data types: Standard filesStandard files are files containing field to the RPN Standard Format. Two formats actually exist, the 89 format and the 98 format which allows bigger fields. SPI can read both formats but exports only to 98 format.

You can open standard files by using the file menu followed by «Open» and «Standard File». You will then be able to parse the directories and select the files you want. Once selected a «FieldBox» will popup containing the fields within the file(s) you selected. Once a «FieldBox» is open you can use its functions in the «>» menu to open more within the same «FieldBox»

To display a field, just double click on it and it will be assigned to the active viewport. To display many fields superimposed, select them while pressing the control key click on the refresh button in the lower left corner of the «FieldBox».

SPI can display different kind of fields from gridded fields to vectorial fields (UU-VV, UD-VD) and particles fields (ZH). SPI will automatically detect the field type and set the corresponding parameters. All the fields are mapped in true elevations which mean for example that a planar gridded field in eta level will be mapped according to the GZ values, if they were available.

The display parameters for the fields can be accessed through the viewport contextual menu item «Parameters» or the «F9» key. Once the option panel comes up, select the «Field» tab. Those parameters allow you to select the rendering type (contour, texture, grid, volume), the levels, the colormap and so on. Refer to the Options: Field section

Moving the mouse cursor over the field in the viewport will display the value of the field(s) at this location into the information area of the main interface. Would the cursor be out of the gridded field «-» will replace the value.

SMC/CMC/CMOE 35

Version 7.2.3-a (Thursday, June 14, 2007)

Page 36: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Data types: Icon An icon file contains a list of localisation with three coordinates (latitude, longitude and elevation) and identification. The file also defines the way this list will be displayed using a defined color and bitmap or image. To get more information about the file format, refer to the File format: Icon section.

These files are useful to superimpose interesting locations for various cases.

You can open icon files by using the file menu followed by «Open» and «Icon». The icon list will immediately be displayed on all the viewport and an entry will be added in the «Icon» submenu of the display menu where you can activate or disable this icon group.

No other parameters are available for this kind of data.

SMC/CMC/CMOE 36

Version 7.2.3-a (Thursday, June 14, 2007)

Page 37: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Data types: Observations Observations files can be used to display and compare values at defined locations. Many values can be entered for a single location within the same file. To have more information about this format, refer to File format: Observations.

You can open observations files by using the file menu followed by «Open» and «Observation». Select the file(s) you want and an «ObsBox» will popup containing the observations of the file. Once an «ObsBox» is open you can use its functions in the «>» menu to open more within the same «ObsBox»

You then only have to double click on it to display it in the active viewport. You can also display multiple observations by selecting them with the control key pressed and using the refresh button in the lower left corner of the «ObsBox».

The display parameters for Observations can be accessed through the viewport contextual menu item «Parameters» or the «F9» key. Once the option panel comes up, select the «Observations» tab. Those parameters allow you select variation on the values using color, variation on the time using size and so on. Refer to the Options: Observations section

SMC/CMC/CMOE 37

Version 7.2.3-a (Thursday, June 14, 2007)

Page 38: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Tools: AnimatorThe animator tool can be used to animate fields, trajectories and observations. It can animate data in time; vertically or on other variables but can also animate movement or flybys. It is built like a video player to be easy to understand. On the first loop of animation, frames will be generated which means that the speed of the first loop might be a lot slower than for the next loops. You can also decide not to store the frames by deselecting the «Store frame» button. This might be useful when animating many frames or when memory is limited since the frames will be redrawn every time instead of stored in memory.

You can still manipulate the viewports and zoom or rotate, or even change any options while animating. The animator will regenerate the frames if it needs to and carry on the animation until you stop it.

If you have multiple viewports within a same page, they will all be animated together. Only one page can be animated at a time.

Commands

CloseStore framesLoopBack to beginningPlay backwardOne frame backwardStopOne frame forward Play forwardPrint frames

When using the print frames button, a «FileBox» will popup so that you can specify the filename of the image series. The file extension you will give to this file will decide on the type of image that will be generated. For example «image.gif» will mean that a series of GIF imaged named «image-nnnn.gif» will be created. If you do not specify an extension, the default format (PostScript) will be used. When printing, every frame and associated data will be cleaned from memory after generation so has to limit memory usage and be able to generate very long animation.

Frame indicator

The frame indicator as its name implies indicates the current frame and the length in frames of the animation. You can also use it to scroll back and forth the animation interactively.

SMC/CMC/CMOE 38

Version 7.2.3-a (Thursday, June 14, 2007)

Page 39: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Delay

Located on the right side of the frame indicator, it can be used to slow down the animation by inserting a delay between frames. The delay varies between 0 and 500 milliseconds.

Markers

Markers are located under the frame indictor and are used to specify the beginning and end of the animation if you don’t want to run through every loaded frames.

Information

This is where you can see what the animator is doing (reading, animating, printing, converting ...)

Two types of animation can be done, either one or together.

Data

Data animation animates the data itself, either on the DATE, IP1, IP2 or ETICKET. You can also activate or deactivate IP3 validation for field selection, since some people use IP3 to store information which might not be consistent over time for a single field.

Flyby

The fly interface can be used to make 3D flybys in somewhat a way that a plane would do. This is a way to produce fancy animations that shows 3D data in an interesting way.

The way you can specify a flight is to create and insert waypoints which will be the control points of the flight path. The animation will be an interpolation of the frames between the waypoints at specific intervals. These intervals can be specified in a way that simulates speed.

For the moment, only the flight path can be specified. This means that the camera is always centered on the same location whatever the flight path will do.

There are predefined flights which you can use, just click on one of them and press the play button to activate them.

Round the earthFly aroundFly to

Fly through

SMC/CMC/CMOE 39

Version 7.2.3-a (Thursday, June 14, 2007)

Page 40: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

To create your own flight path, just move the camera around using the camera mode (Alt-2) to the position you want as the start. Click the insert button to store the current position. Carry on with the same procedure for the second, third ... control points. You can use as many control point as you want but no less than two, otherwise, no path will be created.

You can come back to previous waypoints by selecting them and erase them by using the suppress button. Double clicking on a waypoint will set the camera to this waypoint.

The insertion happens under the selected waypoint. This means that you can come back and insert waypoints between other waypoints. Using this, if you want your flight path to be a closed path, just double click on the first waypoint to place the camera at this waypoint, select the last one and click on the insert button. The first and last waypoint being the same, this will result in a nice looping animation.

Once you are satisfied with your newly created path, use the play button on the lower left to start the flyby. The animation will automatically cycle. Use the stop button to stop it.

The scrollbar on the right can be used to set the flyby speed.

SMC/CMC/CMOE 40

Version 7.2.3-a (Thursday, June 14, 2007)

Page 41: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Tools: CalculatorThis calculator allows you to do calculus on either numbers or standard fields. The specified expression will be applied to every value within the fields and you can display or save the result immediately. It looks and works as a real calculator with functions and memory tools, the major difference being the presence of logical operators and conditional functions.

There is two mode of operation for the calculator, the «Calc» and «Macro» mode. In the first mode, you insert a field within the expression field, by using the middle button within any «FieldBox» over the field you wish to use. An entry will be added to the expression looking somewhat like the following:

field(fidx,idx)

Where fidx is the index of the file and idx is the index of the field within this file. This will tell the calculator where to get the field from for its calculus when you push «=». This indexing format is the same as the one indicated on the last line of the «FieldBox» information bubble which pops up if you move the mouse cursor over a field.

When the calculus is made, the result will either be a number for calculus without fields of a descriptor like the following for field expression:

FLDCALCxxx

Where xxx is a numbering scheme which will increment every time you memorize a field result. This allows reusing a previous result within another expression. If you do not memorize the result, it will be overwritten the next time around.

In the second mode, expressions are linked to a viewport and you replace fields by uppercase letters. The expression will be automatically applied using the fields assigned to the viewport and it is the result that will be displayed within the viewport. This allows for very powerful functionalities like animating the results, using expressions for graphs, etc. You can enter a different expression for every viewport. You can also save this expression for later use by giving it a name in the following field and pressing the save button.

A quick check is made on the result to ensure that no division error or overflow occurred anywhere in the resultant field. Would either of these occur, NAN or OVERFLOW will appear instead of the result.

SMC/CMC/CMOE 41

Version 7.2.3-a (Thursday, June 14, 2007)

Page 42: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

You can display the resultant field by selecting the refresh icon on the top far right of the interface. Enabling this will automatically display the result on the active viewport as the first field, appearing under any other field within the viewport rendering.

The resultant field parameters (NOMVAR,GRTYP,...) will be inherited from the last field within the expression. You can then modify the field rendering options for this field within the option panel as you would do with any other fields. By using the field parameter button you can change the information about the field.

You can also save the result within a standard file (98 format), existing or not, using the disk button. Be advised that this operation will not save the grid descriptors. If you require them, you will have to copy them to the right file using the «FieldBox» copy function.

Working with vectorial fields is allowed and the operations will be applied to all the composants for the fields. Saving the result of a vectorial calculus will again save it in vectorial format, as would be expected.

The operators are available as buttons and the functions are divided in tabs on the right part of the interface. Both apply to either numbers or fields.

Most operators should be fairly simple to understand although logical operators might be new for some users. Just note that theses:

A == B A equals BA != B A different from BA < B A smaller than BA <= B A smaller or equal to BA >= B A greather or equal to B

A && B A and BA || B A or B!A not A

will only return the following values :

0 if the result is False.1 if the result if True.

*Keep in mind that for logical operations, anything but 0 is True and 0 is False.

And theses:

A << B Bilinear interpolationA <<< B Bicubic interpolation

Interpolate the B field into the A grid.

SMC/CMC/CMOE 42

Version 7.2.3-a (Thursday, June 14, 2007)

Page 43: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

The function sections include the following grouping tabs:

Trigo includes trigonometric functions (sin, cos, ...)Math includes standard mathematical functions (log, exp, ...)Stat includes statistical functions (agv,cor,min,sum, …)Conv includes conversion factorsConst includes specific constantsCondition includes the conditional functions

You will also find the memory functions within those tabs. Those functions allow you, as for a real calculator, to save the result of an expression using «STO», either a field or a number. The results saved will be included in the memory list where you can retrieve them later using «RCL» or erase them using «DEL». Memorisation should be used when a «field()» operation is used multiple time within a single expression so that the field is not read multiple times but instead stored in memory.

You could, if you wished, save an expression into the memory tab but this would be futile since every expression previously calculated is included in the expression list accessed with the button right beside the expression field.

SMC/CMC/CMOE 43

Version 7.2.3-a (Thursday, June 14, 2007)

Page 44: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Tools: DrawBoxThe «DrawBox» tool allows you to draw primitives within the page either geo-referenced within a projection or at static pixel locations. Those primitives are said to be dynamic since they will be updated automatically as you work with related objects, moving them around or changing their information relation. The primitive’s properties are always available for changes. You can come back later and change a color, width or even positioning without having to recreate the whole drawing. The static primitives can be moved around by leaving the selection mode end moving them while holding the left mouse button on them.

Drawing can occur in any viewport while in geo-referenced mode but if you start a primitive in one viewport and then switch to another one to finish it, it will be assigned to the last viewport. The top bar contains functions to reorder your primitives, by bringing them all the way to the top or bottom of the display list or just lowering or getting them up a notch. The rightmost button deletes the selected primitive.

Next and to the left, is the primitive bar where you can select which new primitive you want to add to the page. Selecting either one of them will add an entry to the primitive list and display its options in the option bar right under. Options are specific to each primitive. Once a primitive is created and selected in the primitive list, the next step is to locate it within the page by adding or deleting vertices. Just click with the left button where you want to add a vertex or the middle button to remove or go back in the vertex list.

Some primitives like lines and polygons need multiple points so adding vertices will give you a bigger line or polygon. Some other primitives like bitmap and text only need one vertex so adding more will make copies of them, using the same properties, where specified. The same applies to squares and circles which require two vertices. Adding any more will draw another square or circle using the same properties. This allows you to make groups of primitives with specific parameters and modify them together. The primitives are drawn in the order in which they where created so some may obstruct others. Use the display ordering buttons to change the primitive ordering. These buttons will lower or raise the selected primitive within the list.

You can always come back later and change any parameter of any primitive by first selecting it in the primitive list and selecting the parameters you need. Those changes are applied immediately.

SMC/CMC/CMOE 44

Version 7.2.3-a (Thursday, June 14, 2007)

Page 45: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Here is the list of available primitives:

LineDraws a polyline, straight or curved, with or without arrowheads.

PolygonDraws a polygon, straight or curved, filled or empty.

Rectangle Draws rectangles by specifying both corners, straight or curved corners, filled or empty.

Circle Draws circles by specifying the center and radius, filled or empty.

OvalDraws ovals by specifying the center and both radius, filled or empty.

Icon Draws multiple icon using the specified bitmap and color.

ImageDraws images.

TextDraws text with specific font and color.

Value retrieving tool (Only in geo-referenced mode)Draws a standard field value extractor with or without grid coordinates, geographic coordinates and validity date. This item will be updated as the field is changed or updated.

Interactive streamline (Only in geo-referenced mode)Draws a streamline to and from the selected point for vectorial field only. This item will be updated as the field is changed or updated.

Distance measuring tool (Only in geo-referenced mode)Draws a double arrowhead additive distance.

Vertical scale (Only in geo-referenced mode)Draws vertical scale in which you can specify the intervals

Compas/Angle calculation (Only in geo-referenced mode)Draws a compass at the location of the first click and direction arrows on the next ones starting from the compass center. You can draw multiple direction arrows in the same compass

SMC/CMC/CMOE 45

Version 7.2.3-a (Thursday, June 14, 2007)

Page 46: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Free hand drawing Draws in a free hand manner

Two drawing mode are available and not all primitives are available in all modes. You can select which mode you want with the two buttons in the lower part of the interface. You have to specify the mode before creating a primitive.

The «GeoRef» mode allows you to draw geo-referenced primitives meaning that every vertex you add will be stored as latitude, longitude and yes, elevation (meters) coordinates. Rotating or manipulating the viewport will move the primitives accordingly. This also means that you won’t be able to add vertices out of the viewports. In the case of multiple viewports, adding a vertex in another viewport will switch the primitive to this viewport. This also means that you can draw independent drawing in each viewport. Every primitive are available in this mode although circles and rectangles will have a tendency to change shape as you rotate the viewports.

The other mode is the «Static» mode. When drawing in this mode, the primitive coordinates will be stored as pixel locations. They will not be subject to any geographic manipulation and will always be drawn over any viewport that might cover them otherwise. This mode allows you to draw anywhere in the page. The measuring and value tool primitives are obviously not available in this mode.

At the bottom of the interface, you will find the geographic coordinate indicator and selector. This indicator as its name says shows the current mouse localisation over the viewports but it can also be used, in «GeoRef» mode to enter a specific location for a vertex. Just enter the latitude, longitude and elevation in the three fields and click on the add button at the right to add this coordinate to the vertex list. This can also be used to fix the drawing elevation as the specified elevation will be the one used as long as it is not changed.

SMC/CMC/CMOE 46

Version 7.2.3-a (Thursday, June 14, 2007)

Page 47: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Tools: Geographical Data (Mapper)This tool is used to display and manage geo-referenced raster and vectorial data. It can read various formats among which, ESRI Shape, MapInfo MID/MIF, GeoTIFF and more. We use the OGR/GDAL library used by many other packages like GRASS. The tool contains two panes, one for the selected information and one for the data digging.

For performance reasons, geo-referenced information is assigned to a specific page/projection, not viewport. This means that you can specify different information to different projection on different pages, not on the same page since the projection is the same for every viewport on the same page. This allows for multiple viewport with the same geographical information to be manipulated together with different modeled data.

Selecting a viewport will update the tool with its assigned information.

On the upper right part are the layer ordering button which allow you to bring to front, bring to back, raise or lower the data within the selected data list so as to change the display order in the viewport. Beside those is the suppression button which does what you think it does.

To select information, you can use two different methods. You can either open the file with the folder button of the upper part or use the search method within the lower part.

With the search method, you first have to look for valid files by using the search button end selecting a directory. The tool will then look recursively within this directory and display the tree of the data it recognizes in the digging pane. You can then parse this tree and use the selection mode to select a rectangle of interest within a viewport so as to restrict the tree to this area of interest. Use the blue circle button to cancel the selection.

Alternatively, if an index file exists within the opened directory, it will be read and displayed within the active viewport as well as the selected data pane instead of parsing the directory. This allows seeing the data coverage right away and by selecting one of the coverage polygon, to load and display its associated data.

Once the tree is displayed, you can double click on any file to assign it to the current viewport’s projection (the one with the red icons). Its layers/bands will be displayed in the selected information pane. You can right click on the layer/band to access a contextual menu giving access to parameters and the options to center the active viewport on the selected data or zoom in to its extent.

SMC/CMC/CMOE 47

Version 7.2.3-a (Thursday, June 14, 2007)

Page 48: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

There are different parameters for the different kind of data, namely vectorial, raster and 3D modelling data. Theses allow for positioning the data geographically, specify the rendering options or get information about the data itself.

Vectorial data

Vectorial data can be thought of as layers of information within which each object is called a feature. Each of these features has fields containing information and a geometry defining its geographical situation. Every layer has its own parameters which are the same for every feature and geometry of this layer.

Vectorial data parameters are divided in four panes.

Display

Display parameters are used to specify how to display the layer’s features geometry.

The fill button can be used to fill polygons with a specific color while the contour width and aspect can be used to specify the outline parameters. The transparency option applies to both contour and filling and allows seeing through the layer’s features.

The label item will display the value of the specified field at the centroid of the feature for every feature within the layer with the color specified for the contour and the font specified in the interval values.

The extrude factor and field are used to specify a third dimension for the data. Select a field to use from the available fields in the data and use the factor to scale this field. This will allow you to display the data in 3D.

The topography allows you to map the data onto a specific plane. It can either be one of the available field or «INTERNAL» to use the default earth topography.

Extrusion occurs above the topography, you can think of the topography as the floor and the extrusion as the height from the floor. While those two parameters can be scaled with the factors, they are also subject to the global projection height scaling factor. Hence the topography and extrusion factors should be used to convert to meters so as to keep height consistency.

You could also map a color scheme on a specific field of the layer so as to differentiate the different features within the layer with different colors. Just select through the available fields and click on the color bar to edit it and define

SMC/CMC/CMOE 48

Version 7.2.3-a (Thursday, June 14, 2007)

Page 49: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

your colormap. You can also define the intervals or range of values to which it applies.

The intervals can be accessed through the combo box or you can type in specific intervals from lowest to highest. The number formatting accepted is very loose and only need to be separated by spaces. You can also specify a range of values.

Examples:

1e-10 1e-8 1e-41.32e2 234.466 300[10 100]

Value formatting is used to specify how the numeric values will be displayed that is as integers, floats, exponents or let the application select the format itself. You can also specify how many decimals you want to see. The first button will bring the font dialog for you to choose from. These have no effect on string or non-numeric fields.

Referential

The referential parameters are used to specify where the data should be displayed geographically. You can specify the projection onto which the data is referenced so as to display it correctly and at the right location. Sometime the projection is within another file (.prj) and you might have to get it by using the folder button.

If you select some data and cannot center on it or it is displayed all over the place, this might indicate a problem with the geo-localisation definition even though you can see a projection definition as if it cannot find a valid projection for the data, it assumes a cylindrical lat-lon projection with a WGS84 datum.

The projection has to be specified in an OGC WKT (Well Known Text) format. Refer to the OGC documentation for more information.

SMC/CMC/CMOE 49

Version 7.2.3-a (Thursday, June 14, 2007)

Page 50: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Item

The item pane can be used to parse through the different feature of a layer and to display their field values. Cycling through the features will center the viewport in which they are displayed on them. Selecting a feature within a viewport with the selection mode will also bring this pane up with the selected feature’s information.

These fields are the same one that you can use as labels, for the topography, the extrusion, the colormap mapping and the selection operation. You can refer to those to figure out the type of data and available information. Obviously, some field being strings, they might not work for some of the configurations like extrusion and colormap for example.

Selection

Within this pane, you can execute a feature selection on the defined fields of the said features. Each field is listed with an operator selector followed by an entry were you can enter the value to use when applying the operator to the feature’s field value. The operators are fairly simple and include:

~= Regular expression (Strings)== Equality!= Inequality< Smaller than<= Smaller or equal to> Greater than>= Greater or equal to<> Range selection, from … to …[ ] Within list operator

You can enter several predicates and then click on the «Apply» button to activate your selection. Only the features answering to your selection will be displayed in the assigned viewport and only those will be available in the table parser as well. Leaving a field empty will make it not affect the selection. To cancel the selection and display every feature, click on the «Reset» selection button

SMC/CMC/CMOE 50

Version 7.2.3-a (Thursday, June 14, 2007)

Page 51: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Table

Within this pane, you can look at the whole feature field database where the columns are the fields and the rows the features. The selection applied in the selection tab will restrict which features are shown in the table

You can order the table by field by selecting its column header. Selecting a feature header will center the viewport to which it is assigned on it and selecting a feature within a viewport with the selection mode will highlight it row within the table as well.

Even though the table is editable, it will not affect the feature database itself. It is editable mainly for cut and paste functionality.

SMC/CMC/CMOE 51

Version 7.2.3-a (Thursday, June 14, 2007)

Page 52: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Raster data

Raster data is divided into bands. These bands can be assigned to the red, green, blue and alpha channel so as to be combined into an image. Varying the combinations of bands and color curve of distribution can help find out features within the data.

Raster data parameters are divided in four panes.

Display

Display parameters are used to specify how to map the bands to the color channels.

In the curve editor, you can see the histogram for the current band/channel and its distribution curve. At the bottom are the minimum and maximum of the band as well as the cursor’s position value and number of histogram samples. Under the minimum and maximum are the range bar values.

Using different curves for different channels might help in extracting visual information from the band combinations. You can specify a different curve for each channel curve or lock them together with the lock button to change all of them together. Just click on the color corresponding to the channel you want to edit to modify its curve. You can modify the distribution curve by using the curve list and the inversion buttons on the right or by directly pointing in the curve display to move its control points and range bars with the mouse.

A general transparency factor can also be applied to the data, in addition to the alpha band if available.

The band/channel combo boxes are where you can assign bands to color channels. You cannot assign only two channels, it has to be 1, 3 or 4 and always starting from the red channel. If only the red channel is assigned, the colormap is applied to it, otherwise an RGBA values is calculated from the assigned bands. Using the alpha channel is not mandatory and is useful only for variable transparency effect. Each channel needs to be assigned a band of the same dimension and data type, since sometimes there are different band sizes within the same file. Doing otherwise will result in an error.

You can also select the color interpolation level. A linear interpolation level is best suited for a true color presentation type of the data while a nearest level might be more interesting for looking at the coverage of the information since the pixel coverage will be well delimited.

SMC/CMC/CMOE 52

Version 7.2.3-a (Thursday, June 14, 2007)

Page 53: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

The topography item can be used to wrap the raster band like a 3D meshe. You can select between the «INTERNAL» topography information, one of the band assigned channel or any other band currently in memory.

When rendering raster data, the information is assembled in tiles of specific size and each of these have a number of anchor sampling points, which are correctly located, the minimum of which obviously being four. For low resolution and high coverage data, and depending on the projection on which it is displayed, it might be necessary to refine this number of anchor points so as to correctly place the information. You can use the sampling item to select the anchor grid division.

The clipping operation allows you to clip the raster data to a user defined area. Click on the cursor button to enter the drawing mode and draw the your clipping polygon within a viewport and select apply to apply the clipping. The polygon button can be used to show or hide the clipping polygon itself. Be advise that this clipping polygon is not applied to the data itself but to through the OpenGL rasterization pipeline at ground level which means that you can see some artefacts when going 3D

Referential

The referential parameters are used to specify where the data should be displayed geographically. You can specify the projection onto which the data is referenced so as to display it correctly and at the right location. Sometime the projection is within another file (.prj) and you might have to get it by using the folder button.

If you select some data and cannot center on it or it is displayed all over the place, this might indicate a problem with the geo-localisation definition even though you can see a projection definition as if it cannot find a valid projection for the data, it assumes a cylindrical lat-lon projection with a WGS84 datum.

The projection has to be specified in an OGC WKT (Well Known Text) format. Refer to the OGC documentation for more information.

The transformation and inverse transformation allows you to see and edit the positioning functions within the projection. These are the components for the transformation matrix, namely the translation, scaling and rotation components { Tx Sx Rx Ty Ry Sy }. Specifying one of the transformations will trigger the calculation of its inverse automatically so in most case you will only have to specify the transformation matrix.

SMC/CMC/CMOE 53

Version 7.2.3-a (Thursday, June 14, 2007)

Page 54: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Meta

The metadata pane only displays the metadata encoded in the file for the selected bands. This can sometimes give interesting information about the data, its encoding standards, projection, processing used, provenance, etc… but is unfortunately not always used.

Geo-coding

The geo-coding pane can be used to locate data without geo-transform. It works by calculating a transformation matrix with a correspondence between control points pixel/latlon/referential relationship. You have to first specify the projection onto which the data is mapped and then insert control point with the plus pin button and select the control point pixel position in the image on the right and the latlon position within a viewport. The more control point you place the more precise the transform will be. Once satisfied with the points, click on calculate to get the transformation matrix and if all went well, you should see the data well located into its assigned viewport.

Be advised the transformation matrix is calculated from first order derivative and might not be optimal. It might also be possible that it could not be calculated with enough precision. In this case, you can activate the approximate button to get a rough transformation which might be too offset.

You cannot yet save the transformation matrix within the raster data file. This will be implemented in future release.

SMC/CMC/CMOE 54

Version 7.2.3-a (Thursday, June 14, 2007)

Page 55: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Tools: NowCasterThis is a new tool which gives now casting functionalities to SPI, allowing to view the state of the atmosphere and meteorology at a specific time, automatically adjusting the data for the currently selected time. It is organized with one data type per tab with a standard time bar at the bottom which controls the timing of every data type.

The time bar includes the automatic update button, refreshing the interface when new data is available, and a persistence selector which defines how long data should be visible before disappearing when not updated. This will basically set the transparency of the element values so that it is not transparent at all when it’s exactly at the current time and fully transparent after the persistence delay is past.

Following is the current display date and time, for which the data is valid and the animation button to loop on the available time range. You can select the time step of the animation, from minutes to weeks and scroll through time with the time scroll bar.

For the moment, two kinds of data are available through this tool, radars and observations. You can still add other data through the other tools like trajectories and RPN fields

Observations

Through this tab, you can display BURP observation data. You add a type of observation with the plus menu button. Once a new kind of observations is added, select it to configure it for display. The first element found in the observation files is automatically displayed.

The displaying is done through a point model which allows displaying many values for a single station. At the bottom of the interface is a grid position selector for the values, the middle one being centered on the station. Select the location where you wish to put a value and pick this value from the element section.

For vectorial values, like winds, you may enter the speed in the «variable 0» item and direction in «variable 1». This will allow the rendering of arrows or barbs, otherwise, only select the «variable 0» item. The topography item can be used to specify which element to use for elevation instead of the station’s height. This is mainly use to

SMC/CMC/CMOE 55

Version 7.2.3-a (Thursday, June 14, 2007)

Page 56: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

display profiler or radiosonde data in 3D. You can also change the spacing, specified in pixels, between the model’s elements. The projected button is used to select the rendering mode. Projected means that the values are mapped flat on the projection (like flattened on the ground), meaning that panning in 3D will pan the elements as well, otherwise, they are mapped flat to the viewer, they always appear straight.

Once an element is selected, you can use the observation parameters window «F9» to configure the way it is rendered. Many options are available, with or without icon, wind bards or arrows, colormap, text value, coordinates or station identification, etc…

All of these model and rendering configuration can be saved by entering a name in the «model» entry and clicking on the save button. Every saved model will later be available through this box.

By using the selection mode, you can left click on a station in any viewport and get a report of all the elements values available for the station. By using the middle button you can drag an element which will be tied with a location line. This can be useful to move some element form a crowded location. This displacement will be kept even when zooming en panning.

To find a particular station, make sure the right observation type is selected and enter it’s identificator in the «find station» entry. The viewport will automatically center itself on the station if it exists.

Radar

Radar data can be added in two ways. You can select a radar site within de list of available sites in the plus menu button or you can display the radar footprints with the second top button and use the selection mode to click in the desired radar footprint.

Once a radar site is added, you can configure which scan to visualize as well as which vertical sweep angle from the spinbox. Some entries cannot be changed but are there for information purposes.

Radar data has the same rendering functionalities as RPN standard file data. You actually use the same configuration window parameter to the rendering specification. You can use contour intervals, colormap, labels, highs and lows and even 3D iso-surface volume rendering.

Being treated this way means that you can also use all of the graphs on radar data, to create profiles or cross-sections.

SMC/CMC/CMOE 56

Version 7.2.3-a (Thursday, June 14, 2007)

Page 57: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

You can also add range circles at specific intervals to display distance relationship form the radar location. When using volume rendering, the range circles will become elevated planes that cur through the radar volume.

Tools: GraphsThere are currently five types of graphs, time series, vertical profiles, cross sections, time based profiles, scatter plots, contingency diagrams and comparison graphs, but it will be expanded in the near future.

Of all the graphs that can be added to a page, only one will be the active one. As for the viewports, this will be the one with the red manipulation icons. Clicking within a graph will make it the active one. The graph parameter pane contains the parameters of the active graph.

A new graph will inherit the size of the lastly added graph.This allows for the creation of equal size graphs.

All of theses graphs take their information from a viewport which they have to be linked to. Linking a graph to a viewport is done by using the selection mode of the specific graph and clicking into a viewport to select some information. Selecting in another viewport will change the link to the newly selected viewport.

It might be easier to get around if you use a page layout with only one viewport when working with the graph at first since it may be confusing.

The linking is dynamic. This means that if the vewport’s data changes, the graphs linked to it will be automatically be updated.

Animating a viewport will consequently anime the graphs linked to it.

The selection mode is activated by using the lower left button, of the graph parameter pane. This mode will be different from graph to graph and is described later but it is basically use to get information to put into the graph. Whenever the selection mode is used for single location selection, the «Location» tool can be used as well.

Beside the selection mode icon is a reset button which will reset the zoom and refresh the graph. The last button allows to see the actual data numbers that have been used to generate the graph and to save them if you want in a text file.

When moving the mouse pointer within a graph, the coordinates and values corresponding will be shown in the coordinates and value field of the information bar of the main windows.

Each of theses graphs contains titles, scale unit and item descriptor which can be edited. Just click on them to change them.

SMC/CMC/CMOE 57

Version 7.2.3-a (Thursday, June 14, 2007)

Page 58: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Some standard parameters can be changed from font selection of units, header and footer to color of the text and graph contour and background. You can also change the font and color of the selection item within the linked viewports.

Vertical cross section

A vertical cross section is a cut through a 3D field along a specified path.

To create a vertical cross section, add a graph to a page and use the selection mode and the left mouse button once into a viewport with a field assigned to it to get the start point of your cross-section and then click again to add segments. You can add many segments using this method and will see them clearly indicated in the graph. Use the middle mouse button to remove a segment and backup within the path.

Once the start point is selected you can scan through the field by holding the left mouse button on moving through the viewport.

If more than one field is assigned to the viewport which you want to link to, multiple cross-sections will be superimposed in your graph. You might have to change the transparency, texturing or contouring to be able to see them all.

By using the display option you can also display them in 3D in the viewport where you will be able to animate them. You will obviously need to increase the elevation factor in the geographic parameters and use the camera mode to flip the view to see them.

The graph parameter pane options allow you to change the resolution on the sampling interval. It defaults to AUTO which will depend on the data resolution but you can fix it to some specific interval.

By using the field parameters, you can select the intervals, colormap, interpolation, etc... applied to your cross sections.

Moving the mouse cursor within the graph will display the value, the elevation and the grid coordinate along the cross section, in SPI’s information fields.

SMC/CMC/CMOE 58

Version 7.2.3-a (Thursday, June 14, 2007)

Page 59: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Time profile

A time profile is like a cross section but over time, a vertical profile taken at every time step.

To create a time profile, add a graph to a page and use the «Location» tool or the selection mode to pickup a location within a viewport.

Holding the left mouse button while selecting a location in the viewport will allow you to scan through the field.

If more than one field is assigned to the viewport which you want to link to, multiple time profiles will be superimposed in your graph. You might have to change the transparency, texturing or contouring to be able to see them all.

By using the field parameters, you can select the intervals, colormap, interpolation, etc... applied to your cross sections.

Moving the mouse cursor within the graph will display the value, the elevation and the date SPI’s information fields.

The IP3 validation option disables the IP3 comparison checking while parsing the data to get every time step.

The date parameter displays the full date instead of the time elapse since the beginning in the temporal scale.

SMC/CMC/CMOE 59

Version 7.2.3-a (Thursday, June 14, 2007)

Page 60: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Vertical profile

Vertical profiles are used to draw graphs of values in the vertical at specific locations.

To create a vertical profile, add a graph to a page and use the «Location» tool or the selection mode to pickup a location within a viewport. Once you select a location, its name will appear in the graph as well as its curbs and its parameters. To get rid of a location, click on its corresponding delete button. To change the field, just select another one.

Holding the left mouse button while selecting a location in the viewport will allow you to scan through the field.

You can select multiple locations to get multiple curves in a single graph and can select multiple fields as well. In theses case, the color will indicate the location and the stippling the field.

When selecting location with the mouse, you will notice that the location name will be «MousePoint». Just change that name to pickup another location.

You can alternatively use observations if you have an observation file opened. Selecting and observation in the «ObsBox» will insert the location in the observation list box. Selecting a location will display a profile of the value of the observation and a profile of the field at this specific location.

You will also see a value associated with the localisation. This value default to the total under the curve but you can change it to the minimum, maximum or average.

Moving the mouse cursor within the graph will interactively display the specific value and level in the information bar at the bottom of the interface.

The value scaling is automatically calculated and defaults to linear. You can change that to logarithmic and even select the specific levels that you wish.

SMC/CMC/CMOE 60

Version 7.2.3-a (Thursday, June 14, 2007)

Page 61: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Time Series

Times series are used to draw graphs of values over time at specific locations.

To create a time series, add a graph to a page and use the «Location» tool or the selection mode to pickup a location within a viewport. Once you select a location, its name will appear in the graph as well as its curbs and its parameters. To get rid of a location, click on its corresponding delete button. To change the field, just select another one.

Holding the left mouse button while selecting a location in the viewport will allow you to scan through the field.

You can select multiple locations to get multiple curves in a single graph and can select multiple fields as well. In theses case, the color will indicate the location and the stippling the field.

When selecting location with the mouse, you will notice that the location name will be «MousePoint». Just change that name to pickup another location.

You can alternatively use observations if you have an observation file opened. Selecting and observation in the «ObsBox» will insert the location in the observation list box. Selecting a location will display a time serie of the value of the observation and a time serie of the field value at this specific location.

You will also see a value associated with the localisation. This value default to the total under the curve but you can change it to the minimum, maximum or average over time.

Selecting vectorial fields will add a series of arrows on the lower scale indicating the wind direction using top as north. In this case, the curve will indicate speed.

Moving the mouse cursor within the graph will interactively display the specific value and date in the information bar at the bottom of the interface.

The value scaling is automatically calculated and defaults to logarithmic. You can change that to linear and even select the specific levels that you wish.

SMC/CMC/CMOE 61

Version 7.2.3-a (Thursday, June 14, 2007)

Page 62: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Scatter plot

Scatter plot can be used to compare two data sets, either fields or observations.

To create a scatter plot, add a graph to a page and use the selection mode and the left mouse button once into a viewport with some data assigned to it to link it to the graph.

You can use the selection mode to select an area of interest on the viewport. This will update the graph with only the selected range of information.

The graph scales can be specified as the same for both axis (Uniform) or different and default to the maximum range of the data displayed. You can specify intervals for both axes in the same way explained for the field parameters. You can also choose between a logarithmic or linear scaling.

Some interesting statistics can be displayed by clicking on the statistics button, among which the correlation factor, the regression coefficients, the slope, root mean square, etc … Those statistics can each be enabled or disabled with the statistic options which will pop-up if you click within the statistic rectangle.

SMC/CMC/CMOE 62

Version 7.2.3-a (Thursday, June 14, 2007)

Page 63: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Contingency diagram

Contingency graphs can be used to compare two data sets, either fields or observations, in specific ranges and get some validity statistics.

To create a contingency graph, add a graph to a page and use the selection mode and the left mouse button once into a viewport with some data assigned to it to link it to the graph.

Each cell will contain the number of item within the specified range with total on both sides. Some graph evaluation statistics are also calculated per columns and for the whole graph only if the graph is uniform (same number of columns and rows).

You can use the selection mode to select an area of interest on the viewport. This will update the graph with only the selected range of information.

By selecting a specific cell you can pinpoint the included locations on the viewport. They will be indicated by black arrows pointing at them.

The graph scales can be specified as the same for both axis (Uniform) or different. You can specify intervals for both axes in the same way explained for the field parameters.

SMC/CMC/CMOE 63

Version 7.2.3-a (Thursday, June 14, 2007)

Page 64: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Tools: Satellite DataThis tool can be used to extract data from GOES-E and GOES-W for a specific domain into standard files. This obviously won’t work if you do not have access to HDF formatted data to extract from.

The interface is divided into specific parts related to the different operations needed for the process. You should go through them orderly.

Domain

This will let you select a previously saved domain or save a specific domain as well as change the domain resolution.

File

Specify the standard file to where the data will be extracted.

Data

This is where you can select which data to extract from which satellite. Selecting channel 4 and 5 for the same hours will automatically calculate a 4 minus 5 channels.

Selecting one of the satellites offered will show the viewing area of the said satellite over the active projection. This can be used to make sure that the selected domain is within the range of the wanted satellite. Note that depending on the hour and conditions, this area could be smaller than shown.

You can also specify a path to other data files, not located in the standard path using the «Other files» pane.

Actions

Once everything is fine you can press «Extract» to launch the extraction process or «Close» if you want to cancel everything and/or close the tool.

Domain selection can also be made interactively by clicking on the selection button in the lower left part of the interface. Once this button is activated, you can use the left button to draw a domain into any projection and the middle button to move this domain around. Not that the size of this domain will be limited by the resolution. Increase the resolution if the domain is too small for your needs.

SMC/CMC/CMOE 64

Version 7.2.3-a (Thursday, June 14, 2007)

Page 65: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Tools: MetDataThe MetData tool is used to retrieve observation information from the meteorological stations. It is only an information tool and will not allow you to display any of this information within the viewports yet nor will it do any decoding of the information.

On start-up, you will only have an empty window with the list of meteorological data types and available dates filled.

The first step is to select a range on the projection by using the selection mode button on the lower left of the tool interface and to draw a rectangle on any projection with the left button. This will start the station extraction for this range. The stations icon should appear on the active viewport and their identification will be included within the station list of the tool.

By left clicking on an icon or selecting from the station list, you will be able to retrieve information for that station from the data type produced and the selected date.

An interesting functionality added to this tool is the exportation of the information for HPAC. When selected, a new dialog will appear in which you can select which type of data to export as well as for which station and from which files.

Just select the convert option to export the selected information to an HPAC compatible format.

SMC/CMC/CMOE 65

Version 7.2.3-a (Thursday, June 14, 2007)

Page 66: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Tools: Message WriterThis tool is used to write standard messages to be transmitted over specific channels.

Restrictions apply for the transmission of these products

Every message type has a very strict format which is reflected within the layout of the message pane.

Generally speaking, grey fields are fields that you need to fill with information while icons allow you to use predefined values for those fields.

For certain type of message (FVCN), it can be necessary to use the selection mode to gather needed specific information. For those specific cases click on the selection button on the lower left part of the interface and select the needed information into any viewport.

When starting this tool, the message pane will be empty. Use the «File» menu to create a new message, open an existing one or send the selected one if allowed. Once you create or open a message, it will be displayed in the message pane. You can open/create multiple messages and navigate through them using the tabs.

The tabs will all have a specific token identifying their state. You can use the «Edition» menu to change their state when allowed.

Here is the description of the different status:

NEW (New message)

This is the status you will get by creating a new message.

REA (Read only mode)

Typically this is an existing message that has been opened for consultation. You can change this state to «COR» or «UPD» for correction or update purposes. You cannot transmit a message with this status.

SMC/CMC/CMOE 66

Version 7.2.3-a (Thursday, June 14, 2007)

Page 67: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

COR (Correction mode)

This mode is used to do corrections to a previously sent message. You will also see a «COR» token added to the message header.

UPD (Update mode)

This mode is used to update a previously sent message. While working as the correction mode, this mode is used to add more information instead of changing previously wrong information..

Sending a message will automatically save the message and switch the mode token to «REA», read only mode.

SMC/CMC/CMOE 67

Version 7.2.3-a (Thursday, June 14, 2007)

Page 68: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Tools: LocationThe location tool allows for search and retrieval of location information. This tool can be used for information only or in conjunction with other tools for specific coordinate selection. Selecting a location from it will send the selected information to all the opened tools which will use it as they see fit, depending on their functionality. Selecting a source will display it in the projection.

You can use the selection mode of this tool to select a range of coordinates from which to extract locations. All of the sources included in this range will the be shown on the projection

This tool also allows exportation of location lists to the icon file format (See Annexe : File format (Icon)) through the file menu.

The location tool contains lists of the world volcanoes, nuclear stations, CTBT sites, meteorological stations as well as an exhaustive list of cities. Those different location types can be selected using the icon buttons on the top right.

Restriction fields using regular expressions are also available for the number, name and area so as to be able to search the lists. The column headers can be used to sort the lists accordingly.

The bottom part of the interface displays the selection type end the number of locations within the selected list.

Selection is taken into account as soon as they are selected with the left mouse button. The close button will only close the tool and is not used to activate your selection.

SMC/CMC/CMOE 68

Version 7.2.3-a (Thursday, June 14, 2007)

Page 69: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Tools: MacroThe macro tool is used to execute macro script. It will contain the list of available macro previously loaded into the application and by double-clicking on them, you can trigger their execution.

The top part lists the available macro. Just double click on one to execute it.

The bottom part is the editor. It’s very basic but allows you to make quick changes directly within SPI and have an immediate look at a macro’s code.

Macros are small user made Tcl scripts used to implement specific and useful processing. They can also be called at startup by using the «-script» token followed by the name of the macro.

It is recommended to use the Macro functionalities over general script for every scripting you wish to implement. The Macros are a bit more restrictive but they force standardisation among the scripts while allowing full functionalities and better integration and safety with the SPI application.

Macros have to define some specific functions hence it is recommended to use the macro interface to create a new macro since it will create an empty shell with the following needed functions for you.

When writing a macro, a user must follow the following guidelines.

Use the macro namespace. SPI knows about the existing macros by looking at the namespaces within the macro namespace

namespace eval Macro::MyMacro { }

This macro will be named «MyMacro» in the SPI Macro tool interface

Define at least the execution and cleaning procedures. SPI does some check on the macros and If those two functions do not exist, an error message will appear at load time. Other than that, you can add as many procedures as you wish as long as they are created within the specific macro namespace.

proc Macro::MyMacro::Execute { }

Called when you click on the macro, this is you entry point.

proc Macro::MyMacro::Clean { }

SMC/CMC/CMOE 69

Version 7.2.3-a (Thursday, June 14, 2007)

Page 70: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Called when cleaning is needed. Free up whatever resources you used.For error reporting and information , use the built-in macro functions :

Macro::Error { Error } For reporting error.Macro::Info { Msg } For reporting information.

Macro::Doing { Process } To indicate the job in progress in the task bar.

You can also set the cursor globally by using the following function

Macro::Cursor { Cursor }

SMC/CMC/CMOE 70

Version 7.2.3-a (Thursday, June 14, 2007)

Page 71: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Tools: File managerThe file manager as it name implies can be used to manage files but do it over a network on remote hosts. It is a tool which is independent from other SPI’s functionalities but has been included in this release because of it’s usefulness in many cases.

You can open multiple hosts and look at the files on theses remote hosts. Many functions are available through the context menu among which the cut/copy/paste of files between hosts, the possibility of creating directories, erasing files, changing ownership and permissions as well as getting the statistics on the remote files.

It uses the remote shell protocol to access the remote machines so you obviously have to be known in some way by the remote host to access it.

Through this tool, you can open standard files remotely. Just right click on the RPN standard file and select the “fstd open” option.

SMC/CMC/CMOE 71

Version 7.2.3-a (Thursday, June 14, 2007)

Page 72: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Tools: ConsoleThe console tool can be used to access the Tcl interpreter within SPI. You can type in Tcl command and try out things. It is mostly used by advanced user to edit specifics within SPI, debug or patch the application while it is running.

Warning: Know what you do if using this tool since you can change the application’s code while it is running.

SMC/CMC/CMOE 72

Version 7.2.3-a (Thursday, June 14, 2007)

Page 73: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Parameters: GeographyThe geographic parameters are those related to any geographical kind of data that can be layered within projections. All the data available is multi-resolution which means that as you zoom in, more detail will appear.

Projection

Selection of the projection type. Six projections are now available, orthographic cylindric, mercator, azimuthal equidistant, azimuthal equal-area and grid type, which will be taken from the first field data from the first viewport within the page or could be set from a data in the Mapper tool.

Raster

Selection of the kind of raster data to apply. This allows you to select topography and/or bathymetry as well as the texture scheme to apply to them and a land/sea mask where other data will not be displayed.

Sun

Activating the sun will light the viewport like it should be by the sun at the current date. By using the hour scrollbar you can scroll through a full 24 hour. When this is activated, time animation will set the sun position as well. Note that not all kind of data will react to this kind of light correctly or at all. Use the geography topography and/or texture to view it correctly.

Font

Selection of the font which will be used for writing inside the viewport, namely to coordinates.

Vectorial

This is where you can enable the various kinds of vectorial data as well as select the color and width of specific data segments. Selecting no width will deactivate the related data type. Notice the «LatLon» sub-menu «...» where you can specify more formatting options like numbering, intervals and types.

Elevation

SMC/CMC/CMOE 73

Version 7.2.3-a (Thursday, June 14, 2007)

Page 74: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

This is a multiplicative factor applied to the elevation of everything display within the viewport. Use it to exaggerate the elevation of objects so as to be able to differentiate levels.

Parameters: FieldThe field parameters apply to RPN standard field. They allow specification of the visualisation format of the fields as well as the format of the value displayed.

Options are specified for groups of field and are remembered throughout an execution.

Field intervals and factor are read form the .recrc file in you home directory. If you wish to add default values for specific files, you will have to edit this file.

Field

This is where you specify which group parameters you want to modify. The «VAR» item lets you choose which grouping method to use (VAR, IP1, IP3, DATEV, ETICKET or IDX) and the following field is used to choose the group itself. The groups included in this list will only be the ones currently selected or displayed.

Selecting a group will show its parameters. You can modify parameters for multiple groups before applying the changes. The grouping parameters will be remembered throughout the execution.

Data

The data group include the selection of the interpolation method and the value formatting. Value formatting is used to specify how the values will be displayed that is as integers, floats, exponents or let the application select the format itself. You can also specify how many decimals you want to see. This formatting will be used for central values, labels, value extraction, etc... The «Var 3D» let’s you select which field to use for the third dimension. It defaults to GZ but you could use any other variable. The factor is a multiplicative factor applied to the data. You can use the units field to specify the units of the field to display in the colorbar and other locations

Colormap

Click on the colorbar to select a different colormap or manipulate the current one. Different colormap can be assigned to different fields.

Display

SMC/CMC/CMOE 74

Version 7.2.3-a (Thursday, June 14, 2007)

Page 75: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

This group of parameters allows you to specify the rendering format of the field and the kind of information you want to see about the field. The first three items are the color of the vectorial data like contours, grid point, vectors, the colormap vectorial mapping and the segment type of the contours when displayed.

For the following parameters, keep in mind that selecting no width or size will disable the rendering of the specific kind of data.

Contour

Selection of the width of the contour segments. No contour will be displayed if no intervals are specified.

Grid

Selection of the grid point size. This only applies to gridded fields.

Vector

Select the kind of vectorial rendering, either with arrows, meteorological wind specification or streamlines. This only applies to vectorial fields.

Particle

Select the size of the particles. This only applies to particle fields.

Labels

Activates the rendering of labels on the contours. The higher the number, the more labels will be placed on the contours.

Values

Select central values or minimum and maximum points.

Volume

Selection of the volume rendering mode. When this is activated, all the levels for the specific field will be read and a volume following the specified interval(s) will be created and rendered. You can use the colormap transparency (Alpha channel) to view multiple contours within each other.

Texture

Select the rendering of the coloring scheme of the field.

SMC/CMC/CMOE 75

Version 7.2.3-a (Thursday, June 14, 2007)

Page 76: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Intervals

This is where you can specify intervals. Predefined intervals can be accessed through the combo box or you can type in specific intervals from lowest to highest. The number formatting accepted is very loose and only need to be separated by spaces. You can also specify a range of values.

Examples:

1e-10 1e-8 1e-41.32e2 234.466 300[10 100]

The menu allows you to select intervals through different method.

Intervals

Select predefined intervals

Linear

Select how many intervals defined linearly from the field minimum to the field maximum.

Logarithmic

Creates logarithmic intervals from the minimum

RSMC

Specific to the RSMC standard

NONE

No intervals will be specified. Use this option to clear the intervals specified

SMC/CMC/CMOE 76

Version 7.2.3-a (Thursday, June 14, 2007)

Page 77: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Parameters: TrajectoryThe trajectory parameters allow you to specify particle and segment format of trajectory data which will apply in the projections and graphs.

You can specify parameters either by levels, by parcel or all the same.

Icon

Select the icon.

Color

Select the color.

Style

Select the path style, 2 or 3 dimension, filled, shadow, etc.

Dimension

Select the particle’s icon radius dimension in pixels.

Fill

Selection of the filling mode. You can select to fill all the icons, empty them all or fill only at day change, that is at 00Z. This last option is useful to quickly see the particle evolution in time.

Width

Selection of the segment width in pixels.

Speed

Enables the display of particle speed in the graphs.

Interval

Selection of the display time interval. Sometime there are too many hours of data to fit in a graph. Use this option to display every 3, 6, 12 or 24 hour data. Note that this will not affect the drawing of the path on the projections. The Path will still follow all date/time locations. It will only lower the icon number.

SMC/CMC/CMOE 77

Version 7.2.3-a (Thursday, June 14, 2007)

Page 78: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Parameters: ObservationThe observation parameter allow specification of the visualisation as well as the format of the value displayed.

Options are specified for groups of observation and are remembered throughout an execution.

Observations

This is where you specify which group parameters you want to modify. Selecting a group will show its parameters. You can modify parameters for multiple groups before applying the changes. The grouping parameters will be remembered throughout the execution.

Data

The data group include the selection of the interpolation method and the value formatting. Value formatting is used to specify how the values will be displayed that is as integers, floats, exponents or let the application select the format itself. You can also specify how many decimals you want to see. This formatting will be used for central values, labels, value extraction, etc... The factor is a multiplicative factor applied to the data. You can use the units field to specify the units of the field to display in the colorbar and other locations

Colormap

Click on the colorbar to select a different colormap or manipulate the current one. Different colormap can be assigned to different fields.

Size

Select the dimension of the icon of wind arrows and barbs in pixel.

Display

This group of parameters allows you to specify the rendering format of the observation and the kind of information you want to see about the it.

Icon

Selection of the icon.

SMC/CMC/CMOE 78

Version 7.2.3-a (Thursday, June 14, 2007)

Page 79: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Color

Selection of the vectorial information color.

Outline

Selection of the contour size of the icon.

Vector

Select the kind of vectorial rendering, either with arrows, meteorological wind specification or streamlines. This only applies to vectorial data.

Texture

Apply the colormap coloring scheme of the observation.

Volume

Selection of the volume rendering mode. When this is activated, the observation will be extruded by its value.

Value

Displays the value beside the position.

Info

Displays the information beside the.

Coord

Displays the coordinates beside the position.

Intervals

This is where you can specify intervals. Predefined intervals can be accessed through the combo box or you can type in specific intervals from lowest to highest. The number formatting accepted is very loose and only need to be separated by spaces. You can also specify a range of values. Just remember to specify them from lowest to highest.

Examples:

1e-10 1e-8 1e-4

1.32e2 234.466 300

SMC/CMC/CMOE 79

Version 7.2.3-a (Thursday, June 14, 2007)

Page 80: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

[10 100]

The menu allows you to select intervals through different method.

Intervals

Select predefined intervals

Linear

Select how many intervals defined linearly from the field minimum to the field maximum.

Logarithmic

Creates logarithmic intervals from the minimum

RSMC

Specific to the RSMC standard

NONE

No intervals will be specified. Use this option to clear the intervals specified

SMC/CMC/CMOE 80

Version 7.2.3-a (Thursday, June 14, 2007)

Page 81: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Parameters: OpenGLThe parameters in this panel are related to the rendering engine and you should not have to modify anything. Please note that changing these parameters will not change the aspect of printouts.

Information

You can obtain information about the rendering engine through this item. Pull down the list and select the item about which you want to know something. For example, by looking ate the GL_RENDERER, you can see if you are using the graphic hardware or the software MESA implementation.

Ressources

This item shows the current resources needed and rendering performance of the application. Note that the memory usage item does not work under Linux.

Parametres

Anti aliasing

Enable or disable anti-aliasing which allows lines and points to look nicer. This is not necessary if FSAA (Full Scene Anti-Aliasing) is activated. For NVIDIA card, FSAA is enabled through the environment variable __GL_FSAA_MODE and it is set by default in the file $HOME/.eer_ToolDefs/.eer_Defs-7.2.3.

Debug

Enable debug mode. This has various effects on the rendering stage and activates debug messages.

Back buffering refresh

This enables the copy of the back buffer for the refresh. If not enabled, the rendering will be redone when any window obscures the pages, otherwise it will be made from the last rendered buffer copy.

Depth coherence (ZBuffer)

Enable or disable depth buffering. Use it to activate depth consistency. By default, 3D information does not interact with geographical data. If you enable this, topography might obscure some 3D information.

SMC/CMC/CMOE 81

Version 7.2.3-a (Thursday, June 14, 2007)

Page 82: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Low resolution interactivity

When scrolling or rotating the viewports, overlaid data is not displayed. If you want to keep the data while zooming, panning and moving, disable this option. This option should be disabled if the frame rate gets to slow.

SMC/CMC/CMOE 82

Version 7.2.3-a (Thursday, June 14, 2007)

Page 83: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Dialogs: OptionsSome other general parameter selection dialogs are available. Here is a brief description of each of them:

MapBox

This will allow you to change the colormap associated with an item. It contains two tabs.

The first one is used to modify the current color scheme by using the color distribution curve, the minimum and maximum. You can also adjust the color component ratios and the alpha channel ratio to produce transparency effects.

The second part contains a list of predefined colormaps from which you can choose or save you current colormap definition and allows you to modify the colormap control points so as to create a completely new colormap.

The bottom left button can be used to activate the immediate mode. In this mode, any change made to the colormap will be immediately reflected in the projection but be advised that on slower system this might not be a good idea.

ColorBox

This dialog is the standard color selector. You can select colors based on RGB(A) or HSV color components. You can either enter the numbers directly, manipulate the scrollbars interactively or directly select within the colormap, anyway will work. You can also see the hexadecimal specification of the selected color.

FontBox

This dialog allows for font selection and preview. Be advised that some fancy font may not be available to the postscript generation when printing out the page as this is the case for underlining and over striking.

SMC/CMC/CMOE 83

Version 7.2.3-a (Thursday, June 14, 2007)

Page 84: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Dialogs: DataBoxThere is three different data box which work in the same way but contains different kind of data. There is the «TrajBox» for trajectorie, the «FieldBox» for RPN standard file and the «ObsBox» for observations.

Those dialog manage the opened data files. Many files can be opened within the same box and many box can also be displayed with each many files in them.

Information bubbles show up under the mouse cursor to get immediate information about the data fields.

The dialog contains the following items:

Headers

The headers are used as column descriptors but also for list restriction. By clicking on a header, you can select which information you want to be part of the list. To close the restriction list, just re-click on the header or select another one to continue restriction of the list. The last header button ( ) is used to cancel restrictions and display all available data in the list. If a header is disabled this means that there is no restriction possible for this column since it is all the same.

Data list

Here will be listed all the data satisfying the restriction specified with the headers. You can select a field by double clicking on it or select multiple by using «shift» for list selection or «control» for single selection followed by the refresh button to activate your selection.

Command bar

This includes the management functions of the dialog.

Refresh button

This button can be used to activate your selection. The refresh will take into account the selection of data within all the same data box and update all the items related to this kind of data within the page or other tools.

SMC/CMC/CMOE 84

Version 7.2.3-a (Thursday, June 14, 2007)

Page 85: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Menu

This menu is where you can open up more data box and open or close data files.

File list

This item contains a list of all the files open within this data box. You can then select to view or close just a single file or all the files. Note that file closing operations apply to the file(s) selected.

Indicator

This indicator shows how many data fields are currently displayed in the list over the total number of data fields opened.

Contextual menu

This is a menu that you can access by right clicking within the data field list. It allows you to activate or not the information bubbles and to clear the selection or select everything. It also includes a copy function to copy the selected fields to another and a parameter option to display the extended parameters of the fields.

SMC/CMC/CMOE 85

Version 7.2.3-a (Thursday, June 14, 2007)

Page 86: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Dialogs: PrintBoxThe «PrintBox» takes care of producing outputs. It can either print to a printer or generate an image file. Note that SPI only generates PostScript and PPM. Image format are converted using a converter (ImageMagik) and it is usually the longest part of the process.

Some tools or layout can append some functionality to this interface, depending on their needs. If so, you will see theses new options under the tab list.

The «PrintBox» is divided into two parts:

Print

Here you can select the printer you wish to use from the list, the page size and orientation.

Save

To save to an image file, you will have to select the file location and the type of image

SMC/CMC/CMOE 86

Version 7.2.3-a (Thursday, June 14, 2007)

Page 87: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Dialogs: FileBoxThe «FileBox» allows you to parse directory trees to find directories or files to read or where to save. It contains plenty of functions to help you navigate efficiently the sometimes very vast file systems

The first bar is the directory selection. You can type in the directory you wish or select a previously saved one in the favourite directory list combo box. You can use the rightmost button to save or delete favourite directories. The last button contains a directory trace which allows you to backtrack in the directory tree.

The second bar is the file selection bar, it contains the name of the selected files. The button on the right allows to view hidden files while the entry beside it allows you to enter a search pattern.

Next is the file type. Here you can select the file type you are looking for from the specific list.

The last but not the least is the parsing tree. This is where you can select files and navigate through the directories. You can select multiple files, if allowed, by using «shift» for list selection or «control» for single selection.

You then click on «Ok» when your file selection is done or «Cancel» to return without selecting anything.

A contextual menu is available if you right click within the file selection area with the option of deleting the selected files or creating a new directory.

SMC/CMC/CMOE 87

Version 7.2.3-a (Thursday, June 14, 2007)

Page 88: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Annexe: File format (Icon)The icon files are used to display specific locations on the map using icons. For example, you could use this type of file to import and display cities in an area that are subject to a dosage field that you would superimpose. No values are associated with theses. Use the «Observation» files if you need to uses values at locations.

This file contains positioning information as well as displaying information. It needs a header 4 line long and the list of localisations.

The first line of the header is a file version descriptor indicating the data type and version number.

IconList 3.0

The second line identifies the icon group. this will be used by SPI to enable and disable this group of icon

The third line is the color to be used to display those icons. It can be plain text or alphanumerical RGB triplet. Leave it empty if you intend to use an image (GIF) as an icon on the next line

Blue or #0000FFRed or #FF0000

The fourth line indicates the path to a bitmap (XBM) of image (GIF) file to be used to display those icons.

../data/resources/bitmap.xbm

The rest of the file contains one line per entry or icon in which you specify the identification within « », the latitude, the longitude and the elevation in meters

Example:

IconList3.0Nucleaireblue/software/cmc/eer_Lib-7.1/Resources/nucleaire.xbm"BRUCE-1" 44.33 -81.6 0"DARLINGTON-1" 43.88 -78.75 0"DOUGLAS POINT" 44.33 -81.6 0"GENTILLY-1" 46.40 -72.32 0"PICKERING-1" 43.82 -79.07 0"NPD" 46.20 -77.7 0"POINT LEPREAU" 45.07 -66.45 0

SMC/CMC/CMOE 88

Version 7.2.3-a (Thursday, June 14, 2007)

Page 89: Introduction - Environment and Climate Change Canadaeer.cmc.ec.gc.ca/s_software/spi/documentation/docs/SPI-7... · Web viewFree camera movement allowing specific view angles. Possibility

Annexe: File format (Observation)This file contains information about localisations and values in these that the user wants to display, compare and analyse. It also contains a header that will inform SPI of the content of the columns. When an item in one column contains spaces, it should be put within « » since SPI uses spaces to parse the columns

The first line is a file version descriptor indicating the data type and version number.

Obs 3.1

The second line is just a string describing the data. It will be used by SPI to create an information identification.

bla bla bla

The third line is the information columns headers. This header is used by SPI to differentiate information. Some of the following are mandatory while other are optional.

ID : Identification of the localisation (Mandatory)NO : Optional but reservedLAT : Latitude (Mandatory)LON : Longitude (Mandatory)ELEV : Optional but reservedELEVTYP : Optional but reservedDATA.*.* : Values identification (Mandatory ) (Format: DATA.name.date)** : Anything else you want to put (Optionnal)

Example:

Obs 3.1This is a list of a few citiesID LAT LON DUR DATA.WI.19950810 DATA.DD.19950811

"TOULAN SEYNE" 43.11 5.91 6 3373.00 613.57CHARLEVILLE 49.13 4.11 4 14.25 3.06ORSAY 49.11 2.03 4 10.20 7.07NICE 43.70 7.25 2 1215.00 900.50CADARACHE 43.68 5.70 2 1055.00 2380.00

SMC/CMC/CMOE 89

Version 7.2.3-a (Thursday, June 14, 2007)