Viz Weather Guide Old Version PDF

You might also like

Download as pdf or txt
Download as pdf or txt
You are on page 1of 289

Viz Weather

User’s Guide
Product Version 2.4
November 25, 2013
Copyright © 2013 Vizrt. All rights reserved.

No part of this software, documentation or publication may be reproduced,


transcribed, stored in a retrieval system, translated into any language, computer
language, or transmitted in any form or by any means, electronically,
mechanically, magnetically, optically, chemically, photocopied, manually, or
otherwise, without prior written permission from Vizrt.

Vizrt specifically retains title to all Vizrt software. This software is supplied under
a license agreement and may only be installed, used or copied in accordance to
that agreement.

Disclaimer

Vizrt provides this publication “as is” without warranty of any kind, either
expressed or implied.

This publication may contain technical inaccuracies or typographical errors. While


every precaution has been taken in the preparation of this document to ensure
that it contains accurate and up-to-date information, the publisher and author
assume no responsibility for errors or omissions. Nor is any liability assumed for
damages resulting from the use of the information contained in this document.

Vizrt’s policy is one of continual development, so the content of this document is


periodically subject to be modified without notice. These changes will be
incorporated in new editions of the publication. Vizrt may make improvements
and/or changes in the product(s) and/or the program(s) described in this
publication at any time.

Vizrt may have patents or pending patent applications covering subject matters in
this document. The furnishing of this document does not give you any license to
these patents.

Technical Support

For technical support and the latest news of upgrades, documentation, and
related products, visit the Vizrt web site at www.vizrt.com.

Last Updated

November 25, 2013

© Copyright Vizrt
Contents
1 Introduction .............................................................................................. 1
1.1 About the Document ..................................................................................1
1.1.1 Document Structure ........................................................................................... 1
1.1.2 Related Documents ............................................................................................ 2
1.1.3 Conventions ....................................................................................................... 2
1.2 Contact Vizrt ..............................................................................................2

2 Viz Weather............................................................................................... 3
2.1 System Overview ........................................................................................3
2.2 Workflow ....................................................................................................4

3 Installation ................................................................................................ 5
3.1 Viz Weather Setup Overview .......................................................................5
3.1.1 System Architecture ........................................................................................... 5
3.2 System Requirements .................................................................................8
3.2.1 Hardware Requirements ..................................................................................... 8
3.2.2 Software Requirements ...................................................................................... 9
3.3 Installing Viz Weather ...............................................................................10
3.3.1 Installing a Viz Weather Client Machine ............................................................ 11
3.3.2 Installing a Viz Weather Engine Machine ........................................................... 12
3.3.3 Installing a Viz Weather Data Hub .................................................................... 12
3.3.4 Installing the Database Schema ........................................................................ 12
3.3.5 Installing a Viz Weather Single Machine ............................................................ 15
3.3.6 Viz Weather Folder Structure ............................................................................ 15
3.4 Configuring Viz Weather ...........................................................................16
3.5 Upgrading Viz Weather .............................................................................20
3.5.1 Upgrading Viz Weather to Latest Version ......................................................... 21
3.5.2 Viz Weather Environment Conversion ............................................................... 22
3.5.3 Upgrade Notes for Version 1.X to 2.1 ............................................................... 22
3.5.4 Upgrade Notes for Version 2.x to 2.2 ............................................................... 24
3.5.5 Upgrade Notes for Version 2.2 to 2.3 ............................................................... 24
3.5.6 Shared Folders Configuration ........................................................................... 25
3.5.7 Providers Info Configuration ............................................................................ 26
3.5.8 Associating Providers With Data Types ............................................................. 29
3.6 Viz Weather Quick Start ............................................................................29

4 Viz Weather Data Configuration............................................................... 31


4.1 General Configuration ..............................................................................32
4.1.1 Shared Folders Configuration ........................................................................... 33
4.1.2 Providers Info Configuration ............................................................................ 34
4.1.3 Associating Providers With Data Types ............................................................. 37
4.2 Points Configuration ................................................................................37
4.2.1 Configuring a Point Type ................................................................................. 38
4.2.2 Adding a Data Field .......................................................................................... 40
4.2.3 Adding Forecasts ............................................................................................. 42
4.2.4 Adding Weather Points ..................................................................................... 43
4.2.5 Defining Regions ............................................................................................. 45
4.2.6 Forecast Types ................................................................................................. 46
4.2.7 Conversions ..................................................................................................... 47
4.2.8 Associating Point Types to Providers ................................................................ 48
4.2.9 Fetching Points ................................................................................................ 48
4.3 Data Configuration ...................................................................................49
4.3.1 Model Data Configuration ................................................................................ 50
4.3.2 Imagery Configuration - Radar and Satellite ..................................................... 52
4.3.3 Other Data Configuration ................................................................................. 54
4.4 Tools ........................................................................................................60
4.4.1 Utilities ............................................................................................................ 61
4.4.2 Active Sessions ................................................................................................ 63
4.4.3 DB Connection ................................................................................................. 64
4.5 Configuring a Demo Supplier ...................................................................65
4.5.1 Setting Up Storm as a Demo Provider ............................................................... 65
4.5.2 Setting Up Custom Weather as a Demo Provider ............................................... 66

5 Viz Weather System Configuration........................................................... 67


5.1 System Level Settings ...............................................................................67
5.1.1 Concepts and Folders ...................................................................................... 68
5.1.2 Playlist Defaults ............................................................................................... 69
5.1.3 Post and Snap .................................................................................................. 71
5.1.4 Playlist ............................................................................................................. 73
5.1.5 Calendar .......................................................................................................... 74
5.1.6 GPI/BBox ......................................................................................................... 75
5.1.7 VDCP ............................................................................................................... 76
5.1.8 MOS ................................................................................................................. 77
5.1.9 VCP Integration ................................................................................................ 78
5.1.10 Weather Data Hub ............................................................................................ 79
5.1.11 Media Engine ................................................................................................... 79
5.1.12 Miscellaneous .................................................................................................. 80
5.2 Application Level Settings .........................................................................81

6 Meteorological Data Visualization............................................................ 88


6.1 Weather Data Types ..................................................................................88
6.1.1 Weather Point .................................................................................................. 89
6.1.2 WGrid Point ...................................................................................................... 91
6.1.3 IsoTherms ........................................................................................................ 93
6.1.4 IsoPrecip .......................................................................................................... 93
6.1.5 IsoBars ............................................................................................................. 95
6.1.6 Winds .............................................................................................................. 95
6.1.7 Clouds Forecast ............................................................................................... 96
6.1.8 Extremes (or Highs and Lows) .......................................................................... 96
6.1.9 Flows ............................................................................................................... 97
6.1.10 Fronts ............................................................................................................. 97
6.1.11 Radar Data ....................................................................................................... 98
6.1.12 Satellite Images ................................................................................................ 99
6.1.13 Storm Tracking .............................................................................................. 100
6.1.14 Weather Special Objects ................................................................................. 101

7 Using Viz Weather ................................................................................. 102


7.1 User Interface Layout ..............................................................................102
7.1.1 Meteorology Data Area .................................................................................. 103
7.1.2 Editing Area ................................................................................................... 103
7.1.3 Animation Control Area ................................................................................. 103
7.1.4 Graphic Display Area ...................................................................................... 103
7.2 Main Menu .............................................................................................103
7.2.1 File ................................................................................................................ 104
7.2.2 View .............................................................................................................. 104
7.2.3 Settings ......................................................................................................... 111
7.2.4 Viz ................................................................................................................. 112
7.2.5 Data Element ................................................................................................. 114
7.2.6 Playlist ........................................................................................................... 116
7.2.7 Help ............................................................................................................... 117
7.3 Viz Tool Bar Options ..............................................................................118

8 Working with Meteorological Data ......................................................... 120


8.1 Points List ..............................................................................................120
8.2 Fetch ......................................................................................................125
8.2.1 Adding a new Fetch Profile ............................................................................. 125
8.2.2 Editing a Fetch Profile .................................................................................... 126
8.2.3 Deleting a Fetch Profile .................................................................................. 126
8.2.4 Setting a Fetch Profile .................................................................................... 126
8.2.5 Satellite Images .............................................................................................. 128
8.2.6 Model Data Forecast ...................................................................................... 130
8.2.7 Radar ............................................................................................................. 133
8.2.8 Points ............................................................................................................ 134
8.2.9 Misc Information ............................................................................................ 134
8.2.10 Clouds Forecast ............................................................................................. 134
8.2.11 Storm Path ..................................................................................................... 134
8.3 Points Data .............................................................................................135

9 Working with Graphics Templates ......................................................... 136

10 Working with Data Elements .................................................................. 139


10.1 Data Element Folders .............................................................................139
10.2 Saved Data Elements List ........................................................................139
10.3 Creating and Editing a Data Element .......................................................140
10.4 Data Editors ...........................................................................................142
10.4.1 Text Editor ..................................................................................................... 143
10.4.2 Weather Points Editor ..................................................................................... 145
10.4.3 WGrid Points Editor ........................................................................................ 149
10.4.4 Weather Points Filter Editor ............................................................................ 151
10.4.5 Fronts Editor .................................................................................................. 154
10.4.6 Model Data Editor .......................................................................................... 158
10.4.7 Satellite Editor ............................................................................................... 159
10.4.8 Map Editor ..................................................................................................... 160
10.4.9 Pressures Editor (Extremes) ............................................................................ 163
10.4.10 Images Editor ................................................................................................. 166
10.4.11 Radar Editor .................................................................................................. 168
10.4.12 Special Objects Editor .................................................................................... 169
10.4.13 Flows Editor ................................................................................................... 172
10.4.14 Clouds Editor ................................................................................................. 175
10.4.15 Winds Editor .................................................................................................. 176
10.4.16 Storm Path Editor ........................................................................................... 177
10.4.17 Hops Editor .................................................................................................... 179
10.4.18 Graffiti Editor ................................................................................................. 181
10.4.19 Time Range Editor ......................................................................................... 182
10.4.20 Animation Editor ............................................................................................ 183
10.4.21 Camera Selection Editor ................................................................................. 185
10.5 Debugging a Data Element .....................................................................185

11 Working with Playlists............................................................................ 187


11.1 Playlist Properties ...................................................................................191
11.1.1 General .......................................................................................................... 192
11.1.2 Layers ............................................................................................................ 196
11.1.3 Interactive ...................................................................................................... 198
11.1.4 Additional Info ............................................................................................... 199
11.2 Playlist Content Area ..............................................................................200
11.2.1 Context Menu ................................................................................................ 201
11.2.2 Columns ........................................................................................................ 207
11.3 Playlist Control .......................................................................................208
11.3.1 Using Concepts .............................................................................................. 209
11.3.2 Initialization ................................................................................................... 209
11.3.3 Running a Playlist .......................................................................................... 211
11.4 Exporting A Playlist ................................................................................212
11.5 Importing a Playlist ................................................................................212

12 Playout Mode ........................................................................................ 214

13 Fetch Application .................................................................................. 217


13.1 Main Menu .............................................................................................218
13.1.1 File ................................................................................................................ 218
13.1.2 View .............................................................................................................. 219
13.1.3 Settings ......................................................................................................... 219
13.1.4 Tools ............................................................................................................. 219
13.2 Points Data (Live), Fetch and Points ........................................................219
13.2.1 Points Data .................................................................................................... 220
13.2.2 Fetch ............................................................................................................. 221
13.2.3 Profile columns .............................................................................................. 221
13.2.4 Adding a new Fetch Profile ............................................................................. 222
13.2.5 Editing a Fetch Profile .................................................................................... 222
13.2.6 Deleting a Fetch Profile .................................................................................. 222
13.2.7 Setting a Fetch Profile .................................................................................... 223
13.2.8 Satellite Images .............................................................................................. 225
13.2.9 Model Data Forecast ...................................................................................... 228
13.2.10 Radar ............................................................................................................. 230
13.2.11 Points ............................................................................................................ 230
13.2.12 Misc Information ............................................................................................ 231
13.2.13 Clouds Forecast ............................................................................................. 231
13.2.14 Storm Path ..................................................................................................... 231
13.2.15 Points List ...................................................................................................... 232

14 External Commands .............................................................................. 234


14.1 Running Viz Weather Application Without the UI .....................................234
14.2 Commands List ......................................................................................235
14.3 Example XML ..........................................................................................242
14.4 Handler Parameters ................................................................................242

15 Appendix .............................................................................................. 244


15.1 Initialization File .....................................................................................244
15.2 Weather Data Suppliers ..........................................................................244
15.3 Using XML Formatted Data in Viz Weather ..............................................246
15.4 Working in Integrated Environments .......................................................248
15.5 Using Multiple Viz Weather Clients .........................................................249
15.5.1 Editing Playlists and Data Elements ................................................................ 250
15.5.2 Locked Playlist ............................................................................................... 250
15.6 Additional Columns ................................................................................251
15.7 Using VDCP to Control Weather ..............................................................251
15.7.1 VDCP Configuration ....................................................................................... 251
15.8 MOS Configuration with Avid iNEWS .......................................................252
15.8.1 iNEWS MOS Gateway Configuration ................................................................ 252
15.8.2 Viz Gateway Configuration ............................................................................. 255
15.8.3 iNEWS Client Configuration ............................................................................ 257
15.8.4 Pilot ActiveX Configuration ............................................................................ 259
15.9 Viz One Configuration ............................................................................261
15.9.1 Viz Engine Configuration ............................................................................... 261
15.9.2 Weather Control Machine Configuration ......................................................... 262
15.9.3 On the Viz One Server Side ............................................................................ 263

16 Troubleshooting Guide.......................................................................... 268


16.1 Meteorological Data ...............................................................................268
16.1.1 General .......................................................................................................... 268
16.1.2 Storm ............................................................................................................. 269
16.1.3 Custom Weather ............................................................................................ 270
16.2 Viz Weather ............................................................................................271
16.3 Viz Engine ..............................................................................................274
16.4 Mixed Environment ................................................................................275
16.5 DataBase Integrated Environment ...........................................................275
16.6 Graphic Display Issues ............................................................................276
16.6.1 No Images or Model Data Displayed ............................................................... 276
16.6.2 Performance Issues with ImageClip ................................................................ 276
1 Introduction
This is the user’s guide for Viz Weather version 2.4.

This section contains information on the following topics:

• About the Document


• Contact Vizrt

1.1 About the Document


This manual includes information for a wide range of users; from users with no
experience in using Viz Weather to experienced users and system administrators.
The purpose of this document is to help new users of Viz Weather become
familiar with the system and help experienced users utilize the system to its
maximum.

This section contains information on the following topics:

• Document Structure
• Related Documents
• Conventions

1.1.1 Document Structure


The Introduction and Viz Weather chapters introduce the manual and the Viz
Weather application and workflow.

The Installation chapter describes the software requirements and installation


procedures for Viz Weather and additional components.

The Viz Weather Data Configuration chapter describes how to configure and
administer the meteorological data and weather points database, using the Viz
Weather Data Administration tool.

The Viz Weather System Configuration chapter describes how to configure Viz
Weather and adjust the system to a customer’s workflow.

The Meteorological Data Visualization chapter describes a number of common


meteorological data visualization options.

The Using Viz Weather chapter describes Viz Weather’s user interface and
functionality.

The Working with Meteorological Data, Working with Graphics Templates,


Working with Data Elements and Working with Playlists chapters all describe how
to operate and use the different parts of Viz Weather.

The Playout Mode chapter describes an alternative mode of running Viz Weather,
during production.

Chapter 1: Introduction 1
The Fetch Application chapter describes the Fetch application module, used for
downloading meteorological data from a defined data supplier.

The External Commands chapter describes a set of commands that can be used to
control Viz Weather using an external (e.g. third part) application, sending the
commands via TCP to the Media Sequencer.

The Appendix gives more information on minute details such as file structure and
parameters for configuring Viz Weather and weather data suppliers.

The Troubleshooting Guide that covers the most common issues when operating
a Viz Weather system.

1.1.2 Related Documents


• Viz Artist User’s Guide - How to be creative in 3D space.
• Viz Content Pilot User’s Guide- How to create and manage playlists, integrate
to newsroom systems, setup a standalone VCP database and more.
• Viz Engine Administrator’s Guide - How to setup and configure Viz Engine
hardware and software.
• Viz One Administrator’s Guide - How to configure Viz One to work with Viz
Weather
• Viz Template Wizard User’s Guide - How to create and organize templates
• Viz Weather Scene Design Tutorial - Contains a set of demo scenes and a
document describing how to build a Viz Weather scene
• Viz World User’s Guide - How to create maps-on-the fly and manage map
servers

1.1.3 Conventions
The following typographic conventions are used in this document:

• Italic is used for non-hyperlink external references, such as related


documents, books, or Internet pages. Italic is also used to emphasize words.
• The color blue is used for hyperlinked external references, and also internal
references to sections or document elements (such as tables or figures) in the
current document.
• Bold refers to GUI components.
1. Numbered paragraphs are used to indicate tasks that must be carried out.

1.2 Contact Vizrt


We encourage your suggestions and feedback regarding the products and this
documentation. In order to provide feedback, please identify your local Vizrt
customer support team at www.vizrt.com.

2 Chapter 1: Introduction
2 Viz Weather
Viz Weather is a complete 3D real-time weather broadcast solution. It features a
broad range of advanced visualization possibilities in multiple media formats; HD
and SD video, mobile, web, and so on. Viz Weather integrates with a broad range
of meteorological data providers, and can trigger graphics and animations
automatically. An intuitive GUI allows to easily control, switch, and manipulate the
data. The solution is fully integrated with Viz World Maps for creation of branded
high-quality maps.

This section contains information on the following topics:

• System Overview
• Workflow

2.1 System Overview


This section contains information on the following topics:

• Integration of Live Weather Data


• Advanced Visualization and Interaction
• Realistic Weather Presentation
• A Template-Based Solution

Integration of Live Weather Data


Viz Weather is a template based solution that allows the integration of live
weather data into pre-defined graphic templates. Viz Weather supports weather
information both from Vizrt’s partners and from local providers. Viz Weather
supports local real-time weather data with a resolution of less than 1km,
providing accurate local forecasts for use in transportation control and large
outdoor sports events.

Viz Weather includes an interface to Weather on Demand (WOD) services. The


combination of Viz Weather and WOD results in a flexible, online user-selectable
weather feed for point forecasts, grid animation data, satellite data, observations
and more. The area chosen for the forecast is covered by a global on-demand
service, allowing the user to change the area of interest and the 3D animations
within seconds. The WOD service allows to go on-air with locally updated weather
information anywhere and anytime. This is particularly important during critical
weather conditions such as floodings, hurricanes or wildfires.

Advanced Visualization and Interaction


Viz Weather allows users to change weather-data graphics in seconds. The
separation between meteorological data and graphic representation, allows
meteorologists and weather presenters to edit and control the weather broadcast
from a control system. Viz Weather graphics are designed using Vizrt’s 3D design
application, Viz Artist. Its full range of design, animation and interactivity features
is used to produce the weather shows. Using these capabilities, weather shows

Chapter 2: Viz Weather 3


can utilize touch driven presentations, sound effects, digital-video effects and
integrated live video.

Realistic Weather Presentation


Viz Weather supports real-time weather presentation either through point-based
symbols or as high-resolution 3D animations. The unique Particle Generator
functionality, allows the creation of a visually accurate representation of the
weather forecast development.

Weather data, such as temperature, wind speed and direction, weather symbols,
3D maps, and radar maps are displayed automatically with corresponding graphic
elements in real-time, using the pre-made templates.

A Template-Based Solution
Being fully based on graphic templates, results in an easy to use application and
an efficient workflow. The predefined templates allow meteorologists and weather
presenters to focus on weather conditions.The graphic designers build and
maintain the graphic templates, while preserving the channel’s branding.

Viz Weather’s template-based approach combined with advanced playlist


capabilities allows automated weather shows and the re-use of data for cross
platform distribution: Viz Weather playlists can be turned into a set of images and
clips for mobile phones, web sites, and so on.

2.2 Workflow
When using Viz Weather to produce a weather show, the following steps must be
followed:

1. The graphic designer and the weather department create a storyboard of the
show, which includes graphic guidelines and meteorological content to be
presented. The graphic designer designs the graphic scenes (graphic
templates) in Viz Artist. The designer must follow some guidelines and use
special weather plug-ins when creating graphic templates for Viz Weather.
The design process is done once, but might be repeated when a new look of
the show is required.

Note: For additional information about graphic template design, refer to the Viz
Weather Scene Design Tutorial.

2. When the design stage is done, the graphic templates are filled with data and
saved as data elements. The data elements are then added to a playlist, to
create the sequential structure of the weather show. This step is repeated
every time the weather show editor wants to change the show’s flow.
3. The station’s meteorologist fetches the meteorological information and
validates it. Manual correction of data and other fine-tuning is possible. This
step is performed daily, or before every show, and it can be automated.
4. The operator then loads the playlist to the Viz Engine before the show, and
operates the playlist controls during the show.

4 Chapter 2: Viz Weather


3 Installation
This chapter provides a general system overview and describes the installation
procedure required to create a running Viz Weather environment.

IMPORTANT! When installing or upgrading Viz Weather, please follow the latest
documentation supplied with the installation files. If no special instructions are
given, follow the instructions in this manual.

This section contains information on the following topics:

• Viz Weather Setup Overview


• System Requirements
• Installing Viz Weather
• Configuring Viz Weather
• Upgrading Viz Weather
• Viz Weather Quick Start

3.1 Viz Weather Setup Overview


A Viz Weather environment requires a few components:

1. Media Sequencer - all the system’s configuration and content is stored in the
Media Sequencer. It acts as a server and all running Viz Weather applications
connect the same Media Sequencer (if common content and configuration is
required).
2. Oracle database - the Oracle database is used for storing Weather points and
data for the weather points. In some cases, if the database is shared with Viz
Content Pilot, the database will be used to save the data elements as well.
3. Viz Engine - This is Vizrt graphic core, generating 3D graphics from the
meteorological data.
4. Viz Weather - Viz Weather is the control application, combining data from the
Oracle database, Viz Engine graphics and meteorological data to create the
final output of the system.

When Viz Weather is launched it will run Viz Engine and connect to the Media
Sequencer service.

Viz Weather user interface controls the graphics through a set of commands sent
to Viz Engine, adding the defined meteorological data to the basic scenes (graphic
templates).

3.1.1 System Architecture


This section contains information on the following topics:

• Viz Weather Data Hub


• On-Air and Client Machines
• Multiple Viz Weather Clients Environment

Chapter 3: Installation 5
• Single Machine

Viz Weather Data Hub


Viz Weather Data Hub performs as a server for other Viz Weather applications in
the system. The Data Hub is running Media Sequencer, Oracle server and a Viz
Weather Fetch Application (in most cases). All clients in the system are connected
to the Data Hub, sharing the content and configuration. In most cases, this
machine does not run Viz Engine. It requires a large disk for storing the
meteorological data that is being downloaded by Viz Weather Fetch Application.

On-Air and Client Machines


In this setup, the output video is produced by the On-Air machine, which is
controlled by the Viz Weather client machine.

The client machine runs Viz Weather, and sends commands and data to the On-
air machine. All editing and data manipulation is done on the client machine. The
client machine is running Viz Engine for editing, and can be used as a preview
machine during production - showing the next item in the Playlist.

The On-air machine is running Viz Engine that produces an SDI or HD video
signal. The On-air machine is controlled by the client machine during production.

Multiple Viz Weather Clients Environment


In a multiple Viz Weather environment, a number of Viz Weather applications
connect to the same Viz Weather Data Hub machine and share environment
configuration and content.

This setup is used when multiple authoring workstations and production playout
machines are used on the same network. The On-air, client machines and Viz
Weather Data Hub are connected via network and share the meteorological data
and Viz graphic DB.

The client machine runs the UI and sends commands and data to the selected On-
air machine. All editing and data manipulation is done on this machine. The client
machine is running Viz Engine for editing, and can be used as a preview machine
during production - showing the next item in the Playlist.

The On-air machine is running Viz Engine that produces an SDI or HD video
signal. The On-air machine is controlled by the client machine during production.

6 Chapter 3: Installation
Figure 1: Viz Weather Block Diagram - Multi Machine Configuration

Single Machine
A single machine configuration is a one PC/machine with a video card, running
both Viz Weather and Viz Engine, producing an SD or HD video output signal. In
some cases the Data Hub is running on the same machine.

Chapter 3: Installation 7
Figure 2: Viz Weather Block Diagram - Single Machine Configuration

See Also
• Upgrading Viz Weather

3.2 System Requirements


This section contains information on the following topics:

• Hardware Requirements
• Software Requirements

3.2.1 Hardware Requirements


The following list is an extract of the current and most important hardware
requirements needed in order to operate a Viz Weather system:

• Client Machine
• Data Hub Machine

8 Chapter 3: Installation
• On-Air Machine

Note: For a complete overview of hardware configuration options and requirements,


contact your local Vizrt representative.

Client Machine
The Z400 is the typical client PC for Viz applications such as Viz Trio, Viz Content
Pilot, Viz Weather and Viz Multichannel.

• HP Z400 (or newer)


• 6 GB Ram
• NVidia Quadro FX1800 768 MB
• Windows 7 Professional (64 bits)

When using complex scenes with a lot of textures you can replace the FX1800
with a FX3800 or FX4800 to get better performance.

Data Hub Machine


Since no enhanced graphic ability is required, a Z400 which is the typical PC for
Viz applications can be used.

• HP Z400 (or newer)


• 6 GB Ram
• Windows 7 Professional (64 bits)

On-Air Machine
The HP Z800 is currently the default configuration for a HD/SD Viz Engine and Viz
Artist:

• HP Z800 (or newer)


• 6 GB RAM
• NVidia Quadro FX4800 1.5 GB PCIe
• Windows 7 Professional (64 bits)
• Matrox XMio2/24/6000
• Matrox XMio2 Break-out Box

Note: If the engine should be capable to play HD Video Clips use an XMio2/24/8500
instead of the XMio2/24/6000.

See Also
• Viz Artist User’s Guide
• Viz Engine Administrator’s Guide

3.2.2 Software Requirements


The following software modules are used by Viz Weather:

Chapter 3: Installation 9
• Vizrt Software
• Third Party Software

Vizrt Software
• Viz Weather 2.4
• Viz Engine 3.6 (or later)
• DataPool plugins 2.1 (or later)
• Media Sequencer 1.23 (or later)
• Viz World Maps Client 11.0.0 (or later)

Third Party Software


• Python 2.7.2 (Python 3 not tested yet)
• Oracle 10.2 or 11 Server, or XE (for managing points, one server in the system)
• Oracle 10.2 or 11 Client (on Viz Weather client machines)

IMPORTANT! This installation guide assumes the following:


- One Oracle Server is installed and configured in the system
- Oracle Client was installed and can connect to the Oracle Server
- Viz Engine or Viz Artist is installed

Note: With every official release of Viz Weather, a folder with all the required SW
installers is loaded to the Vizrt FTP. Do not use other SW versions unless instructed
to do so.

3.3 Installing Viz Weather


Before installing any parts of the Viz Weather system, make sure you have done
the following:

• From the Vizrt FTP download the entire installation folder for the latest version
of Viz Weather locally (maintaining the folder hierarchy).
• Install the recommended Viz Engine version supplied in the top folder.

Note: All plugins and Viz Engine DLL’s are installed to Viz Engine’s installation
folders. The Viz Weather installer will automatically detect the path of the latest
installed Viz Engine and use it to install the required files.

Note: Oracle software modules (Oracle 10.2 client or server) are installed separately.
Oracle server installation and Oracle client installation should be performed by a
qualified systems administrator.

This section contains informaiton on the following topics:

• Installing a Viz Weather Client Machine


• Installing a Viz Weather Engine Machine
• Installing a Viz Weather Data Hub

10 Chapter 3: Installation
• Installing a Viz Weather Data Hub
• Installing the Database Schema
• Viz Weather Folder Structure

See Also
• Configuring Viz Weather
• Upgrading Viz Weather

3.3.1 Installing a Viz Weather Client Machine

To install a Viz Weather Client machine


1. Make sure Viz Engine or Viz Artist is installed.
2. Make sure an Oracle Client is installed.

Note: A small client is provided with the Viz Weather installers:


VizWeatherOleDBProvider.11.0.exe. Install the small Oracle client if no other oracle
products are installed.

3. Get the following details of the Oracle server:


• Machine name/IP address
• Database/instance name
• Password for the system user of oracle.
4. Install the data pool plugins (DataPool_<version>.exe).
5. Install the Viz World Maps Client (VizWorldClient_<version>.exe) use
installation defaults.
6. Optional: Install Media Sequencer (use installation defaults). This installation is
required if an external triggering device is connected to the machine.
7. Install Python (use installation defaults).
8. Run Viz Weather Installation.
• The installer will check for Viz versions installed on the machine, and copy
the files accordingly.
9. Select a Control Machine installation.
• If run for the first time on the machine, the installer will launch Viz
Weather’s database creation wizard (WD_Wizard) after Viz Weather
installation ends. Close the WD_Wizard, if the points database has already
been configured.

Note: The order in which the installers are executed is important. Viz Weather should
be installed last.

See Also
• Installing the Database Schema
• System Level Settings
• Application Level Settings

Chapter 3: Installation 11
3.3.2 Installing a Viz Weather Engine Machine

To install a Viz Weather Engine machine


1. Make sure Viz Engine or Viz Artist is installed.
2. Install the data pool plugins (DataPool_<version>.exe).
3. Install the Viz World Maps Client (use installation defaults).
4. Run Viz Weather Installation.
• The installer will check for Viz Engine versions installed on the machine, and
copy the files accordingly.
5. Select an Engine Machine installation.

Note: The order in which the installers are executed is important. Viz Weather should
be installed last.

See Also
• Installing the Database Schema
• System Level Settings
• Application Level Settings

3.3.3 Installing a Viz Weather Data Hub

Note: The Media Sequencer is used by Viz Weather to manage content and system
configuration settings.

To install a Viz Weather Data Hub


1. Make sure Oracle Server is installed.
2. Get the following details of the Oracle server:
• Machine name/IP address
• Database/instance name
• Password for the system user of Oracle.
3. Install the required Media Sequencer package version. The correct installer is
found on Vizrt FTP site.
4. Run the Media Sequencer.
5. Install the supplied Python installer.
6. Run Viz Weather Installation.
7. Select a Control Machine installation.

3.3.4 Installing the Database Schema


Before any installation or upgrade of Viz Weather specific schema, an Oracle
database must be installed and running.

Viz Weather makes use of the database for storing weather points and points
related data. The schema for storing the points uses a version number to check
for compatibility and allow schema changes and updates.

12 Chapter 3: Installation
Note: Viz Weather will not run if there is a schema mismatch. If a mismatch occurs a
message will be displayed. Once the schema has been updated to the correct
version, Viz Weather can be used again.

To install and configure the weather points schema


1. Run WD_Wizard.exe from the %SystemDrive%\Program Files
(x86)\vizrt\VizWeather2\WD_Wizard folder.

Note: If Viz Weather 2 installer is run for the first time on the machine, the
WD_Admin tool will be automatically launched at the end of the installation process.

Set the database administration connection parameters


• Select Basic from the drop-down list (or TNS to use a database alias).
• Set the database connection parameters:

a. Set the Host Machine to the Oracle server machine name (or IP address).
b. Set the database name (Oracle instance, consult your system administrator
or DBA).
c. The port number should not be changed (1521).
d. User name should be set to system (default value).
e. Set the Password to the database system user (consult your system
administrator or DBA).

Note: The database administrator user/password is used to create a new tablespace,


new user and password. These will be used by Viz Weather to store and manage
weather points information. DO NOT use the administrator credentials in the

Chapter 3: Installation 13
connect string of other Viz Weather applications (WD_Admin, Viz Weather, Fetch
Application).

If the connection to the database succeeded, Viz Weather table space


configuration settings will be displayed.

2. Click Next to create the WEATHER tablespace (default).

Note: Running WD_Wizard with the "-custom" flag, will enable you to set a different
table space name, user name and password.

3. Select Create clean tables (default) and click Next.


4. Optional: Select Create from Dump file if you have a dump file of an existing
database
• For additional details, contact your systems administrator.
5. Save the database preferences to the initialization file (see the Application
Level Settings section).
%SystemDrive%\Program Files (x86)\vizrt\VizWeather2\viz_weather.ini
6. When the process is finished, close the application.

Note: Creating a shortcut to WD_Wizard and running it with the "-custom" flag in the
target path will enable you to skip stages and configure default parameters during
the installation.

IMPORTANT! An import af a WDD file to the database requires a FULL administrative


Oracle Client installation on the machine that is used for the import. Another option
is to do the Import on the Oracle server machine (requires a Viz Weather installation
on the Oracle Server).

14 Chapter 3: Installation
3.3.5 Installing a Viz Weather Single Machine

To install a Viz Weather Single Machine


1. Make sure Oracle Server is installed.
2. Get the following details of the Oracle server:
• Database/instance name
• Password for the system user of oracle.
3. Install the required Media Sequencer package version. The correct installer is
found on Vizrt FTP site.
4. Run the Media Sequencer.
5. Install the supplied Python installer.
6. Install the data pool plugins (DataPool_<version>.exe).
7. Install the Viz World Maps Client (use installation defaults).

Note: The order in which the installers are executed is important. Viz Weather should
be installed last.

8. Run Viz Weather Installation.


9. Select a Control Machine installation.
10. When the installation finish screen is displayed, check the Launch WD_Wizard
option and click OK.
11. Follow the steps in Installing the Database Schema.

3.3.6 Viz Weather Folder Structure


Viz Weather files and folders are installed under the default path
(%SystemDrive%\Program Files (x86)\vizrt\vizWeather2) or under a
custom path set by the user during the installation. The application files (.exe)
and configuration files (.ini) are also installed under this folder.

During the configuration stage two additional folders should be defined; shared
data folder and a shared configuration folder. These folders should be shared
between all Viz Weather and Viz Engine/Artist machines used in the system.

The installation folder contains the following sub folders:

• DataSuppliersDlls: A folder containing the fetch DLL's. These DLL's manage


the download of meteorological data.
• Docs: Viz Weather documents are copied to this folder during installation.
• Fetch_scripts: Python scripts and additional applications for downloading grid
data and creating IsoBars, IsoPrecip and IsoTherms data files.
• Replaced plugins: A folder containing Viz plugins that should be overwritten
after a Viz installation. these are Viz plugins that were updated for Weather
use and were not included in the latest Viz release.
• SharedConfiguration: A folder containing configuration and data files that
should be common to all client Viz Weather applications.
• Projections: A folder containing geographic referencing data of fetched
images (VGR files). The files containing a description of the image location
(long/lat), projection, and so on. Under it is the folder Sat-calibration-
images. The folder contains sample sat images from different satellites. The
images have a bold mark along the coastline to help calibrate the satellite

Chapter 3: Installation 15
images to maps. These sample images are geo referenced and can be used
when a non geotiff map is used. Placing the referenced image on top of the
non referenced map will emulate geographic referencing when used by Viz
Weather to place Wpoints.
• SampleFiles: A folder containing a set of sub-folders, which again contain
sample system and fetch configuration files. During system configuration,
the files are modified and loaded by the WD_Admin application into the
Media Sequencer XML file (wx_config.xml).
• DataElementsIcons: Icons of the saved data-elements are saved in this
folder.
• Symbols: sample symbols for weather conditions (rainy, cloudy, and so on).
• WD_Wizard: This folder contains the database wizard application. The
application is launched after Viz Weather is installed for the first time, or it can
be launched manually by the user. The wizard is used to create a table space
in the database and define the required database element for hosting weather
points in the system.

3.4 Configuring Viz Weather


Viz Weather is not a standalone product; hence, it must be configured to work
with other Viz Weather clients and with other Vizrt products such as the Media
Sequencer and Viz Engine.

When using an On-air/client configuration, or in an environment with a few Viz


Engine installations, all machines should be connected to the same Viz Graphics
Hub.

A shared weather data folder should also be mapped on all Viz Weather and Viz
Engine machines. The shared weather data folder is defined in the WD_Admin.
Another shared folder is the shared configuration folder which should be common
to all Viz Weather clients, working with the same settings.

While Viz graphic database is configured in Viz Config, the Shared Data and
Shared Configuration folders are defined in Viz Weather and mapped on the Viz
Weather and Viz Engine machines.

IMPORTANT! Make sure the shared network drive has full read/write permissions to
all users/machine running Viz Weather or Viz Engine.

Note: If a new data base is used, a warning message about point type not defined
will pop. run WD_Admin and define the first point type as WeatherPoint.

For additional information about configuring weather points, see General


Configuration.

This section contains information on the following configuration steps:

• To define the path of the Shared Data and Shared Configuration folders
• To configure Viz Weather to connect to a Viz Weather Data Hub
• To configure Viz Weather configuration file
• To configure Viz 3.x

16 Chapter 3: Installation
To define the path of the Shared Data and Shared Configuration folders

1. Start WD_Admin in one of the following ways:

a. From the Windows Start menu, select: All Programs > Vizrt > Viz Weather2
> Weather Database Administration Tool, or
b. Run Viz Weather. Select the Settings > Data menu item. Enter the password
(default is admin) in the appearing password confirmation dialog box, and
click OK, or
c. Run Viz Weather Fetch Application. Select the Settings > Data menu item.
Enter the password (default is admin) in the appearing password
confirmation dialog box, and click OK

2. Once the WD_Admin window is open select the Shared Folders tab.
3. Set the Configuration folder.

Note: The sub folders are defined relatively, and cannot be edited. Use a mapped
network folder that is common to all Viz Weather clients.

4. Set the Data Folder.

Note: The sub folders are defined relatively, and can be edited. This folder will store
all the fetched meteorological data (except weather points). Use a mapped network
folder that is common to all Viz Weather clients and all Viz Engine machines in the
system.

5. When done, click Apply and then click Publish Settings.


6. Close WD_Admin.
7. Copy the SharedConfiguraton folder content (under vizrt\VizWeather2) to the
defined configuration folder.

Chapter 3: Installation 17
Note: Viz Weather sends the path of the images and the fetch data to both Viz
Engine preview and program machines during the initialization process - if one
machine does not have the correct path, the images/data will not be visible.

Note: Make sure the Shared Data network drive has enough disk space to contain the
meteorological data.

To configure Viz Weather to connect to a Viz Weather Data Hub


1. Right-click the Viz Weather shortcut (or Viz Weather Fetch Application
shortcut), and from the appearing context menu select Properties.
2. Select the Shortcut tab, and add the following command line option to the
target path: –MSE <machine_name>, where the machine name is the name of
the Viz Weather Data Hub machine.

Note: The command line option is added after the closing quote character

3. Click OK.

Note: When running a Viz Weather application with a local Media Sequencer, the -
MSE flag is omitted.

To configure Viz Weather configuration file


1. Open Viz Weather configuration file located in the Viz Weather program folder
%SystemDrive%\Program Files (x86)\vizrt\VizWeather2\viz_weather.ini
2. Under the WD_SERVER section, set the data base connection string with the
Oracle server machine name, data base name, and user/password
combination.

Example: ConnectionString=Provider=OraOLEDB.Oracle.1;Password=Weather;Persis
t Security Info=True;User ID=Weather;Data Source=LocalHost:1521/xe

Note: Apply this change to all Viz Weather machines in the system. Without a
connection to the Oracle database, Viz Weather will not run.

3. Locate the CURIOUS category and enable the Viz World Maps Client.
[CURIOUS]
cwm_enabled=y

4. Under the VIZ section, set the on_air_machine name, and set the list of
optional on-air machines by setting the parameters machine1, machine2, and
so on.
5. Save and close the INI file.

To configure Viz 3.x


1. Start Viz Config 3.x.
2. Select the Database category and enable Auto Login (Yes).

18 Chapter 3: Installation
3. Select the Maps category and configure the Viz World map database settings.

4. Set the Cache Directory to a shared folder between the client machines (Viz
Weather) and the output machines (Viz Engine).
5. Click Save and close Viz Config.

Note: From Viz World Maps version 12.0 and higher, a second cache folder is
available. The second cache folder should be set to a local folder, and the first to a
shared network drive. The second folder is used for redundancy and is used when
the network connection is disturbed.

See Also
• Installing Viz Weather
• Upgrading Viz Weather
• Viz World Client and Server User’s Guide

Chapter 3: Installation 19
3.5 Upgrading Viz Weather

Viz Weather upgrades are installed using the Viz Weather installer. The installer
automatically determines which Viz Engine version was installed last and installs
required files.

If you are upgrading Viz Engine, upgrade Viz Weather after installing/upgrading
Viz Engine.

If only Viz Engine is installed, copy the replaced plugins from Viz Weather’s
installation folder to Viz Engine’s plugin folder. After the installation is finished
replaced plugins can be found in: %SystemDrive%\Program Files
(x86)\vizrt\VizWeather2\ReplacedPlugins\.

Files with file extension *.evp are Viz 2.x plugins, while *.vip are Viz 3.x plugins.

This section contains information on the following upgrade steps:

• Upgrading Viz Weather to Latest Version


• Viz Weather Environment Conversion
• Upgrade Notes for Version 1.X to 2.1
• Upgrade Notes for Version 2.x to 2.2
• Upgrade Notes for Version 2.2 to 2.3
• Shared Folders Configuration
• Providers Info Configuration
• Associating Providers With Data Types

20 Chapter 3: Installation
3.5.1 Upgrading Viz Weather to Latest Version
If upgrading from 2.1 (or older versions) to 2.2, refer to the Viz Weather
Environment Conversion section.

When upgrading from 2.2.x to 2.3, a message about the shared configuration
folders will appear when running the application for the first time. See the
Upgrade Notes for Version 2.2 to 2.3 section on how to configure the shared
configuration folders.

To upgrade Viz Weather


1. Create a backup of your configuration and data files:
a. Upgrade from 2.0, 2.1 to 2.2:
• Backup the following folders under the Viz Weather 2 program directory:
xml, xmlConfigFiles, vizrtDef, SceneIcons, symbols, and Projections.
• Backup all initialization files (.ini) under the Viz Weather 2 program
directory.

Note: Viz Weather: %ProgramFiles%\vizrt\VizWeather2\

b. Upgrade from 2.2 to 2.3:


• Backup the following XML files found under the Media Sequencer’s MSE
files: wx_content.xml, wx_config.xml, default.xml.
• Backup the following folders under the Viz Weather 2 program directory:
SceneIcons, symbols, Projections.

Note: Media Sequencer: %ProgramData%\Vizrt\Media Sequencer

2. From the Vizrt FTP, download the entire installation folder for the latest
version of Viz Weather.
• The folder includes a Viz Wetaher installer and additional required software
(see the Software Requirements section).
3. Upgrade additional software in the order as described in the Installing Viz
Weather section.
4. Run the Viz Weather installer.
5. Run the installer and select one of the following options:
• Upgrade and keep user configuration: Upgrades Viz Weather software
keeoping existing configuration files.
• Upgrade and re-install configuration: Upgrades Viz Weather software and
configuration files. Old configuration files and folders will be renamed to
<name>.BAK

See Also
• Installing Viz Weather
• Configuring Viz Weather
• Viz Weather Environment Conversion
• Upgrade Notes for Version 2.2 to 2.3

Chapter 3: Installation 21
3.5.2 Viz Weather Environment Conversion
Viz Weather version 2.2 introduced a major change in the way content and system
configuration were handled. Another major change was the cancelation of Server/
Client roles. All running Viz Weather applications were clients, connecting to a
Media Sequencer. The Media Sequencer managed content, system configuration
and other tasks.

Due to all changes above, content and system configuration had to be converted
to the new format used by 2.2.0.

See the following upgrade notes that explains how to upgrade and convert from
older versions to version 2.2:

• Upgrade Notes for Version 1.X to 2.1


• Upgrade Notes for Version 2.x to 2.2

3.5.3 Upgrade Notes for Version 1.X to 2.1


1. Install Viz Weather version 2.1.0.
• The installer will create a new clean environment next to the old Viz Weather
1 installation.
2. Configure the points database and save the connect string to viz_weather.ini
file.
3. Import the weather points from the old weather.xml (from the WD_Admin):
• Run the WD_Admin tool.
• Select the Utilities tab.
• Press the Import Points button. A file browser will open.
• Browse and select the weather.xml file (default location is <Viz Weather1
folder>\xml.
• Click the Open button. The Select Point Type window will open.
• Select a point type from the list and click OK.
• The points from the old environment will be imported to the database, into
the selected point type.

4. Run Viz Weather 2 and check that the points were imported from the old Viz
Weather environment.
5. Close Viz Weather.
6. Run the WD_ImportDB application. Default location is:
C:\Program Files (x86)\Vizrt\Viz Weather2\WD_ImportDB.exe

22 Chapter 3: Installation
7. Select the configuration file to convert.
• All values from the selected configuration file will be applied to a new Viz
Weather configuration file for version 2.1.
8. Click the Advanced button.

• Make sure the source and destination paths are correct.


9. Click OK to confirm changes or click Cancel to use the defaults.
10. Click Next.
• The WD_ImportDB application will check the files and validate them.

Chapter 3: Installation 23
• Read the messages in the log window and check that no errors were found.
• When the validation process is done, the Import button will become
enabled.
11. Click the Import button to perform the conversion.
12. Run Viz Weather 2 and check that the content was imported from the old Viz
Weather environment.
13. Close Viz Weather.
14. Continue to the next procedure to convert from 2.x to 2.2 environment.

3.5.4 Upgrade Notes for Version 2.x to 2.2


Run Viz Weather 2.x.

IMPORTANT! Do not install the 2.2 version before you have run the conversion tool.
Use the installed 2.x version.

Run the VW2_convert.exe tool to convert the loaded weather.xml file to the
default.xml and the two new files (wx_content.xml, wx_config.xml). The
conversion will also convert data elements with Weather Points, Texts and Special
Objects to the new Geo behavior.

Install Viz Weather 2.2 - select the option to install and keep user configuration.

3.5.5 Upgrade Notes for Version 2.2 to 2.3


When upgrading from 2.2 to 2.3, a change in the folder structure and a change in
the fetch parameters were introduced. This change enhances the support in
multiple client environments and the use of a Viz Weather Data Hub machine as a
server.

The fetchparameters.ini file was discarded and the fetch settings were moved to
the wx_config.xml file, which is a part of the Media Sequencer’s default.xml.
These files are loaded when the Media Sequencer is running and Viz Weather
applications connected to the Media Sequencer have access to the system settings
and content. An import from the old fetchparameters.ini file to the system is
required. Follow the instructions in the Providers Info Configuration section.

After upgrading from 2.2 to 2.3, you will be prompted to configure the shared
folders. When a Viz Weather application is run for the first time, a warning
message about setting the shared folders will appear. If no action is taken, the
system will store default values in the configuration files. Follow the instructions
in the Shared Folders Configuration section.

IMPORTANT! It is strongly recommended to perform the upgrade set up. If the new
settings are not defined, you will not be able to fetch new data. For additional
information see the General Configuration section.

See Also
• Shared Folders Configuration
• Providers Info Configuration
• Associating Providers With Data Types

24 Chapter 3: Installation
3.5.6 Shared Folders Configuration

The shared folders configuration define a path that will be common for all Viz
Weather applications connected to the same Weather Data Hub. Perform this
configuration procedure on the Data Hub machine (or on the weather control
machine if using a single machine configuration).

The configuration option allows you to configure two root folders:

• Configuration Folder: Contains four sub folders required for storing common
configuration files. The sub folders path are hard coded and Viz weather will
generate the sub folders if they do not exist.
• Data Folder: Contains two sub folders for storing meteorological data. The sub
folders are not hard coded, but they must reside under the defined Data
Folder.

Note: This parameter was moved from the System Settings window and it replaces
the initialization file (see the Application Level Settings section) entry
weather_database and the FetchData folder in Viz Weather folder.

Chapter 3: Installation 25
To configure shared folders
1. In a multiple clients/on-air machines environment, share a folder on a large
storage device. Make sure the shared folder has full Read/Write permissions
for all users.
2. Map the shared folder as a network drive.

Note: Preferred drive letter is W:\ for Weather, however any drive letter will work.

3. In the shared drive, create a folder for the configuration and a folder for data.
4. Copy the sub folders from %SytemDrive%\Program Files
(x86)\vizrt\VizWeather2\SharedConfiguration into the configuration
folder, you just created on the shared drive.
5. On the Data Hub machine, run WD_Admin from the Start menu > All Programs
> Vizrt > Viz Weather 2 >Weather Database Administration Tool.

Note: Make sure that the Media Sequencer is running, and that the database
connection string is configured and working. See the Configuring Viz Weather
section in the Installation chapter for more information.

6. Select the Shared Configuration tab.


7. Browse to the Configuration folder on the mapped network drive (W:\) and
click OK.
8. Browse to the Data folder on the mapped network drive (W:\) and click OK.
9. Map the shared folder on all the machines in the system, using the same drive
letter (W:\).
10. Click the Apply button to confirm or revert to cancel changes.
11. Click the publish settings button, to apply the changes to all connected
clients.

3.5.7 Providers Info Configuration


Viz Weather is a graphics tool that integrates updated meteorological data. The
meteorological data is downloaded (fetched) from a remote data provider server,
or from a local folder that is constantly updated. The data is downloaded by using
a set of fetch DLL files. Each DLL requires a set of parameters and values to fetch
the data. The combination of a DLL file and its parameters defines a provider.

The Providers Info tab in the WD_Admin tool is used for configuring the different
data providers and the different data types in the system. The provider’s
configuration is loaded from an XML file or edited in the right pane of the
Providers Info tab.

If more than one provider is defined, the priority of the providers will be
sequential, as in the Providers Info list. This means Viz Weather will try to fetch
data using the first provider configuration, if it fails, it will attempt to fetch with
the second provider’s configuration, and so on.

Viz Weather is installed with a set of sample provider configurations. The files
reside under the <shared configuration path>SampleFiles\Providers.

26 Chapter 3: Installation
IMPORTANT! In order to fetch data, using Storm or CustomWeather (CW) sample
configuration, a demo fetch license is required. Update your Viz Engine license
before fetching any data.

Note: In some cases, the integration of a new data provider with Viz Weather will
require code development.

To load provider settings


1. On the Data Hub machine, run WD_Admin from the Start menu > All Programs
> vizrt > Viz Weather 2 > Weather Database Administration Tool.

Note: Make sure that the Media Sequencer is running, and that the database
connection string is configured and working. See the Configuring Viz Weather
section in the Installation chapter for more information.

2. Select the Providers Info tab.


3. Click the Load button.
• A file browser will open, displaying the providers sample files list.
4. Select a provider file and click OK to confirm.
• The selected configuration will be displayed on the right side of the
WD_Admin window.

Chapter 3: Installation 27
5. Edit the configuration with the required parameters and values.
6. Click the Apply button to confirm or revert to cancel changes.
7. Click the publish settings button, to apply the changes to all connected
clients.

Note: You can backup your providers settings; after setting your parameters and the
fetch is working, save your providers info settings to a file, by clicking the save
button.

To load provider settings from a fetchparameters.ini file


In previous Viz Weather versions, the provider settings were stored in the
fetchparameters.ini file. In case of an upgrade from a previous version, the
settings from the INI file can be imported and used in the new system.

1. On the Data Hub machine, run WD_Admin from the Start menu >All Programs
> vizrt > Viz Weather 2 > Weather Database Administration Tool.

Note: Make sure that the Media Sequencer is running, and that the database
connection string is configured and working. See the Configuring Viz Weather
section in the Installation chapter for more information.

2. Select the Providers Info tab.


3. Click the Import button.
• A file browser will open
4. Browse for and select the fetchparameters.ini file.
5. Select the file and click OK to confirm.
• The file configuration will be imported and displayed on the right side of the
WD_Admin window.
6. Edit the configuration with the required parameters and values.
7. Click the Apply button to confirm or revert to cancel changes.
8. Click the publish settings button, to apply the changes to all connected
clients.

Note: You can backup your providers settings; after setting your parameters and the
fetch is working, save your providers info settings to a file, by clicking the save
button.

To disable or enable providers


1. On the Data Hub machine, run WD_Admin from the Start menu > All Programs
> vizrt > Viz Weather 2 > Weather Database Administration Tool.

Note: Make sure that the Media Sequencer is running, and that the database
connection string is configured and working. See the Configuring Viz Weather
section in the Installation chapter for more information.

2. Select the Providers Info tab.


3. Right-click a provider from the providers list.
• A context menu will appear, with the option to disable an active provider or
enable a disabled provider.

28 Chapter 3: Installation
3.5.8 Associating Providers With Data Types
The Providers list can contain more than one provider, each provider configured
to fetch a different data type.

During a fetch operation, Viz Weather will try to fetch the data using the first
provider configuration. If the fetch fails, it will try with the second provider
configuration, and so on, until fetch succeeds or all the providers failed. In such
cases associating a provider to specific data will reduce overall fetch time and
avoid errors during the fetch process.

A provider can be associated to a data type (Model Data, Radar, and so on) or to a
specific entry in a data type (D2 satellite, US radar, specific point type, and so on).

Setting a Default Provider to a Data Type


In the various data configuration tabs, there is a Provider parameter. If the value
remains empty or set to All Providers, all providers in the list will be used during
the fetch process.

To set a default provider:


1. Open the drop-down list of providers.
2. Select one provider (or more than one in case of Weather Points).
• Now, when fetching this data type only the selected provider will be used in
the process.

Setting a Specific Provider to a Data Type entry


In the various data configuration tabs, there is a Provider column. If the value
remains empty, the default provider will be used during the fetch process.

To set a specific provider:


1. Click the Provider column next to the selected entry.
A drop-down list of providers will open.
2. Select one provider (or more than one in case of Weather Points).
• Now, when fetching this data entry, only the selected provider will be used
in the process.

3.6 Viz Weather Quick Start


Viz Weather has a tutorial package that includes graphics templates and a set of
meteorological data. Download and extract the zipped tutorial file to your
machine.

To setup the tutorial files


1. Import the archive Weather Tutorial 2.2.via into Viz Graphic Hub.
• The tutorial project is located under SCENE*Weather-Tutorial.
• The graphics templates are under SCENE*Weather-Tutorial\Templates.
2. Create a new folder and map it as W:\

Chapter 3: Installation 29
3. Copy the data folders from the tutorial folder: Data used in the tutorial -
placed under W into the created W:\ drive.
4. Open the templates in Viz Artist and run the animation.
• You should be able to see the meteorological data playing.
5. Run Viz Weather and open a radar graphic template.
• A pop-up about radar not defines will appear. Close the message and select
the data folder from W:\Radar\USA_ALL.
• Set the time range and play the animation. You should be able to see the
data in Viz Weather.
6. Repeat the last section with other types of data and graphics templates.
7. In order to test the graphic templates that use Weather Points, a point type,
WeatherPoint, must be defined.

See Also
• Viz Weather Data Configuration

30 Chapter 3: Installation
4 Viz Weather Data Configuration

The Viz Weather Database Administration (WD_Admin) tool is used to configure


the meteorological data in the system:

• Data provider information and fetch configuration


• Structure of weatherpoint data tables, additional data fields and relations
between data fields and the DataPool variables
• Model data
• Radar and satellite imagery
• Storm tracking
• Other miscellaneous meteorological data types

The configuration categories on the left are used for selecting the required
parameters. When a category is selected, the pane on the right will display the
available properties and parameters.

This section contains information on the following topics:

• General Configuration

Chapter 4: Viz Weather Data Configuration 31


• Points Configuration
• Data Configuration
• Tools
• Configuring a Demo Supplier

To open the WD_Admin tool


1. Open the Windows start menu, and select All Programs > Vizrt > Viz Weather
2, and click the Viz Weather Database Administration tool option, or
2. Run Viz Weather or the Viz Weather Fetch Application.
3. Open the Settings menu and select Data..., or
4. Open the Viz Weather program folder at %SystemDrive%\Program Files
(x86)\vizrt\VizWeather2.
5. Double-click the WD_Admin.exe file.

Note: When the database is empty, the system will prompt about defining a point
type, as this is an essential component of the system. See how To configure a point
type for additional information.

4.1 General Configuration


The general configuration section contains information on the following topics:

• Shared Folders Configuration


• Providers Info Configuration
• Associating Providers With Data Types

32 Chapter 4: Viz Weather Data Configuration


4.1.1 Shared Folders Configuration

The shared folders configuration define a path that will be common for all Viz
Weather applications connected to the same Weather Data Hub. Perform this
configuration procedure on the Data Hub machine (or on the weather control
machine if using a single machine configuration).

The configuration option allows you to configure two root folders:

• Configuration Folder: Contains four sub folders required for storing common
configuration files. The sub folders path are hard coded and Viz weather will
generate the sub folders if they do not exist.
• Data Folder: Contains two sub folders for storing meteorological data. The sub
folders are not hard coded, but they must reside under the defined Data
Folder.

Note: This parameter was moved from the System Settings window and it replaces
the initialization file (see the Application Level Settings section) entry
weather_database and the FetchData folder in Viz Weather folder.

Chapter 4: Viz Weather Data Configuration 33


To configure shared folders
1. In a multiple clients/on-air machines environment, share a folder on a large
storage device. Make sure the shared folder has full Read/Write permissions
for all users.
2. Map the shared folder as a network drive.

Note: Preferred drive letter is W:\ for Weather, however any drive letter will work.

3. In the shared drive, create a folder for the configuration and a folder for data.
4. Copy the sub folders from %SytemDrive%\Program Files
(x86)\vizrt\VizWeather2\SharedConfiguration into the configuration
folder, you just created on the shared drive.
5. On the Data Hub machine, run WD_Admin from the Start menu > All Programs
> Vizrt > Viz Weather 2 >Weather Database Administration Tool.

Note: Make sure that Media Sequencer is running, and that the database connection
string is configured and working. See the Configuring Viz Weather section in the
Installation chapter for more information.

6. Select the Shared Configuration tab.


7. Browse to the Configuration folder on the mapped network drive (W:\) and
click OK.
8. Browse to the Data folder on the mapped network drive (W:\) and click OK.
9. Map the shared folder on all the machines in the system, using the same drive
letter (W:\).
10. Click the Apply button to confirm or revert to cancel changes.
11. Click the publish settings button, to apply the changes to all connected
clients.

4.1.2 Providers Info Configuration


Viz Weather is a graphics tool that integrates updated meteorological data. The
meteorological data is downloaded (fetched) from a remote data provider server,
or from a local folder that is constantly updated. The data is downloaded by using
a set of fetch DLL files. Each DLL requires a set of parameters and values to fetch
the data. The combination of a DLL file and its parameters defines a provider.

The Providers Info tab in the WD_Admin tool is used for configuring the different
data providers and the different data types in the system. The provider’s
configuration is loaded from an XML file or edited in the right pane of the
Providers Info tab.

If more than one provider is defined, the priority of the providers will be
sequential, as in the Providers Info list. This means Viz Weather will try to fetch
data using the first provider configuration, if it fails, it will attempt to fetch with
the second provider’s configuration, and so on.

Viz Weather is installed with a set of sample provider configurations. The files
reside under the <shared configuration path>SampleFiles\Providers.

34 Chapter 4: Viz Weather Data Configuration


IMPORTANT! In order to fetch data, using Storm or CustomWeather (CW) sample
configuration, a demo fetch license is required. Update your Viz Engine license
before fetching any data.

Note: In some cases, the integration of a new data provider with Viz Weather will
require code development.

To load provider settings


1. On the Data Hub machine, run WD_Admin from the Start menu > All Programs
> vizrt > Viz Weather 2 > Weather Database Administration Tool.

Note: Make sure that the Media Sequencer is running, and that the database
connection string is configured and working. See the Configuring Viz Weather
section in the Installation chapter for more information.

2. Select the Providers Info tab.


3. Click the Load button.
• A file browser will open, displaying the providers sample files list.
4. Select a provider file and click OK to confirm.
5. If any previous providers are defined in the system, a message will appear
asking if you want to merge the loaded providers with the existing providers,
or alternatively overwrite the existing providers. Select the required option.
• The selected configuration will be displayed on the right side of the
WD_Admin window.
6. Edit the configuration with the required parameters and values.
7. Click the Apply button to confirm or revert to cancel changes.

Chapter 4: Viz Weather Data Configuration 35


8. Click the publish settings button, to apply the changes to all connected
clients.

Note: You can backup your providers settings: after setting your parameters and the
fetch is working, save your providers info settings to a file, by clicking the save
button.

To load provider settings from a fetchparameters.ini file


In previous Viz Weather versions, the provider settings were stored in the
fetchparameters.ini file. In case of an upgrade from a previous version, the
settings from the INI file can be imported and used in the new system.

1. On the Data Hub machine, run WD_Admin from the Start menu > All Programs
> vizrt > Viz Weather 2 > Weather Database Administration Tool.

Note: Make sure that the Media Sequencer is running, and that the database
connection string is configured and working. See the Configuring Viz Weather
section in the Installation chapter for more information.

2. Select the Providers Info tab.


3. Click the Import button.
• A file browser will open.
4. Browse for and select the fetchparameters.ini file.
5. Select the file and click OK to confirm.
6. If any previous providers are defined in the system, a message will appear
asking if you want to merge the loaded providers with the existing providers,
or alternatively overwrite the existing providers. Select the required option.
• The file configuration will be imported and displayed on the right side of the
WD_Admin window.
7. Edit the configuration with the required parameters and values.
8. Click the Apply button to confirm or revert to cancel changes.
9. Click the publish settings button, to apply the changes to all connected
clients.

Note: You can backup your providers settings; after setting your parameters and the
fetch is working, save your providers info settings to a file, by clicking the save
button.

To disable or enable providers


1. On the Data Hub machine, run WD_Admin from the Start menu > All Programs
> vizrt > Viz Weather 2 > Weather Database Administration Tool.

Note: Make sure that the Media Sequencer is running, and that the database
connection string is configured and working. See the Configuring Viz Weather
section in the Installation chapter for more information.

2. Select the Providers Info tab.


3. Right-click a provider from the providers list.

36 Chapter 4: Viz Weather Data Configuration


• A context menu will appear, with the option to disable an active provider or
enable a disabled provider.

4.1.3 Associating Providers With Data Types


The Providers list can contain more than one provider, each provider configured
to fetch a different data type.

During a fetch operation, Viz Weather will try to fetch the data using the first
provider configuration. If the fetch fails, it will try with the second provider
configuration, and so on, until fetch succeeds or all the providers failed. In such
cases associating a provider to specific data will reduce overall fetch time and
avoid errors during the fetch process.

A provider can be associated to a data type (Model Data, Radar, and so on) or to a
specific entry in a data type (D2 satellite, US radar, specific point type, and so on).

Setting a Default Provider to a Data Type


In the various data configuration tabs, there is a Provider parameter. If the value
remains empty or set to All Providers, all providers in the list will be used during
the fetch process.

To set a default provider:


1. Open the drop-down list of providers.
2. Select one provider (or more than one in case of Weather Points).
• Now, when fetching this data type only the selected provider will be used in
the process.

Setting a Specific Provider to a Data Type entry


In the various data configuration tabs, there is a Provider column. If the value
remains empty, the default provider will be used during the fetch process.

To set a specific provider


1. Click the Provider column next to the selected entry.
2. A drop-down list of providers will open.
3. Select one provider (or more than one in case of Weather Points).
• Now, when fetching this data entry, only the selected provider will be used
in the process.

4.2 Points Configuration


A point type is a basic entity in Viz Weather. Once a point type was defined, you
can add weather points to the points list. A point type defines a group of Weather
Points which have something in common. The points will share the same data
fields defined in the point type.

A weather point in Viz Weather is a combination of a geographic location and


time. Weather points are grouped in the system in a Point Type.

Chapter 4: Viz Weather Data Configuration 37


This section contains information on the following topics:

• Configuring a Point Type


• Adding a Data Field
• Adding Forecasts
• Adding Weather Points
• Defining Regions
• Forecast Types
• Conversions
• Associating Point Types to Providers
• Fetching Points

4.2.1 Configuring a Point Type

To configure a point type

1. On the Data Hub machine, run WD_Admin from the Start menu > All
Programs->vizrt->Viz Weather 2->Weather Database Administration Tool.

Note: Make sure that the Media Sequencer is running, and that the database
connection string is configured and working. See the Configuring Viz Weather
section in the Installation chapter for more information.

2. Select the Point List Field tab.


3. Click the Edit button next to the Point Type list.
4. The Point Type editor will open.

Note: If running Viz Weather (or Fetch Application) for the first time, or connecting to
a new database, and no point type was defined, the system will produce a warning
and exit. When running WD_Admin for the first time ar with a new database, a
warning will pop and the Add Point type window will automatically open.

5. Click the Add button.


The Point Type Details editor window will open.

38 Chapter 4: Viz Weather Data Configuration


Note: Viz Weather tutorial and most of the demo scenes use a point type named
WeatherPoint. Ift is recomended to create a point type with that name, to be able to
use the demo scenes and tutorial scenes,

6. Enter a point type name to create a new point type.


• The DataPool name field will be populated with the same name defined in
the Point Type Name field. Modify the DataPool name if required.
• DataPool Name: Defines a DataPool structure name to be used by Viz
Weather when sending the point data to Viz. Note that on any point’s fields
change, a new config.dp file has to be exported and copied into the Viz
folder. When using a DataTable or a flat DataObjects list, the DataPool name
will be the prefix of the data structure.

Note: If a change was made to the point’s fields, a popup message, prompting the
user to export the config.dp file, will appear when exiting the WD_Admin. Save the
new datapool config file and copy it to all the viz folders on all the machines (see
Utilities section).

7. Add Default Fields: Point fields define the point attributes (lon, lat, and so on)
and remain fixed. Point Data fields define the data values that will be available
for the each point, according to the defined forecasts. When checked, a set of
predefined point fields and data fields will be created for the point type.
8. Additional Options section:
• Update “Dated” On Manual Change: Select this option if you want the update
date/time of the point type to change when performing a manual change of
values.
• Enabled in Points Filter Editor: Check this option if you want to used the
point type in point filters.
9. Lock Options section: Select whether or not to enable automatic field lock.
• Enable Automatic Field Lock: When checked, any manual change to a point
data field in Viz Weather will automatically lock the changed field. Locked
fields will not be updated by a fetch operation until the lock is manually

Chapter 4: Viz Weather Data Configuration 39


released or the lock expires according to the expiration time set for the
point type.
10. Select one of the options to set an automatic lock expiration.
• Lock Expiration Kind: No Expiration - data fields lock will not expire (only
manually). On System Day Switch - all data fields lock will expire when the
system date changes. On Specific Time - all data fields lock will expire when
the system clock reaches the specified time.
• Last Unlock Was At: Displays the time and date that the last automatic
unlock occurred.
11. Fetch Application section: Select whether or not to enable automatic updates
of DataPool fields in Viz.
• Send DP values to Engines after Fetch: When checked, every time the point
type is fetched, Viz Weather Fetch Application will send updated weather
points information to the defined Viz machines. The Viz machines are
defined under the fetch_application section as a list.
12. Click OK to add the new point type to the list.
13. Click the publish settings button, to apply the changes to all running Viz
Weather clients.
14. Close WD_Admin, a message will prompt to save changes to the datapool
configuration file.
15. Save the file.
16. Copy the datapool configuration file to Viz folder on all the machines running
Viz Engine (including Viz Weather control machines).

4.2.2 Adding a Data Field


When creating a point type, a set of default data fields is created. In many cases,
additional data fields are require, according to the supplied data from the
provider.

To add a data field


1. On the Data Hub machine, run WD_Admin from the Start menu > All
Programs->vizrt->Viz Weather 2->Weather Database Administration Tool.

Note: Make sure that the Media Sequencer is running, and that the database
connection string is configured and working. See the Configuring Viz Weather
section in the Installation chapter for more information.

2. Select the Point Data Field tab.

40 Chapter 4: Viz Weather Data Configuration


To configure additional data columns and customize the point data fields
1. In the Points Data Fields pane, click the Add button to open the Forecast Field
editor.
2. Set the Field name and the Display name.
• The field name will become the column name in the database, the Display
Name is the name used in the UI when using the data table view.
3. Set the field type, text, integer or float.
4. Set the control type that will be used in the UI for displaying the data field.
• Field Type: If Field Type was set to Float, set the round value of the data (the
number of digits after the decimal point).
• Default Width: Sets the default width of the column in Viz Weather UI.
5. Set the DataPool Name, i.e. the data field name that will be used in the
config.dp file, and will be sent to Viz by Viz Weather.
6. Set the source for the Control Type.
7. Set a conversion rule for incoming data.
8. Set the XML tag to be used.
• XML tag: If using a tag, set the tag name. If using an attribute, set *.attribute
Name.
9. Set the XML file to the # (hash) sign or set an XML file name.
• # sign: Will use the main XML defined in the Providers Info tab.
• File: Use this option if using a local XML file only.
10. Click OK

Chapter 4: Viz Weather Data Configuration 41


11. Click the Publish Settings button to apply the changes on all running Viz
Weather applications

4.2.3 Adding Forecasts


The Forecasts option is used for defining time values for a weather point type. A
weather point is represented by a location and the data for a specific time.
Forecast times are defined per point type. Select a point type from the list and set
the required forecasts.

Before setting a forecast, set the Forecast Type in the system. Forecast types are
defined per system and used in all the defined forecasts.

Note: When creating Viz Weather table space and tables, two default forecast types
are defined: Obs (stands for Observation) and Forecast..

To define a forecast
1. In the Forecasts pane click the Add button to open the Forecast editor.
2. Set the forecast name.
3. Select the forecast type (Obs (observation), Forecast or AsDate)
• See the Forecast Types section for additional information about forecast
types.
4. Set the day offset to the correct offset (where zero is today) and the time of
forecast or observation.

42 Chapter 4: Viz Weather Data Configuration


IMPORTANT! When using Obs, always set the Day Offset to -1. When fetching data
for a forecast that is defined Obs, only data with the token “obs” in the XML node will
be fetched.

5. Set a description of the forecast.


• This field is only used by the Viz Weather Database Administration tool
(WD_Admin.exe).
6. Check the Default Forecast check box if this forecast should be the default
forecast displayed when using the points data view.
7. Click OK to add the forecast.
8. Back in the Forecasts pane, select the Forecast Fields to be used for the new
forecast type.
• All checked fields will be displayed in the UI when selecting the forecast
time.

4.2.4 Adding Weather Points


After defining a point type with data fields and forecasts, weather points can be
added to the system. You can import a group of points or add points manually
from Viz Weather UI.

Importing Weather Points

To Import weather points in WD_Admin


1. Select the Utilities tab.
• Click the Import CSV button.
• A file browser will open, select a CSV file and click OK.
• If more than one point type is defined in the system, select a point type from
the list and click OK.
• The points will be imported to the selected point type.
2. Select the Utilities tab.
• Click the Import Points button
• Select a valid Viz Weather XML file and click OK (under <Viz Weather
installation folder>\xml folder) .
• If more than one point type is defined in the system, select a point type from
the list and click OK.
• The points will be imported to the selected point type.

Note: For additional information, see the Utilities section.

To Import weather points in Viz Weather or Viz Weather Fetch Application


1. In the Data Import section, select the Points List tab.
2. Right-click the points list.
3. Select Import CSV from the context menu.
4. A file browser will open, select a CSV file and click OK.
5. If more than one point type is defined in the system, select a point type from
the list and click OK.

Chapter 4: Viz Weather Data Configuration 43


• The points will be imported to the selected point type.

Adding Weather Points in Viz Weather or Viz Weather Fetch Application

To Add a Weather Point


1. Select the Points List tab.
2. Select a point type from the drop-down list.
3. Right-click the points list.
4. Select New Point from the context menu.
• A search window will open.
5. Set a string to search and click the Search button.
6. Select a point from the list and click the Add (or Add and Close) button.
• The new point will be added to the list.

To Add an Empty Point


1. Select the Points List tab.
2. Select a point type from the drop-down list.
3. Right-click the points list.
4. Select New Point (Blank) from the context menu.
• An empty point entry will be added to the points list.
5. Set the point fields to the required values: name, longitude, latitude, and so
on.

Note: See sections Using Viz Weather and Fetch Application for additional
information.

44 Chapter 4: Viz Weather Data Configuration


4.2.5 Defining Regions

The Regions option is used to define a list of countries, regions and sub-regions
in the system. This list will be available in all point types. The regions in the
system are used for filtering the points list display when creating data elements in
Viz Weather.

The Add, Modify and Remove buttons can be used to add new, modify and remove
entries in the selected columns. There is an hierarchy in the system where country
is defined first, then a region in this country, and then a sub region for the
selected region.

Chapter 4: Viz Weather Data Configuration 45


4.2.6 Forecast Types

The Forecast Types option defines global types (Obs, Forecast, and so on) of
forecast times. These types are used in the Forecasts tab to define the time of
data that will be used for the forecast.

The Add, Modify and Remove buttons can be used to add new, modify and remove
entries.

Three default forecast types are defined:

• Type Forecast - If a forecast is defined as a type forecast, the system will use
the current date and the defined days offset to calculate the actual time and
date of the data. The day offset should be zero or higher.
• Type Obs - if a forecast is defined as a type Obs (observation), the system will
look for data records that are defined as observation on the data servers. Day
offset for Obs forecast must be set as -1.
• Type AsDate - if a forecast is defined as a type AsDate, the system will use the
current date and the defined day offset to calculate the actual date and time of
the data. Any value can be used as the day offset of the forecast.

To add a new forecast type


1. Click the Add button.
2. Set the forecast type name.
3. Set the expiration time in seconds.

46 Chapter 4: Viz Weather Data Configuration


• This parameter defines the minimal time gap between two fetch actions that
the points of the selected point type will be updated. That is if a point was
fetched, it will not be fetched again until the expiration time value has past.

4. Click OK.

4.2.7 Conversions

The conversion option is used to define conversion formulas for converting


incoming data. All conversions are of the following format:

Field Data = (Incoming data value * A) + B

The Add, Modify and Remove buttons can be used to add new, modify and remove
entries.

To add a conversion formula


1. Click the Add button to add a conversion formula.
2. Set the conversion name.
3. Set the first parameter (A).
4. Set the second parameter (B).
5. Click OK.

Chapter 4: Viz Weather Data Configuration 47


4.2.8 Associating Point Types to Providers
When using multiple providers to fetch point data, a point type and provider
association is required. The link between point type and provider will reduce fetch
time and prevent the possibility of getting the wrong data from other data
sources.

1. In WD_Admin, select the Point Providers.


2. Set a Global provider for fetching the points by setting the Provider field at the
bottom of the window.
3. To set a specific provider to a point type, click the Add button, a new line will
be added to the list.

4. Open the drop-down list in the Point Type column.


5. Select a point type.
6. Open the drop-down list on the Selected Providers column.
7. Check the providers that are configured to fetch the data fields of the selected
point type.
8. Click the Publish settings button.

4.2.9 Fetching Points


After defining a point type and the provider, weather points information can be
fetched into the system,

To fetch weather points


1. Run Viz Weather or Viz Weather Fetch Application.

48 Chapter 4: Viz Weather Data Configuration


2. Select the Points List tab.
3. Select a fetch option from the drop-down list next to the Fetch button.
4. Select the point type.
5. Click the Fetch button.
6. The Data fields will be filled with the configured information.

Note: If the fetch fails, see Troubleshooting Guide.

4.3 Data Configuration


The Data Configuration section is used for defining the data types in the system.
Every item in the data configuration section defines a list of data and links the
data to the Providers Info list. The data configuration will customize the menus
and options in the Data Import pane (see Working with Meteorological Data) and
the Fetch Application. Select a tab to configure the values.

Note: Using this option requires a password. See Weather Data Suppliers description
on how to set a password value.

Note: The SampleFiles folder contains various files of satellite settings, radar
settings, and so on. These can be loaded to Viz Weather as an example or for
running demo materials.

This section contains information on the following topics:

• Model Data Configuration


• Imagery Configuration - Radar and Satellite
• Other Data Configuration

Chapter 4: Viz Weather Data Configuration 49


4.3.1 Model Data Configuration
Model Data is a forecast of meteorological information, described as a grid. The
data is downloaded and processed during the fetch action.

Model data configuration files are provided by the data provider and loaded into
the system. Download the file to the local disk and load the configuration
according to the steps below.

Sample Model data configurations are installed by Viz Weather installer. The files
are located under the <Shared Configuration>\SampleFiles\Providers
folder.

To configure model data


1. Click the Load button.
• A file browser will open in the <Shared
Configuration>\SampleFiles\Providers folder.

2. Select one of the files and click OK.


• The available model data from the selected provider will be loaded.

Note: Model Data configuration files are usually named ServerConfig.xml. The
sample files were renamed so it will be easier to identify them.

50 Chapter 4: Viz Weather Data Configuration


3. Right-click a model data to set a provider for fetching the data.
• A list of the available data providers will open.
4. Select a provider for fetching the model data.
5. Click the Publish setting button to apply changes in all running Viz Weather
clients.

To Fetch Model Data


1. Run Viz Weather or Viz Weather Fetch Application.
2. Select the Fetch tab from the Data Import section.
3. Add a new fetch profile or open a fetch profile for editing.
4. Check the Model Data Forecast section.
5. Click the ... button.
The Model Data Forecasts window will open.
6. Enable the required sub-models of each model.
7. Click OK to close.
The Model drop-down list will become enabled.
8. Select the which models to fetch.
9. Set the Time range of data to be fetched.
10. Click OK to confirm and save the changes.
11. Select the fetch profile and click the Fetch button.

Chapter 4: Viz Weather Data Configuration 51


4.3.2 Imagery Configuration - Radar and Satellite
Radar and satellite images are loaded to the provider’s server in regular intervals.
The imagery is fetched and displayed in Viz Weather.

Radar and Satellite are configured in the WD_Admin by setting the images path on
the server and the local folder under the <Shared Data> folder. A projection file
is also defined for every image type, to enable a correct mapping of the image
over maps.

Sample satellite and radar configurations are installed by Viz Weather installer.
The files are located under the <Shared
Configuration>\SampleFiles\Satellite and <Shared
Configuration>\SampleFiles\Radar folders.

The following procedure refer to satellite images. The same steps apply for radar
images.

To Configure a Satellite/Radar from file


1. Click the Load button.
2. A file browser will open in the <Shared
Configuration>\SampleFiles\Satellite folder.
3. Select one of the files and click OK.
4. The available satellite settings from the selected provider will be loaded.
5. Select a provider from the drop-down list at the bottom of the window, to set
a specific provider for fetching the satellite imagery.

52 Chapter 4: Viz Weather Data Configuration


6. Click the provider column to set a specific provider for fetching the satellite
defined in that line.
7. Set a Pre Process command in the pre process command field. A pre process
command is an application that will go over the images before loading them in
Viz Engine.
8. Click the file browser button to select a command from a file list.
9. Click OK to confirm and close the file browser.
10. Check the Pre Process Command column next to a satellite, to apply the pre
process command.
11. Click The Pre Process Command column to set a specific command for the
satellite defined in that line.

To manually configure a satellite/radar


1. Click the Add button.
• A new line will be added to the list.
2. Set the Display Name to the name that will appear in the Area drop-down list
of the UI.
3. Set the Local Folder to the location of the images on the disk, under the
<Shared Data>\Satellite (or Radar).
4. Set the FTP Folder to the location of the images on the FTP.
• The entry can be a full path to a folder including the FTP address or a folder
name under <ftp_root>\Satellite. <ftp_root> is defined in the
Providers Info tab. If the providers setting and the FTP folder column include
an FTP path, the satellite FTP folder configuration overrides the Providers
Info settings.
5. Set the VGR File to use with the images.
• A VGR is Viz geographical reference file. This file contains the projection
information of the images. Viz Engine uses this information to place the
image over the map/terrain correctly.
• The column VGR defines which VGR file is used when fetching the images.
For every image being fetched, a copy of the vgr file, renamed like the
image, will be saved in the images folder. If no file is defined then Viz
Weather will use the VGR files from the folder containing the radar images.
If a file is defined Viz will use the projection in that file to place the images
over the maps and terrains.

Note: VGR files should be placed in the <Shared Configuration>\Projections


folder.

6. Optional: Select the Pre Process check box.


• When selected, defines if the satellite images will be processed by an
external application before sent to Viz to be displayed. This column is valid
only if the external application is defined in the Pre Processing Cmd field or
in the Pre Process command column next to it. If the check box is checked
next to a satellite type,
• Viz Weather will use the pre processing command when loading graphics
using the specified radar (note that in order to use this column, changes in
the graphic template are required).
7. Select a Provider from the drop-down list at the bottom of the window, to set
a specific provider for fetching the satellite imagery.
8. Click the Provider column to set a specific provider for fetching the satellite
defined in that line.

Chapter 4: Viz Weather Data Configuration 53


9. Click the Publish Settings button to apply changes on all running Viz Weather
clients.

Each added entry will show as an item in the Area drop-down list in the Fetch
Profile editor (see the Working with Meteorological Data section).

When a fetch operation is performed the images will be downloaded from the FTP
folder to the local folder.

4.3.3 Other Data Configuration


Viz Weather supports additional meteorological data formats. This section
explains how to configure other data types and formats:

• Fronts Configuration

Fronts Configuration

The Fronts tab is used to configure types of fronts to be used in the system. The
default fronts are Hot, Cold and Occluded, but the need for additional graphics
representation of fronts has been expressed. The defined front types will be
displayed in the front type drop-down list, in the fronts editor.

54 Chapter 4: Viz Weather Data Configuration


To configure storm path forecasts

The Storms tab is used to configure entries for downloading storm path
information (hurricane, typhoons, and so on) to be used in the system.

1. Click the Add button.


• A new line will be added to the list.
2. Set the Display Name to the name that will appear in the Area drop-down list
of the UI.
3. Set the Local Folder to the location of the files on the disk, under the <Shared
Data>\NewStormPath.
4. Set the FTP Folder to the location of the files on the FTP.
• Set a full path to a folder including the FTP address.
5. Select a Provider from the drop-down list at the bottom of the window, to set
a specific provider for fetching the storm path files.
6. Click the Provider column to set a specific provider for fetching the storm path
defined in that line.
7. Click the Publish Settings button to apply changes on all running Viz Weather
clients.

Each added entry will show as an item in the Area drop-down list in the Data
Import pane (see Working with Meteorological Data), and the Fetch Application.

When a fetch operation is performed the files will be downloaded from the FTP to
the local folder.

Chapter 4: Viz Weather Data Configuration 55


To configure miscellaneous information

The Misc Info tab is used to configure different miscellaneous information


sources to be used in the system using the following parameters:

1. Click the Add button.


• A new line will be added to the list.
2. Set the Display Name to the name that will appear in the Area drop-down list
of the UI.
3. Set the Local Folder to the location of the files on the disk, under <fetch Dest
folder>\NewMiscInfoPath.
• The name defined in the Local Folder parameter will be used to create a sub
folder under <fetch Dest folder>\NewMiscInfoPath.
4. Set the FTP Folder to the location of the files on the FTP.
• The entry can be a full path to a folder including the FTP address or a folder
name under <ftp_root>. <ftp_root> is defined in the fetch_parameters.ini
file. If the INI file and the FTP folder column include an FTP path, the Fetch
Configuration overrides the INI file settings.
5. Click the Publish Settings button to apply changes on all running Viz Weather
clients.

Note: A local folder name (full or relative path) can be used if the files are stored on
a local or network drive.

56 Chapter 4: Viz Weather Data Configuration


Each added entry will show as an item in the Area drop-down list in the Data
Import pane (see Working with Meteorological Data), and the Fetch Application.

When a fetch operation is performed the files will be downloaded from the FTP
folder to the local folder. Changes will take effect after Viz Weather is restarted.

To configure Cloud Forecast

The Clouds Forecast tab configures the different clouds data sources:

1. Click the Add button. A new line will be added to the list.
2. Set the Display Name to the name that will appear in the Area drop-down list
of the UI.
3. Set the Local Folder to the location of the cloud files on the disk, under the
<Shared Data> folder.
4. Set the FTP Folder to the location of the forecast files on the FTP.
• The entry can be a full path to a folder including the FTP address or a folder
name under <ftp_root>. <ftp_root> is defined in the Providers Info tab. If
the Providers Info and the FTP folder column include an FTP path, the cloud
forecast Configuration overrides the Providers Info settings.
5. Set the Plug-in Index to 17 (geo ref).
6. Set the VGR File to use with the cloud forecast files.

Chapter 4: Viz Weather Data Configuration 57


• A VGR is Viz geographical reference file. This file contains the projection
information of the images. Viz uses this information to place the image over
the map/terrain correctly.
• The column VGR defines which VGR file is used when fetching the images.
For every image being fetched, a copy of the vgr file, renamed like the
image, will be saved in the images folder. If no file is defined then Viz
Weather will use the VGR files from the folder containing the radar images.
If a file is defined,
• Viz will use the projection in that file to place the images over the maps and
terrains.

Each added entry will show as an item in the Area drop-down list in the Data
Import pane (see Working with Meteorological Data), and the Fetch Application.

When a fetch operation is performed the files will be downloaded from the FTP to
the local folder.

Note: After Viz Weather is restarted the changes will take effect.

To configure WP Grid Types

The WP Grid Types tab configures weather point types, derived from model data
types in the system. These weather point types get the point values from the
defined model and are not effected by the point types in the database.

1. Click the Add button on the left.


A new line will be added to the list.
2. Set the Display Name to the name that will appear in the Area drop-down list
of the UI.

58 Chapter 4: Viz Weather Data Configuration


3. Click the Model field in the added line.
A drop-down list will open, containing all the available model types in the
system:

4. Select the required model.


5. Click the Add button above the right pane of the screen.
A new line will be added to the list.
6. Click the Name field of the added line.
A drop-down list with the available sub-models of the defined model on the
left pane will appear.

Chapter 4: Viz Weather Data Configuration 59


7. Select the required sub-model.
8. Set the DataPool field name to be used for this WP Grid point type.

Each added entry will show as an item in the WP Grid editor, in the Grid Models
field (see Working with Meteorological Data).

Note: Viz Weather must be restarted for thsee changes totake effect.

4.4 Tools
This section contains information on the following topics:

• Utilities
• Active Sessions
• DB Connection

60 Chapter 4: Viz Weather Data Configuration


4.4.1 Utilities

The Utilities tab enables the user to add data to the system from external files,
manipulate data in the system and to export information to be used by Viz and
Viz Weather.

• Import Points from W1: When clicked, a file browser will open that will allow
you to browse and select a valid Viz Weather XML file (a file used by Viz
Weather 1.x.x versions). By selecting a point type from the list displayed the
weather points from the Viz Weather XML file will be imported to the selected
Points Type.
• Import Forecast Types: When clicked, a file browser will open that will allow
you to browse and select a valid forecast type XML file. The forecast types
from the XML file will be imported to the database.
• Import CSV: This option enables you to import points from a comma separated
file. When clicked, a file browser will open that will allow you to select the CSV
file to import.

IMPORTANT! NAME,COUNTRY,REGION,SUBREGION,SEARCHID,LONGITUDE,LATITUDE
,HEIGHT,VIZID
Name1,Country1,,,SearchID1,Longitude1,Latitude1,,
The column headers of the file must use the same name as defined in the system
and should also be comma separated. Files must be saved in UTF8 format if using
Unicode or UTF8 characters.

Chapter 4: Viz Weather Data Configuration 61


• Export Config.dp: When clicked, a file browser will open that will allow you to
browse to the Viz folder in use. A DataPool configuration file will be created, at
the designated path containing all the point type fields structure.
• The exported file should be copied (or exported again) to all Viz Engine
machines used by Viz Weather.
• The file structure represents the additional columns and point types in the
database as DataPool fields structure. The data from vIz Weather will be
sent to VIz in the same format.
• Copy Name to VizID: This option will duplitace the points name into the VizID
field for the selected point type. When clicked, a point types list will open.
Select the required point type, the OK button will be enabled. Click OK to
complete the operation.
• Resort Forecasts: When clicked, the forecasts list will be sorted by day offset
and time (low to high).
• Export Database: When clicked, a file browser will open for selecting a target
folder. When selected, a database snapshot will be created (the entire
database structure and data will be exported).

IMPORTANT! The export option uses the Oracle EXP command. This option will only
work on the server or by using an Oracle 10g Administrator client.

• Export Points Dictionary: Points dictionary is a file containing an index of the


weather points names and database IDs.
• The database point ID is a unique number (key) representing the point in
the database.
• A dictionary file is created for every Point Type in the system, using the
following naming convention: Dictionary_<point type name>.xml.
• When the data is sent to Viz, the ID string is the identifier used to set the
data objects in the scene.
• The export dictionary button will export all points in and all forecasts in the
format of an XML file.

Example XML of an exported dictionary:

<PointTypes>
<PointType>
<ID>5</ID>
<Name>Forecast</Name>
<Points>
<Point>
<ID>289</ID>
<Name>Fairbanks</Name>
<State>AK</State>
</Point>
<Point>
<ID>290</ID>
<Name>Huntsville</Name>
<State>AL</State>
</Point>
</Points>
<Forecasts>
<Forecast>
<ID>9</ID>
<Name>Today</Name>
</Forecast>
</Forecasts>
</PointType>
</PointTypes>

62 Chapter 4: Viz Weather Data Configuration


• Symbol Conversion: This drop-down field defines the system behavior during
fetch of symbol data and when sending the symbol values to Viz Engine. In
newly installed systems the selected option is None.
in upgrades from older versions, the option is set to Both, for backward
compatibility. This parameter is global in the system.

4.4.2 Active Sessions

The active sessions tab displays a list of all clients connected to the database.
When running WD_Admin.exe, this will be the first tab to be displayed. If any
clients are connected to the database, a warning will be issued.

Note: Changing the database structure will effect all users and clients. Currently
connected clients might experience abnormal behavior if changes are made during a
running session.

Chapter 4: Viz Weather Data Configuration 63


4.4.3 DB Connection

The DBConnection option is used for configuring the database connection string,
and consequently connect the Viz Weather Database Administration (DBA) tool to
the Oracle database.

• Connection String: This connection string is set in the initialization file (see
the Application Level Settings section), under the [WD_SERVER] section. The
connection string includes a set of values required to connect to the database:
• Provider: Database application type and ODBC used for connection.
• User ID: User name for the connection.
• Password: Password for the defined user name.
• Data Source: Name of the database instance (machine name\instance
name).
• Database Type: Displays the type of the connected database.

Note: In Viz Weather version 2.4, the option to store the connection string in the
Media Sequencer server was added. If the entry is found in the Media Sequencer
server or if the [WD_SERVER] section is missing from the INI file, all connected clients
will use the same connection string from the server. If the WD_SERVER section is
missing from the INI file and no connection info is found on the Media Sequencer
server, you will be prompted to define a connection string. Run WD_Admin and set
the connection string. Once defined, it will be saved on the Media Sequencer server,

64 Chapter 4: Viz Weather Data Configuration


To change the connection string
1. Click the ellipse (...) button next to the Connection string field to open the
Microsoft ODBC configuration tool.
2. Select and set the required configuration options and parameters and test the
connection.
3. Close the ODBC tool.
4. Click the Save configuration button to save the Viz Weather DBA tool to save
the changes to the INI file (see the Application Level Settings section).

If the configuration changes are not saved, a dialog box asking for changes to be
saved will appear when the Viz Weather DBA tool is closed.

4.5 Configuring a Demo Supplier


Viz Weather has access to two providers, using a demo account: Storm and
Custom Weather. Note that using this option requires a special license. Ask for a
Viz Weather demo fetch license and apply it to your Viz Engine dongle.

The SampleFiles folder contains various files of satellite settings, radar settings,
and so on. These can be loaded to Viz Weather as an example or for running
demo materials.

The following sections will explain how to configure one of the suppliers for a
demo:

• Setting Up Storm as a Demo Provider


• Setting Up Custom Weather as a Demo Provider

IMPORTANT! Make sure you installed Viz Weather and made the basic configuration.
See the Installation chapter for additional information.

4.5.1 Setting Up Storm as a Demo Provider

To setup Storm as a demo provider


1. Run WD_Admin.
2. Select the Providers Info tab.
3. Click the Load button.
A file browser will open.
4. Select the file Storm.Providers.xml.
The provider settings will be loaded.
5. Click the Apply button.
6. Select the Model Data tab.
7. Click the Load button.
A file browser will open.
8. Select the Storm.server.xml and click OK.
The model data models list will be loaded.
9. Click the Publish Settings button.
10. Select the Satellite tab and click the Load button.

Chapter 4: Viz Weather Data Configuration 65


A file browser will open.
11. Select the Storm.Satellite.xml file and click OK.
A list of satellites will be loaded.
12. Click the Publish Settings button.
13. Repeat steps 10 to 12 with the Radar tab.

Note: To fetch new data, set a fetch profile in VIz Weather or Viz Weather Fetch
Application and click the Fetch button.

4.5.2 Setting Up Custom Weather as a Demo Provider

To setup Custom Weather as a demo provider


1. Run WD_Admin.
2. Select the Providers Info tab.
3. Click the Load button.
A file browser will open.
4. Select the file CustomWeather.Providers.xml.
The provider settings will be loaded.
5. Click the Apply button.
6. Select the Model Data tab.
7. Click the Load button.
A file browser will open.
8. Select the CustomWeather.server.xml and click OK.
• The model data models list will be loaded.
9. Click the Publish Settings button.
10. Select the Satellite tab and click the Load button.
A file browser will open.
11. Select the CustomWeather.Satellite.xml file and click OK.
A list of satellites will be loaded.
12. Click the Publish Settings button.
13. Repeat steps 10 to 12 with the Radar tab.

Note: To fetch new data, set a fetch profile in VIz Weather or Viz Weather Fetch
Application and click the Fetch button.

66 Chapter 4: Viz Weather Data Configuration


5 Viz Weather System Configuration
Viz Weather uses two levels of configuration:

1. System Level Settings, shared by all Viz Weather applications connected to the
same Media Sequencer. These settings are defined via the Settings > System
menu item.
2. Application Level Settings are defined in the viz_weather.ini file. These
settings will be loaded every time an application is launched and will not have
an effect on other applications running on other client machines in the same
environment.

This section contains information on the following topics:

• System Level Settings


• Application Level Settings

5.1 System Level Settings


Figure 3: Settings menu items

Note: Using the System Configuration option requires a password. See the
Application Level Settings section for a description on how to set a password value.

The System Settings window is used for defining parameters that are common to
all weather applications running in the same environment. These settings are
saved in the Media Sequencer default.xml file.

Note: The weather configuration file (viz_weather.ini file) is used by Viz Weather
applications to define local settings.

Select an item in the navigation pane (left side of the window) to view and edit the
related parameters.

This section contains information on the following topics:

• Concepts and Folders


• Playlist Defaults
• Post and Snap
• Playlist
• Calendar
• GPI/BBox
• VDCP
• MOS

Chapter 5: Viz Weather System Configuration 67


• VCP Integration
• Weather Data Hub
• Media Engine
• Miscellaneous

5.1.1 Concepts and Folders

The Concepts & Folders configuration tab enables the user to manage Viz
concepts (Graphic templates), data elements folders, and playlist folders.

• Data elements Folders: Organizes the saved data elements into folders,
allowing a filtered view of the data elements list and quicker access to data
elements.
• Playlist Folders: Organizes playlists in groups (where a folder is a common
attribute of a group) allowing a filtered view and quicker access to playlists.
• Concepts: Define sets of graphic templates, arranged in different folders, that
use the same template name and functionality, but have different designs. The
user can use the same playlists with a different graphic look by selecting the
required concept (graphic variant).

Example: When using the same weather playlist for different shows during the day,
the colors of the graphics can easily be changed to match the show’s look and color.
This is done by selecting the required concept from the drop-down list and
initializing the playlist, without making any other changes.

68 Chapter 5: Viz Weather System Configuration


5.1.2 Playlist Defaults

This Playlist Defaults tab defines default properties that will be assigned to newly
created playlists.

• Transition has the following properties and parameters:


• Default Transition: Defines a default transition that will be used to
transform from one data element to the other while playing the playlist.
When clicking the transition icon, the transitions window will open. Select a
transition from the list and click OK to confirm. From the drop-down list,
select how the transition duration will be calculated:
• Set in scene: Sets the transition duration to be the duration of the animation
in the transition scene.
• Automatic after X seconds: Manually set the duration for the default
transition by typing a value into the Time field.
• Prepare Ahead has the following properties and parameters:
• Enable prepare ahead: Defines if the prepare ahead mechanism will be used
when initializing and playing the playlist. When enabled, set the number of
elements to be prepared in the numeric text field.
• Activate Timer: Defines the time intervals between fetch operations when
using the Prepare Ahead feature. Default value is 180 seconds (3 min).
When checked, the time interval will be set to the value in the numeric field.

Note: The timer for prepare ahead intervals is used when a playlist is initialized or
played, and the time since the last play action is larger the timer value.

Chapter 5: Viz Weather System Configuration 69


• Prepare Ahead Offset: When prepare ahead is used, this parameter defines
the first data element that will be prepared counting from the currently
played data element. Minimal value is 2.
• Prepare ahead Specific Features: This section is used to define which
features in the playlist will be fetched/updated when prepare ahead
operation is performed: Select Points if weather points in the playlist should
be fetched and updated. Select Images if images in the playlist (radar or
satellite) should be fetched or updated. Select Live update (this option is
enabled only if Update is checked) if the playlist should update in real time,
i.e. every time a new image is fetched it will be loaded to the playlist (even if
the current data element will update while playing). Select Model Data will
force rebuild of model data frames when playing the playlist.
• Initialization has the following properties and parameters:
• Optimize: Defines if the playlist will be optimized during initialization.
• Auto update Data Elements: In a multiple client environment if one client
modified a data element used in a playlist that is played by another client,
the data element will be automatically updated when it is played. This
option is used only in an optimized playlist with optimized data elements
using in scene points.
• Iteration has the following properties and parameters:
• Iterate: Defines if the playlist will be played once or played in a loop, during
automatic playout.
• Channels define additional engine machines used in the playlist. The channels
are initialized and played with the other playlist layers. the available Channels
are derived from the machines list, defined in the viz_weather.ini file.

Note: For more information see the Playlist Properties section.

70 Chapter 5: Viz Weather System Configuration


5.1.3 Post and Snap

The Post & Snap tab is the configuration interface for playlist and data element
post rendering and snapshot rendering by Viz.

Post render parameters relate to video clips of the data elements. The clips are
rendered in a format defined by the render device declared in Viz. If no render
device is defined in Viz, clips will not be rendered and a warning message will be
issued when trying to create clips.

Snap images parameters relate to rendered images of the data elements. The
image of the render window (snap image) is created from one frame of the data
element. If no special keyframe along the animation is defined as the frame to be
rendered, the first frame of the data element will be used.

• Machine defines if the snap images or clips of the selected items will be
rendered on the Program machine or on the Preview machine. If Program is
selected, make sure that the path defined has sufficient permissions to create
the clips and images.

Note: It is advised to use a shared network drive as the default directory when using
Program as the render machine.

• Post Render Parameters has the following properties and parameters:


• Default Directory: Sets the default path for where rendered files will be
saved.

Chapter 5: Viz Weather System Configuration 71


• After Clip Command: Defines a system command that will be executed after
the clip was created. The command can be any program or script, including
launch flags (click the “i” button, next to the text field, for additional syntax
information). Viz Weather will launch the given application and continue
without waiting for the application to end.

Note: After Clip Command will always run on the localhost machine (Preview).

• Sub Folder: When a Playlist is post rendered, the clips will be saved in a sub
folder under the defined Default Directory. Select the name format of the
sub folder that will be created by Viz Weather or select “None” to save the
clips under the Default Directory. If Custom is selected, an additional text
field will be enabled. Define a custom format for the sub folder name, using
constant characters and special tags (click the “i” button, next to the text
field, for additional syntax information).
• Name: Defines a name format for the rendered clips. If Custom is selected,
an additional text field will be enabled. Define a custom format for the sub
folder name, using constant characters and special tags (click the “i” button,
next to the text field, for additional syntax information).
• Snap Parameters has the following properties and parameters:
• Default Directory: Sets the default path to in which the rendered images will
be saved.
• After Image Command: Defines a system command that will be executed
after the image was created. The command can be any program or script,
including launch flags (click the “i” button, next to the text field, for
additional syntax information). Viz Weather will launch the given application
and continue without waiting for the application to end.

Note: “After Image Command” will always run on the localhost machine (Preview).

• Sub Folder: When a Playlist is snapped, the images will be saved in a sub
folder under the defined Default Directory. Select the name format of the
sub folder that will be created by Viz Weather or select “None” to save the
images under the Default Directory. If Custom is selected, an additional text
field will be enabled. Define a custom format for the sub folder name, using
constant characters and special tags (click the “i” button, next to the text
field, for additional syntax information).
• Name: Defines a name format for the rendered images. If Custom is
selected, an additional text field will be enabled. Define a custom format for
the sub folder name, using constant characters and special tags (click the “i”
button, next to the text field, for additional syntax information).
• File Format: Sets the default file format for the snapped images.
• Type: Sets the default file type for the snapped images.
• Load Viz 3 Post Devices from file: load post devices for Viz 3. The post devices
are used for generating clip files in Viz Weather.
• Load Viz 3 Live Post Devices from file: load live post devices configuration for
Viz 3. The live post devices are used for live recording of Viz Weather video
output.

72 Chapter 5: Viz Weather System Configuration


5.1.4 Playlist

The Playlist tab is for configuration of parameters that are used for customizing
the user interface (UI).

• Initialize Button:
• Default Action: Opens a drop-down list where you can select one of the
following options as default:

a. Initialize (all un-initialized items)


b. Clear + Initialize
c. Fetch + Initialize
d. Fetch + Clear + Initialize

• Lock: The Playlist Lock flag is used in multiple Viz Weather applications
environment. If the Playlist Lock is checked, a locking mechanism will be used,
preventing multiple clients from editing the same playlist simultaneously. The
playlist “Save” and “Save As” options will be enabled and any changes will
require the user to save the playlist. If Playlist Lock is not checked, multiple
clients can edit the playlist and the changes are applied automatically. The
playlist “Save” and “Save As” options are disabled.
• Cursor: Defines the playlist cursor position when running a playlist. The
default behavior is that the cursor advances to the bottom of the playlist
window and then when advancing the playlist, the data elements will advance
and the playlist cursor will remain at the bottom of the playlist area. When
“User Defined playlist cursor” is checked, the playlist cursor will advance to the
position, in the playlist area, which is defined by the percentage from the
playlist area height, and continue advancing the playlist elements in the
playlist area while keeping the same position.
• Transitions: The Transitions flag replaces the configuration file entry for the
transitions folder. To use the transitions folder as a global parameter in the
system (for all connecting clients), select the check box and click the folder
button to select the transitions folder from Viz scene database.

Chapter 5: Viz Weather System Configuration 73


5.1.5 Calendar

The Calendar configuration tab defines time and date related parameters.

• Day Switch: Defines the time that the date/day will advance:
• On Time: Day will advance at 00:00 system time.
• Earlier: Day will advance at the defined time in the current system day (i.e.
the date will change before 00:00 system time).
• Later: Day will advance at the defined time in the next system day (i.e. the
date will change after 00:00 system time).

Note: This option effects the playlists with auto update defined or prepare ahead
when using images and iso data. It will not effect the points data.

• Include Week Days: This option will add the week days to the relative time
range list. This option allows the user to define a fetch time range or a data
element time range relating to absolute week days and not day count (Day+1,
and so on). The Display Name column is editable and supports Unicode to
enable localization and customization of the day name entries.

74 Chapter 5: Viz Weather System Configuration


5.1.6 GPI/BBox

The GPI/BBox tab is used for configuring external devices that may trigger Viz
Weather actions:

• Load Device Settings From File: Click the button to load a pre-configured
device file. A file browser will open in the
SharedConfiguration\SampleFiles\GPI-BBox folder. Select the required
device file and click OK. The device settings will be loaded to the system.
• Device Settings: : When enabled, the external device is active and the system
actions can be triggered from the device.
• Device Information: After loading a device settings file, check this section to
see the device information.
• Status: Displays the status of the connected device.
• System Triggers: This feature is used for configuring what action will be
triggered by which trigger number. For every trigger that is used, select the
required action from the drop-down list.

Note: The GPI box/Button Box should be connected with a serial 9 pin cable to COM1
port of the machine running Viz Weather.

Chapter 5: Viz Weather System Configuration 75


5.1.7 VDCP

VDCP is a common protocol used in the broadcast industry. The protocol is based
on a serial connection between the machines, using the COM port.

• Enable the VDCP connection.


• Port: defines which port number is used to connect the controlling machine.
Default value is COM4.
• Playlists Folder: the name of the playlists folder that the VDCP can control. If
the Playlists Folder’ parameter is disabled (un-checked), all the playlists in all
folders will be subject to VDCP control.
• Load Commands From File: Press the button to set predefined VDCP
commands in the system.

Note: When sending VDCP commands to Viz Weather, playlist names is case
sensitive.

IMPORTANT! Playlist name is limited to 8 characters when used with VDCP.

76 Chapter 5: Viz Weather System Configuration


5.1.8 MOS

The MOS configuration tab is used to define connection to Viz Gateway and to a
Viz Content Pilot Database when Working in Integrated Environments.

After defining the database parameters click the Apply button to start the
connection and save the settings.

After defining the Viz Gateway parameters click the start button to initialize the
connection.

Note: The MOS configuration tab is enabled only if the viz_weather.ini file contains a
MOS section and MOS is enabled. A Database section in the viz_weather.ini file is
required as well. See the viz_weaher.ini chapter for additional details.

Chapter 5: Viz Weather System Configuration 77


5.1.9 VCP Integration

Viz Content Pilot (VCP) is a Vizrt control application for graphics and video
playout that may be used in conjunction with Viz Weather, utilizing VCP’s
database to store Viz Weather data elements.

• Enable: Enables storing of Viz Weather data elements to the VCP’s database.
• Name: Alias name or connect string for connecting to the data base.
• User: database user name (usually pilot).
• Password: database password (usually pilot).
• Schema: Leave blank. Name of the Schema used by Viz Content Pilot.
• Load Viz Weather Template For VCP From File: Perform this operation once
after installing and configuring Viz Weather/VCP integration. When this button
is pressed, a template named viz_weather2 will be created in the VCP
database. When saving a data element, the template will be stored with the
data in the database.

78 Chapter 5: Viz Weather System Configuration


5.1.10 Weather Data Hub

The Weather Handler configuration tab is used to define the Weather handler
(plugin) in a Media Sequencer. The handler is defined on any machine running the
Media Sequencer and Viz Weather will use the definition to perform remote fetch
operations.

• Host: name or IP address of the machine runninig the Media Sequencer.


• Port: Port number to be used.
• Check Connection (button): Checks the connection using the host and port
connection parameters.

Note: Use port number 6112 for Viz Weather or port 6113 for Weather Fetch
application.

5.1.11 Media Engine


The Media Engine tab defines a connection to the Viz One server in your system.

The settings for the Media Sequencer are based on the settings used by Viz Object
Store (VOS) and automatically configured during installation of Viz Content Pilot
(VCP).

• Export To VME: Enables export of video clips to Viz One.

Chapter 5: Viz Weather System Configuration 79


• VME Drop Box: Sets a folder name that the clips will be saved to. The folder is
shared and monitored by the Viz One.
• Load Metadata Template: Loads a Viz One metadata template from file. The
template data will be used when the clip is saved.
• Enable Media Engine handler: This option will enable the Media Sequencer
handler and set the connection to the Viz One. Once the configuration is
complete, the user can combine media from the Viz One in a Viz Weather
playlist or data elements. Set the service document URI, user name and
password of the Viz One server, and apply the changes.

Note: Additional configuration is required on the Viz One Server side and on the Viz
Engine machines used for playing the Viz One media elements.

See Also
• Viz One Administrator’s Guide
• Viz Content Pilot User’s Guide

5.1.12 Miscellaneous

The Misc configuration tab is used to load additional system settings from files:

• Load Gateway Definitions From File: Click the button to open the file browser
and locate the Viz Weather Gateway definitions file.

80 Chapter 5: Viz Weather System Configuration


• Search Points: This parameter configures the maps server and the language
used for point searches in Viz World Maps Server. Select the required language
from the drop-down list. This parameter is reflected in the Search Point
window, when adding a new weather point to the database.
• Maintenance:
• Clear all playlists logic names: Click this button to reset the play device logic
names.

5.2 Application Level Settings


The following section describes the sections and parameters in the Viz Weather
initialization (INI) file. The installation will include files with default values,
enabling the application to launch. The one important parameter to set is the
database connect string, which is set after running the WD_Wizard.

The configuration files are set after the installation. When running in a multiple
client environment, the same files can be shared by all Viz Weather applications
by using the launch flag: -inifile <File_path>.

IMPORTANT! When upgrading Viz Weather, select the option Upgrade and keep user
configuration to avoid the installation of new configuration files over the files in use.

Table 1:

Section Parameter Description

[ANIMATIO
NS]

pal_ntsc= Defines the system’s video mode PAL or


NTSC

transitions_enabled=y transitions_enabled is a flag for


enabling/disabling the usage of scene
transitions in Viz Weather. If the flag is
enabled, valid transition scenes must
reside under the folder defined in
transitions_dir parameter. If omitted,
default value is y

transitions_dir=SCENE transitions_dir is the path to a folder in


*transitions viz Data Root Directory containing the
transition scenes. NOTE: use "/"
character when path is more than one
level folders. If omitted, default value is
SCENE*transitions

[VDOM]

mse_silent_connect_tr Defines the number of times Viz


y_count=0 Weather will try to connect to the
defined Media Sequencer.

Chapter 5: Viz Weather System Configuration 81


Table 1:

Section Parameter Description

backup_interval= Intervals between backups, in hours.

[DATA]

city_database_path= Relative or full path to city locations


files. The files contain city names and
their long/lat position.

[VIZ]

viz_version= Values are 2 and 3. Default is 2.

dir= The initial scene folder in Viz Engine


that will be opened for browsing when
selecting the graphic templates menu.

images_dir= The initial images folder in Viz Engine


that will be opened for browsing when
using the images editor.

on_air_machine= The name of the machine running viz


(rendering the video). If empty, default
is localhost.

snap_image_custom_si The size of the snap image that will be


ze= created while requesting SNAP image
example: 100x100

on_air_timeout=300 defines the timeout (connection loss) to


the on-air machine, in seconds, before
popping an error message about
connection timeout. If omitted, default
value is 300 seconds (5minutes).

preview_timeout=300 defines the timeout (connection loss) to


the preview machine, in seconds,
before popping an error message about
connection timeout. If omitted, default
value is 300 seconds (5minutes).

on_air_preview_disable In a program/preview setup, using two


= computers, defines if the preview
machine will render the preview scenes
(saves time when loading a Playlist)

machine1= Name of the program machine. The


machine2= names of the machines will appear in a
drop-down list when changing a
machine3= machine from the configuration menu.

82 Chapter 5: Viz Weather System Configuration


Table 1:

Section Parameter Description

force_UTF8=n Force the Viz machine (program and


preview) to use UTF8 encoding. Values:
y or n. If omitted, default value is n.

launch_flags= Define additional flags for running viz.


Current flags (un-configurable) used by
Viz Weather when launching viz are: -n
-M -P –W -Q. The defined flags will be
added to these flags.

custom_height User defined renderer height (in pixels).


Default values are derived from PAL/
NTSC definition.

custom_width User defined renderer width (in pixels).


Default values are derived from PAL/
NTSC definition.

close_scene=y Defines if a scene will be closed when


initializing a non optimized playlist.
Enabling this flag can lead to better
memory usage but will slow the init
process of a playlist.
If omitted or empty, default value is n.

use_play_separator=n Defines the separator used for Viz


playlist.

video_wall_enabled=n Defines if Viz Weather is using Viz


Video Wall as it’s main engine.

[PREPARE_A
HEAD]

use_prepare_ahead_tc use_prepare_ahead_tcp defines if the


p= prepare ahead process will use the local
fetch application to fetch the needed
data (If yes then Viz Weather will launch
and kill the fetch_application). If
omitted or empty, default value is n.

[CONFIG]

show_confirm_on_exit show_confirm_on_exit defines if viz


=y Weather should confirm with the user
before exit the application. If omitted or
empty, default value is y.

Password= Password for using configuration


editors in the configuration menu.
Default password is “admin”. If an
empty password is specified, no
password dialog will be displayed.

Chapter 5: Viz Weather System Configuration 83


Table 1:

Section Parameter Description

font_name= Defines an alternate font for the UI.

font_size= Defines the UI font size.

[MISC]

tcp_log_file_auto_save Auto save interval of TCP/IP commands


= to viz_weather. (TCP/IP commands are
sent to viz in News system integration).
Time is in minutes. If omitted, default
value is 2 minutes.

show_host_name=n show_host_name defines if to display


the hostname when running Viz
Weather in -playout mode. If omitted or
empty, default value is n.

show_debug_info= This parameter is used to monitor


commands sent to viz_weather from the
Viz PLAY mechanism. Values are y or n.
If omitted, default value is n

record_init_command Defines if the init commands sent to


=n Viz, will be saved to a file in the Viz
Weather folder.

record_data_command Defines if the sent data commands will


=n be saved to a file in the Viz Weather
folder.

sound_player_cmd=

local_machine_ip= Set the local machine IP. The IP is used


when sending commands to Viz Engine.
Use this flag if there are connection
problems between Viz Weather and Viz
Engine.

general_silent_mode= When enabled, no warning messages


y will pop when Viz Weather starts. If
Weather could not start it will
terminate. Use this flag when using a
restart script for Viz Weather.

fetch_application_port Define a TCP port for Viz Weather Fetch


=6113 Application. Default is 6113.

viz_weather_port=611 Define a TCP port for Viz Weather


2 Application. Default is 6112

enable_vizAnchor=n This flag defines if using Viz Anchor to


control Viz Weather.

[EXTERNAL_
TRIGGER]

84 Chapter 5: Viz Weather System Configuration


Table 1:

Section Parameter Description

connect_to_local_MSE This flag is used when Viz Weather is


=y connected to a remote Media
Sequencer.
connect_to_local_MSE defines if Viz
Weather will also connect to a local
Media Sequencer for getting GPI/BBOX
triggers (if configured). If omitted or
empty, default value is y.

use_default_ Load the default configuration.


config=y

[MOS]

Enabled= Define if MOS support is enabled or not.


If MOS is enabled the MOS tab will be
enabled in the System Configuration
window.

[CURIOUS]

cwm_enabled= Enable the usage of Curious world map


server from Viz Weather. A CWM client
must be installed on the machine if this
option is enabled.

simplified= Affects the GUI of the maps client


ActiveX. When disabled, an extended UI
is displayed. Values are Y/N.

[TRIO]

show=weather Set the Viz Trio show name that the Viz
Weather elements will be saved to.

[FETCH_APP
LICATION]

Machine1= This parameter defines a machines list


Machine2= for the fetch application. Whenever new
data is fetched, it will be sent data to all
Machine3= the machines on the list.

Auto_reconnect=y This parameter defines if the fetch


application will try to reconnect to the
machines on the list if the connection
was broken.

Machines_timeout=20 This parameter defines the time out


duration for the reconnect attempts
when auto-reconnect is set to y.

Chapter 5: Viz Weather System Configuration 85


Table 1:

Section Parameter Description

connect_to_local_MSE relevant only when viz Weather works


=y with a remote Media Sequencer as the
main Media Sequencer.
connect_to_local_MSE defines if to also
connect to local Media Sequencer for
getting GPI/BBOX triggers (if
configured). If omitted or empty,
default value is y.

schema= User schema name

DataPool_Format= Define the way Viz Weather fetch


application will send the datapool data
to Viz. default is data array. the other
option is data table.

DataPool_FullFetchUpd Defines if all points data will be sent to


ate= Viz after fetching data

machines_port=6100 Defines the TCP port number used by


the Fetch application to send the data
to Viz.

[WD_SERVE Deprecated: These settings are now


R] configured on the Media Sequencer
side.

Databasekind=1 always use 1

ConnectionString=Pro Defines the connection string to the


vider=OraOLEDB.Oracl points table space and tables.
e;Password=WEATHER;
Persist Security
Info=True;User
ID=WEATHER;Data
Source=<machineNam
e>/<DatabaseName>;

[WEATHER_
GATEWAY]

Machine1= This parameter defines a machines list


Machine2= of Viz Weather Gateway Slaves. The Viz
Weather Gateway manager will divide
Machine3= the render tasks between the available
slaves.

log_file_lines=100 This parameter defines the maximum


lines displayed in the gateway log.

log_file_history=7 This parameter defines the number of


backup log files saved in the system. If
the log files number exceeds this value,
files will be overwritten with newer files.

86 Chapter 5: Viz Weather System Configuration


Table 1:

Section Parameter Description

gateway_timeout=60 This parameter defines the time that


the gateway manager will wait for a
reply from the gateway slave.

auto_select=n This parameter defines if Viz Weather


will automatically select the monitor
options according to the enabled
editors of the data element, when
saving. Default value is y.

Chapter 5: Viz Weather System Configuration 87


6 Meteorological Data Visualization
This section describes some of the options to visualize meteorological data in Viz
Weather. Most of the examples are taken from Viz Weather graphic design tutorial
and from demo scenes.

This section contains information on the following topics:

• Weather Data Types


• Weather Point
• WGrid Point
• IsoTherms
• IsoPrecip
• IsoBars
• Winds
• Clouds Forecast
• Extremes (or Highs and Lows)
• Flows
• Fronts
• Radar Data
• Satellite Images
• Storm Tracking
• Weather Special Objects

6.1 Weather Data Types


Data types are divided into several categories:

• Weather Point data


• Model data
• Imagery data
• Storm data
• Animated objects

There are a few options to display each one of the data types.

This section contains information on the following topics:

• Weather Point
• WGrid Point
• IsoTherms
• IsoPrecip
• IsoBars
• Winds
• Clouds Forecast
• Extremes (or Highs and Lows)
• Flows

88 Chapter 6: Meteorological Data Visualization


• Fronts
• Radar Data
• Satellite Images
• Storm Tracking
• Weather Special Objects

6.1.1 Weather Point


A weather point is an object containing text objects, images and 3D objects,
displaying meteorological data about a specific geographical place (point) at a
specific time.

Designs vary according to the information displayed. Weather points can be used
over a map with geographical referencing, in a table or as graph points.

The displayed data is based on the data fields defined for each point type. It varies
from temperature values to wind speed, humidity, and so on. Every data value
available by the Weather data supplier can be used in the system.

This following sections contain examples on typical weather point designs:

• Weather Points Table


• Weather Points over a Flat Map with Geographical Referencing
• Points over a Globe
• Weekly Forecast Graph

Weather Points Table


A weather point table displays a number of points without geographic
referencing. The displayed data shows a number of forecast times referring to the
same weather point or a number of weather points referring to one forecast time.

The above example shows a temperature forecast for a European capital.

Chapter 6: Meteorological Data Visualization 89


Weather Points over a Flat Map with Geographical Referencing
Display any point related information over a map, where the point is place at its
geographical location on the map.

The above weather point design includes the point’s name, temperature, weather
conditions icon and a pointer (orange dot) on the map, indicating the city
location.

The above scene example displays the weather point’s name, temperature, wind
direction indicator and a weather vane for showing wind speed.

Points over a Globe


Display any point related information over a Globe, where the point is placed at its
geographical location.

90 Chapter 6: Meteorological Data Visualization


Weekly Forecast Graph
The graph display type is similar to the points table display, with the addition of
using a graph to display data variation. The temperature values are used to
control the graph points.

The above weather point design shows the temperature, weather conditions
symbol and date.This graphic template also uses the MinMax feature, which
normalizes the graph according to the temperature's minimal and maximal
values.

6.1.2 WGrid Point


A WGrid point is an object containing text objects, images and 3D objects,
displaying meteorological data, derived from a defined Model Data, about a
specific geographical place (point) at a specific time.

Chapter 6: Meteorological Data Visualization 91


The WGrid point display can be animated along the data element time range (i.e.
the information of the point is changing according to the model data changes).
The WGrid point can be moved geographically over the map and the information
will change accordingly.

92 Chapter 6: Meteorological Data Visualization


6.1.3 IsoTherms

IsoTherms are used to graphically describe temperature levels and other types of
data as segments of color or texture. The forecast is supplied for a requested time
period, at fixed intervals. The colored segments are drawn for each interval and
played sequentially, creating an animation of the data.

6.1.4 IsoPrecip

Color or texture filled areas are used to graphically describe precipitation levels
and other types of data. The forecast is supplied for a requested time period, at
fixed intervals, and the filled areas are drawn for each interval and played
sequentially, creating an animation of the data.

Another option is to display precipitation levels by using particles:

Chapter 6: Meteorological Data Visualization 93


A combination of data can be used in a graphic template (up to seven data types
in one graphic template, depending on performance issues).

The above example combines pressure data and precipitation data in the same
graphic template.

94 Chapter 6: Meteorological Data Visualization


6.1.5 IsoBars

Lines are used to graphically describe pressure levels (Isobars) and other types of
data as curved lines (similar to a topographic map). The forecast is supplied for a
requested time period, at fixed intervals. The lines are drawn for each interval and
played sequentially, creating an animation of the lines. Labels and extreme values
can be added automatically to the animated lines.

6.1.6 Winds

Wind data is displayed as animated arrows, with color variance according to the
air temperature. The forecast is supplied for a requested time period, at fixed
intervals. The arrows are generated as particles, drawn for each interval, and
played sequentially, creating an animation of the wind arrows.

Chapter 6: Meteorological Data Visualization 95


6.1.7 Clouds Forecast

Clouds forecast data are a set of B&W images. The images are used in a graphic
template to create a 3D graphic representation of clouds, using particles.

6.1.8 Extremes (or Highs and Lows)

H and L represent High and Low pressure areas. Extremes will be used over an air
pressure levels map and indicate the high and low pressure areas.

Note: Extremes can be added automatically from the IsoGrid plug-in.

96 Chapter 6: Meteorological Data Visualization


6.1.9 Flows

Flows are objects used for displaying animated movement of meteorological


phenomena. Flows are commonly used to display winds or water currents.

6.1.10 Fronts

A meteorological front is defined as the transition zone between two air masses
of different density. In Viz Weather, a Front is the graphical representation of a
meteorological front.

Chapter 6: Meteorological Data Visualization 97


6.1.11 Radar Data

Observed precipitation quantities are often displayed as a sequence of images


taken by radar. The images describe precipitation as colored dots on a black
background (with Alpha). The color of the dots indicates the type/amount of
precipitation in that area. The above example shows a radar frame over a map.
The example below shows the same information, in another graphic template,
converted to particles, showing clouds and rain.

98 Chapter 6: Meteorological Data Visualization


6.1.12 Satellite Images

There are several meteorological satellites in orbit around Earth, taking pictures
of the atmosphere. The received images show a specific geographical area at
different time stamps. The meteorological information shown in these images is
clouds, storms, and so on. When the images are displayed as a sequence they
show the observed weather conditions, showing clouds movement (winds), storm
progress and so on.

Chapter 6: Meteorological Data Visualization 99


6.1.13 Storm Tracking

The above examples show options for displaying storm paths (both observed and
forecast paths).

100 Chapter 6: Meteorological Data Visualization


6.1.14 Weather Special Objects

Weather related phenomena, such as sand storms, blizzards, fire, and so on, are
shown in the example above.

Chapter 6: Meteorological Data Visualization 101


7 Using Viz Weather
Viz Weather is a production tool used by meteorologists to create, update and
display weather conditions in real-time 3D graphics. Viz Weather enables the
production of various media formats, making it an essential tool for distributing
weather related information.

This section contains information on the following topics:

• User Interface Layout


• Main Menu
• Viz Tool Bar Options

7.1 User Interface Layout

The user interface reference contains information on the following topics:

• Meteorology Data Area


• Editing Area
• Animation Control Area
• Graphic Display Area
• File
• View

102 Chapter 7: Using Viz Weather


• Settings
• Viz
• Data Element
• Playlist
• Help

7.1.1 Meteorology Data Area


Handling of the meteorological data is done in the Data Import section of the UI -
viewing data, editing data and fetching new data.

See Also
• Working with Meteorological Data

7.1.2 Editing Area


The Editor area, top right section of the UI, is used for editing the selected
property of data elements. Editors are selected from the row of editor buttons,
enabling the user to set the specific meteorological data in each Viz Weather data
element.

See Also
• Data Editors

7.1.3 Animation Control Area


The Preview area, above the render window, is used to control the data element
animation using play buttons, sliders and director selection controls.

7.1.4 Graphic Display Area


This area displays the rendered graphic elements.

7.2 Main Menu

This section describes all menu options available from Viz Weather’s main menu:

• File
• View
• Settings
• Viz
• Data Element
• Playlist
• Help

Chapter 7: Using Viz Weather 103


7.2.1 File

• Import Playlist: Import a Playlist from a file created by Viz Weather (file suffix
is .weathershow).
• Import Data Element: Import a data element from a file created by Viz Weather
(file suffix is .vwde).
• Exit & Keep Viz Running: Close Viz Weather without killing Viz process.
• Exit: Closes Viz Weather.

7.2.2 View

This section contains information on the following topics:

• Fetch Log
• Initialization Log
• TCP Commands
• Weather Gateway
• Debug Window
• Layouts
• Image Size
• Show Grids
• Saved Data Elements

Fetch Log
Fetch Log (CTRL+L) displays a Viz Weather data log window. The log window
displays information about fetch operations and about the existing data on the
local disk. The fetch log window has three tabs:

• Data log: Displays information about the downloaded data: Data type, time of
download, size of data. The button “Clean Log” will clear the log window and
clear the log file from previous information.

104 Chapter 7: Using Viz Weather


• Fetch log: Displays information about the fetch operation itself server name,
requested data, operations during fetch). The information is stored in the file
dataFetch.log under the defined fetch folder.

• Data on Disk: Displays the available Viz Weather meteorological data found in
the specified folder. Select the requested data folder using the radio buttons
at the top of the window.
• Latest read files from the designated folder for downloads are defined in the
Fetch tab (see the System Level Settings section).
• From Directory displays the path to the FetchData directory, and allows you
to browse for a new directory.
• The Check button saves any changes.
• Select one of the data type tabs (Radar, Satellite, and so on) to view the
available data and the time range for the existing data.

When checking image data (Radar and Satellite), for each radar or satellite, the
display will show the following: The left side area displays the radar/satellite data:
name and time range of all existing images. The right side area shows a time bar
(upper part with lines) and a scroll bar (lower part marked with light blue). The
time bar shows a blue line for each image and a black line representing a day
switch.

When pointing the mouse curser at one of the lines, the date and time of the
image will be displayed in the left area (Current).

To modify the display, use the context menu:

• Change view range sets the time range to displayed in the time bar.

Chapter 7: Using Viz Weather 105


• View all range shows all existing data on the time bar. Note that when viewing
the full range the scroll bar will be disabled.
• Zoom to selected fits the selected range to the time bar. To select a range,
click and drag the mouse and then release. The segment will be colored and
the begin and end time of the range will be displayed on the time bar.
• Export selected range exports the image in the selected time range to a file.

Note: The light blue slider at the bottom of each radar/satellite represents the
viewed range currently displayed in the time bar.

Initialization Log

The initialization log window displays information about the latest playlist
initialization.

The initialization log will open during playlist initialization and displays
information about the initialization progress:

• Playlist name and initialization type (at the top end of the window)
• Initialization status of each data element in the playlist - scene name, engine
name, optimization status and data type.

If an error has occurred during the initialization, the Show Errors button will
become enabled. Pressing the Show Errors button will display a list of the errors in
the log window.

If the “Close when complete” check box is checked, the initialization log window
will close automatically after the playlist was initialized.

106 Chapter 7: Using Viz Weather


TCP Commands

When selected, Viz Weather will open a window displaying all incoming TCP
messaged from external applications. The configuration of the TCP port number
is done in the Media Sequencer. Default TCP port is 6112, used by the fetch
application. Port number for communicating with Viz Weather is 6111.

Chapter 7: Using Viz Weather 107


Weather Gateway

Weather Gateway (CTRL+G) displays information about the tasks performed by


the Viz Weather Gateway. To see the gateway window, a Viz Weather Gateway
must be running and defined in Weather Data Suppliers. When opened on a
gateway manager, the window will display the client machines and indicate the
machine status: green for ready, red for disconnected.

The window has three tabs:

• Waiting: Lists Viz Weather Gateway tasks that are waiting in queue to be
executed.
• In Progress: Lists Viz Weather Gateway tasks that are currently being executed.
• Done: Lists Viz Weather Gateway tasks that are completed. The list also
indicates if a task was successfully performed or not.

Note: On a Viz Weather gateway slave machine, only the Waiting tab is opened.

108 Chapter 7: Using Viz Weather


Debug Window

Debug Window displays a list of messages sent from Viz Weather to/from Viz play
mechanism and messages to/from the Media Sequencer. This option is only
enabled if the flag show_debug_info=y is set in the Weather Data Suppliers.

• Debug Messages: Displays general information about Viz Weather operations.


This information is useful when communicating with Viz Weather support
team.
• Record INIT commands enables all init commands sent to Viz will be logged
to a file called InitCommands_On-air.txt, stored under Viz Weather
installation folder.

If program and preview (PGM/PVW) configuration is used, two log files will be
saved: InitCommands_On-air.txt saves init commands sent to the On-air
machine, and InitCommands_Preview.txt saves init commands sent to the Preview
machine.

Chapter 7: Using Viz Weather 109


• Record data commands enables all data editing mouse events editor
operations will be logged to a file called Commands_DblClick_Data, stored
under Viz Weather installation folder.

Note: The same log files will be saved if the following flags are defined in the
initiatlization file (see the Application Level Settings section).

[MISC]
record_init_command=y
record_data_command=y

Note: When calling Viz Weather support team, you might be asked to send these log
files to the support person by e-mail.

• Play UDP messages: Displays UDP messages sent by Viz Weather to the playlist
play mechanism in Viz.
• Mos Listener: Displays MOS messages sent and received by Viz Weather when
working in a news room integrated environment and MOS is configured in Viz
Weather.
• Prepare Ahead: Displays Prepare Ahead messages and calculations performed
by Viz Weather. Prepare Ahead property must be used in the currently
initialized playlist.

Layouts

The layouts menu item enables the user to setup and recall custom UI layouts.
after changing the UI layout, in terms of segments size and visibility, use the Snap
layout options to capture the current UI state. Name the layout and click OK. The
layout name will appear in the layouts list. To restore any of the defined layouts -
select it from the layout menu or use the keyboard shortcuts.

110 Chapter 7: Using Viz Weather


Image Size

Image Size defines the display format of the data elements in the data elements
list and in the playlist editing area. When selected, a sub menu will open:

• Extra Large: Displays the largest data element icons.


• Large: Displays large sized data elements icons.
• Medium: Display medium sized data elements icons.
• Small: Displays small sized data elements icons.
• No Image: No icons will be displayed, only text information.

Show Grids

Toggle grid lines visibility in the data elements area and the playlist area.

Saved Data Elements

Saved Data Elements displays the data elements list. Is only enabled when running
Viz Weather in Playout Mode.

7.2.3 Settings

The Settings menu is described in the System Level Settings section of the Viz
Weather Configuration chapter.

System

Note: Using the System Configuration option requires a password. See the
Application Level Settings section for a description on how to set a password value.

The System Settings window is used for defining parameters that are common to
all weather applications running in the same environment. These settings are
saved in the Media Sequencer XML.

Note: The weather configuration file (viz_weather.ini file) is used by Viz Weather
applications to define local settings.

Chapter 7: Using Viz Weather 111


Data
The Data option will run the WD_Admin application. The WD_Admin application is
used to configure and customize the meteorological data in the system, effecting
menus and options in the Data Import pane (see Working with Meteorological
Data) and the Fetch Application. When the WD_Admin window is opened, select a
tab to configure the values.

Note: Using this option requires a password. See the Application Level Settings
section for a description on how to set a password value.

Advanced Settings

• Refresh Data Settings: This menu item will regenerate initialized data elements
IDs.
• Restore GUI Defaults: This option will remove all user defined UI settings.

7.2.4 Viz

• Set Main Engine allows you to select a different machine running Viz Engine to
render the graphics. All graphic related commands are sent to the selected
machine when playing a Playlist. While editing all command are sent to the
local machine.

A connection indicator is displayed at the lower left corner of Viz Weather window
that shows the On-air machine name and the connection status. Right-click the
status indicator to open a context menu.

112 Chapter 7: Using Viz Weather


• Set On-air changes the renderer status to On-air.
• Connect tries to reconnect to Viz.
• Show Commands opens the renderer commands console. When working
with a program machine, rendering the graphics, the console will open on
the rendering machine.
• Show Status opens a Viz Connection Status window.
• Clear Viz Memory: Removes all loaded fonts, textures and scenes from Viz
memory. All initialized items will be cleared.

• Clear Layers: Removes all loaded scenes from the selected Viz layer.

Note: It is not recommended to use this option on machines that render video.

• Reset Viz Window Size: This option will reset the render window to the size of
the output format defined in the Viz configuration.
• Enable/Disable Resize of Viz window: Enables you to change the size of the
Viz window.
• Enable/Disable Preview: The Enable and Disable Preview options refer to the
program and preview (PGM/PVW) configuration in scenarios where Viz Weather
is running on one machine (preview) and the graphics are rendered on another
machine (program).
The flag defines if the preview machine will run a preview of the graphics
during a playout. When preview is enabled, the playlist will be initialized on
both machines and during playback the preview machine will show the next
data element in the playlist while the current data element is running on the
program machine.
When preview is disabled, only the program machine will be initialized and no
preview will be displayed during playback.
The initial state of this flag is defined in the initialization file (see the
Application Level Settings section). These options allow you to change the
configuration while Viz Weather is running.
• Save Scene in Viz: Saves the loaded graphics back to Viz scene tree. This
operation is not recommended because it will change/add the graphic
template.

Note: Do not use this option unless you are aware of its consequences.

• Import Viz Archive: This option is used to import Viz archives to the Viz data,
using Viz Weather UI.
• Multiple Monitors: This option is enabled only if the machine is currently
configured to use more than one monitor. Select the required work mode from
the list:

Chapter 7: Using Viz Weather 113


7.2.5 Data Element

The Data Element menu relates to Viz Weather data elements, i.e. graphic
templates using specific meteorological data.

• Save: Saves and overwrites the loaded data element.


• Save as: Saves the loaded graphics as a data element, or saves the loaded data
element as a new data element.
• Rename: Rename the data element under a different name and modifies all
playlists using this data element instance to its new name.

114 Chapter 7: Using Viz Weather


• Change Scene: Modifies the graphic template used in the data element using
the same meteorological data (weather points, images, and so on). When this
option is selected Viz Weather will check if the current data fits the exported
Weather attributes in the requested scene – number of text objects, images,
and so on. If a full match is found between the graphic templates, they will be
replaced. If the graphic templates are different, a warning message will
appear, displaying the differences and asking the user to confirm the change.
• Close: Clears Viz Weather editors and the renderer from the loaded data
element information.
• Fetch Points: Fetches the data for all weather points used in the currently
loaded data element.
• Update Points: Re-sends DataPool information of the current data element to
the renderer.
• Post Render: Opens a sub menu with the following options:
• Create Clip: Open the post render tool for recording the currently loaded
data element to the disk. The post render tool will open only if a render to
disk device is defined in Viz. If no render to disk device is defined, an error
message will appear, indicating the problem.
• Create Snapshot: Creates a snap shot (image) of the loaded data element.
• Objects: Opens a sub menu with the following options:
• Load From File: This option will import objects from a file to the data
element. When selected, a file browser will open. Select the file to import
and confirm.
• Save To File: This option will export defined objects from the data element
to a file.

Note: Objects that can be exported are texts, fronts, flows, H&L objects and special
objects.

Chapter 7: Using Viz Weather 115


• Delete Old Data: Opens a dialog box for deletion of old data elements from
the system. Select the dates to be deleted and click he delete button.
• Select Unused Data Elements: Select all data elements, in the data elements
list, that are not included in any playlist.

7.2.6 Playlist

The Playlist menu is for the Viz Weather playlists. A Playlist is a sequential list of
data-elements and Viz commands.

• Update: Re-send DataPool information to the renderer.


• Prepare Ahead: When selected, Viz Weather will fetch and update the playlist
according to the Prepare Ahead settings defined in the playlist properties.
• Fetch (Points Only): Fetches the data for all weather points used in the playlist
(only point data).
• Fetch (Points + Images + Storms): Fetches Weather Points data, images and
stores data for all the data elements used in the playlist.
• Post Render: Create clips or snapshots from the playlist elements.
• Create Clips (CTRL+P): Starts post rendering the data elements in the
playlist to clips using the parameters from System Configuration > Post
renderer. The playlist must be initialized before using the render clips
option and Post time values for every data element in the Playlist must be
defined.
• Create Snapshots: Creates a series of snapshots from the data elements in
the Playlist. The playlist must be initialized before selecting this option. The
snapshots rendered are of the first frame of every data element, unless a
special tag is defined in the graphic template’s animation called “pilot1”. If
such a tag is defined the snapshot will be rendered at that point of the
animation.
• Create Clips & Snapshots: Creates post rendered clips of the initialized
playlist and snapshot images of the playlist as explained in the two menu
options above.

Note: A render device must be defined in Viz and the path for storing the rendered
images must be defined in Viz Weather.

116 Chapter 7: Using Viz Weather


• Show Playlist Buttons Panel/Hide Playlist Buttons Panel: Opens/hides a button
control panel for activating Playlist commands during production.
• Reset Playlist Ref Count: This option is visible when the Playlist Lock flag is
disabled. When the lock flag is off, an indicator above the playlist displays the
number of concurrent clients using the playlist. When this menu item is
selected, the counter is reset.
• Refresh PLAY Device: Refreshes the Viz play device information.
• MSE MOS Playlists: This option is enabled only when the MOS connection is
defined and connected. When selecting this menu item, a window displaying a
list of the available playlists sent by the newsroom automation system. When a
playlist is selected it can be loaded to Viz Weather.

7.2.7 Help

The Help menu provides general information about Viz Weather’s version.

• Viz Weather Help (PDF): Opens Viz Weather user manual in PDF format.
• Viz Weather Help (HTML): Opens Viz Weather user manual in HTML format.
• System Info: Opens a window displaying system information.

Chapter 7: Using Viz Weather 117


• About: Display information about the installed version.

7.3 Viz Tool Bar Options

Above the Viz render window is the Viz Tool bar. It enables the user to perform
some Viz related actions:

• Control the animation


• Display various Viz features
• Switch to Viz Artist
• Execute Viz related actions

• Animation Control buttons: The various animation control buttons (play, stop,
and so on) control the animation of the loaded data element or graphic
template.

• TA (Title Area): When enabled, a title safe area border will appear in the render
window.
• SA (Safe Area): When enabled, a safe area border will appear in the render
window.

118 Chapter 7: Using Viz Weather


• BB (Bounding Box): When enabled, the bounding box of the selected object is
displayed in the render window.
• Show Key: The render window will display the key of the graphics.
• Show Graphics: The render window will display the graphics.
• Display Viz Features: When enabled, all the available options will be expanded.
• Switch to Viz Artist: When working with Viz Weather, you can switch to/from
Viz Weather/Viz Artist. Click the Switch to Viz Artist button to run Viz Artist,
and when done, press the Weather button at the top right corner of the Viz
Artist UI to switch back to Viz Weather.
• Status Indicator and Context Menu: The status indicator shows if Viz Weather
is connected to the preview Viz Engine, or if there is a problem with the
connection. Click the arrow button next to the status indicator to expand the
context menu:

• Set OnAir: Changes the renderer status to on-air.


• Connect: Performs an attempt to reconnect to Viz.
• Show/Hide Commands: Opens/hides the local renderer commands console.
• Show/Hide Performance: Shows/hides the Viz performance meter in the
render window.
• Redraw Viz Window: Refreshes the renderer window (on preview and
program machines).This option is enabled only when running Viz 3.x.
• Show Status: Opens a Viz Connection Status window.
• Restart Viz: Restarts Viz Engine on the local machine.

Chapter 7: Using Viz Weather 119


8 Working with Meteorological Data
The Data Import area is used to manage incoming meteorological data in the
system. It defines what type of data will be fetched (downloaded) from the data
supplier’s server and the time range of the fetched data.

This section contains information on the following topics:

• Points List
• Fetch
• Points Data

8.1 Points List

The Points List tab is used to define and manage a list of weather points defined
in the system. A weather point is a geographic location, represented by the
point’s attributes - name, longitude and latitude.

The points list is stored in the Viz Weather points database. It is recommended
that all point list operations will be performed using the WD_Admin tool, however,
simple tasks like adding, editing or deleting a point can be done from the Points
List tab.

The system uses the points list to download and display meteorological forecast
and information. Points that are not defined in the system cannot be used to
display forecast information retrieved from the data supplier.

This section contains information on the following topics:

• To add a weather point from the database

120 Chapter 8: Working with Meteorological Data


• To search a point from the web (OSM, Yahoo) or CWM
• To search a point from the local files
• To manually add a weather point
• To import weather points (CSV)
• To export weather points (CSV)
• To delete a weather point
• To fetch weather point data

To add a weather point from the database

1. Right-click the list and from the appearing context menu select New Point.
A Search Point dialog will open.

2. There are various ways of searching for a point:


• Open Street Map: Search for a point on the Open Street Map server.
• Yahoo (web): Search for a point on Yahoo service.

Chapter 8: Working with Meteorological Data 121


• CWM: Search for a point on Viz World Maps server.

Note: This option requires setting a configuration parameter in the Settings > Misc
tab.

• Local Database: Search locally installed files of cities lists.

Note: This option requires a configuration file (viz_weather.ini) parameter, pointing


at the path to the local files.

To search a point from the web (OSM, Yahoo) or CWM


1. In the Point Search text field, type the name of the city to look for.
2. Click the search button.
A list of cities matching the search string will appear in the Result field.
3. Select one of the results. The Name, Country, Region and Sub Region fields
will be populated automatically.
4. Click OK to add the city to the points database or Cancel to close the Search
Point window without adding the point.
5. Verify that the longitude and latitude values of the added points are correct.

To search a point from the local files

1. Select a country from the countries drop-down list.


The City drop-down list will be populated with a list of cities from the selected
country.
2. Type a sub-string for narrowing the Cities list or type the city name in the City
field.
3. Select a city from the drop-down list.
The longitude, latitude, name and country edit boxes will automatically be
filled with data.
4. Click OK.

122 Chapter 8: Working with Meteorological Data


The point will be added to the list.
5. Verify that the longitude and latitude values of the added points are correct.

To manually add a weather point

1. Right-click the list and from the appearing context menu select New Point
(Blank).
A new_city entry row with default longitude and latitude will be added.
2. Change the city name, longitude and latitude to the required values.

To import weather points (CSV)

1. Right-click the list and from the appearing context menu select Import Points
(CSV).
A file browsing window will open.
2. Browse and select the CSV file containing the points and click Open.
A point types list will open.
3. Select the point type to import the points to and click OK.
The points from the CSV file will be imported to the points list of the selected
point type.

Note: See the Utilities section in the Working with Meteorological Data chapter for
additional information on CSV file format.

To export weather points (CSV)

1. To export weather points to a CSV file, right-click the list and from the
appearing context menu select Export Points (CSV).
2. Select the required option:

3. In the file browser dialog that opens, set the folder and file name for the
exported CSV file and click Save.

To delete a weather point

1. Right-click the list and from the appearing context menu select Delete
Point(s).
A confirmation message will appear.
2. Click OK to confirm the points deletion.
3. Change the city name, longitude and latitude to the required values.

Chapter 8: Working with Meteorological Data 123


To fetch weather point data
The weather point data is retrieved from the data supplier. The fetch process uses
the parameters defined in the Fetch section.

1. Select to fetch All Points, Selected Points or All Points + Init Tables.
• All Point: Fetch data for the requested forecast time for all points in the list.
• Selected Points: Fetch data for the requested forecast time only for the
currently selected points in the list.
• All Points + Init Tables: Fetch data for all forecast times and for all points in
the list and recreate the data tables in the system (The additional columns
and the data pool tables). This option is used once after an installation or
upgrade, or when changing the tables configuration (forecast times or
additional fields).

2. Select the time range of the requested data.


3. Click the Fetch button to begin the fetch operation.

124 Chapter 8: Working with Meteorological Data


8.2 Fetch

The Fetch tab is used for configuring what data type (other than weather points)
will be fetched. The data types are defined in Fetch Profiles. A fetch profile can be
triggered automatically or manually. When a fetch profile is triggered, all the data
types defined in the profile will be downloaded from the meteorological data
supplier to the system.

This section contains information on the following topics:

• Adding a new Fetch Profile


• Editing a Fetch Profile
• Deleting a Fetch Profile
• Setting a Fetch Profile
• Satellite Images
• Model Data Forecast
• Radar
• Points
• Misc Information
• Clouds Forecast
• Storm Path

8.2.1 Adding a new Fetch Profile


To add a new fetch profile, click the add button. The Profile Editor will open, with
all options disabled.

Set the profile name, and enable the check boxes next to the data types to be
used in this profile. Configure the data types and data time range according to the
guidelines in the Setting a Fetch Profile section.

Chapter 8: Working with Meteorological Data 125


8.2.2 Editing a Fetch Profile
To edit an existing fetch profile, click the edit button. The Profile Editor will open,
with the selected profile’s settings. Configure the data types, data time range,
Time Pattern or profile name, according to the guidelines in the Setting a Fetch
Profile section.

8.2.3 Deleting a Fetch Profile


To delete a fetch profile, click the delete button. The selected profile will be
removed from the list.

CAUTION! when deleting a fetch profile, no confirmation message will appear.

8.2.4 Setting a Fetch Profile


Figure 4: Profile Editor window

The Profile Editor is used to set the fetch properties and the meteorological data
types:

Fetch Settings
• Profile Name: Name of the fetch profile. This name is displayed in the Fetch
tab under the Profile Name column.

126 Chapter 8: Working with Meteorological Data


Figure 5: Defining a time pattern

• Time Pattern: The time pattern defines the time in which the fetch action will
be executed.
• The time pattern can be a fixed hour during the day, or an interval between
fetch operations. The time pattern will be used only if the Fetch Profile is
defined as Active in the Fetch tab. When a Fetch profile is active, an
automatic fetch will be triggered whenever the time pattern occurs.
• Click the ellipsis button next to the time pattern field. The Profile
Scheduling Editor window will open. Select the Standard tab to set the time/
interval and the days in which the fetch will occur. Select the Advanced tab
to set the time interval and the days in a detailed representation.
• Fetch Now: When the button is pressed, the fetch operation will be executed
instantly, on the current machine, using the current machines settings.

Data Settings

To set the time range

1. Click the Calendar button to change the Date Time Range:

2. Set the From and To date and time for the required data.

Chapter 8: Working with Meteorological Data 127


• Absolute Date: Sets a fixed date and time. Click the Calendar icon to select a
date for the From and To fields. Set the time for the From and To fields.
• Relative Date: Sets a relative date and time (relates to today). Select a
relative day from the drop-down list in the From and To fields. Set the time
for the From and To fields.

Note: Any combination of relative and absolute date/time can be used in the time
range.

8.2.5 Satellite Images

In the Area drop-down list, a list of configured satellites can be selected (see the
WD_Admin application, Satellite option). To select a satellite area, check the
check-box next to the required satellites.

For each satellite, images can be fetched with land (no alpha) or with alpha
displaying only the clouds in the image (clouds with alpha). The Available
satellites list will vary depending on your data supplier and the entries configured.

Note: Time setting for satellite images should be in the past (since it is not a forecast
but a set of images taken by satellite).

128 Chapter 8: Working with Meteorological Data


Figure 6: Satellites - D1 to D9

Figure 7: Satellites - GEOS and MeteoSat

Chapter 8: Working with Meteorological Data 129


Table 2: Available satellites

Satellite Description

D1

D2 Europe

D3 East Europe and west Asia.

D4 North of south America.

D5 West Africa.

D6 East Africa.

D7 () South-east of south America.

D8

D9

GOES-W West USA, west Canada and the Pacific Ocean.

GOES-E North and south Americas.

GMS East Asia, Oceania.

IODC West and central Asia, and east Africa.

D2D3 Europe and west Asia.

US_ALL

US_WEST

US_EAST

SOUTH_AMERICA

EUROPE

AUSTRALIA

WORLD

8.2.6 Model Data Forecast

130 Chapter 8: Working with Meteorological Data


The Model data selection area supports Iso parameters selection, time range and
model type for fetch.

From the drop-down, select the required data type. Type name is defined in the
Model Data tab, in the WD_Admin application.

Chapter 8: Working with Meteorological Data 131


To set the model parameters

1. Click the ellipsis (...) button to open the Fetch Profile window.
The Fetch Profile window displays the configured model types and the
available data for each type.
2. Select the data to be fetched: Lines (pressure), Bands (temperature), Filled
precipitation), Zones or Winds, and click OK to confirm the selection.
3. Set the time range for the fetched data.
Time setting for Model Data can use future time since model data is based on
forecast model, predicting weather behavior.

132 Chapter 8: Working with Meteorological Data


Zones are weather conditions forecasts, supplied in a form of a geographical grid.
Every point in the grid has a value and the grid is converted into shapes derived
from areas with the same value. Zones are displayed with the WGrid plug-in,
extending Viz Weather’s ability to display additional meteorological data formats.

8.2.7 Radar

In the Area drop-down list a list of radars can be selected. Radar options are
configured under the WD_Admin application, Radar tab. See the Viz Weather Data
Configuration section.

Note: Time setting for radar images should be in the past (since it is not a forecast
but a set of images taken by radar).

Chapter 8: Working with Meteorological Data 133


8.2.8 Points

Check the Points check box to fetch Weather points data when the Fetch Profile is
triggered. Select the points type to fetch from the drop-down list.

8.2.9 Misc Information


Miscellaneous information is used to fetch any additional data configured in the
Misc Information tab in the WD_Admin application (see the Viz Weather Data
Configuration section). When defined in the system a drop-down list will be
enabled with the defined options and the user will be able to fetch data into the
system.

8.2.10 Clouds Forecast


Cloud forecast data is a set of black and white images representing clouded areas
(like satellite images). When the cloud forecast images available from the data
suppliers are defined in the system, the images can be fetched and used to
display 3D clouds forecast. The default images area defined in the system is
Europe.

8.2.11 Storm Path


Storm path data is an XML file describing all the storms (hurricanes, typhoons,
and so on), within the defined time range (for the defined area), observed path
and expected path.

Select one of the defined areas to fetch the storms information. The default storm
path area defined in the system is Japan.

134 Chapter 8: Working with Meteorological Data


8.3 Points Data
The Points Data tab displays the meteorological information of the weather points
used in the system.

Some of the data in this tab is editable. This is used to correct values retrieved
from the suppliers or to set values manually for points where the information is
missing.

Select the point type and the time of forecast from the drop-down list. The
forecast values for the selected time will be displayed in the table.

The drop-down list is configurable. Use the WD_Admin tool, Forecast tab, to
configure the items in the drop-down list. See the Viz Weather Data Configuration
section.

Note: Make sure the defined forecast time is supplied by your data supplier.

The Points Data table is editable by double-clicking a value or selecting it and


pressing the F2 key to insert new values.

Use the lock mechanisms (context menu) to prevent point data from being
changed by the automatic fetch operation. Items in the Points Data table can be
sorted by columns.

See Also
• Fetch Application
• Viz Weather Data Configuration

Chapter 8: Working with Meteorological Data 135


9 Working with Graphics Templates

Graphics templates are Viz Artist scenes used by Viz Weather to display
meteorological data.

The difference between a weather scene (graphics template) and a non-weather


scene is the usage of special weather plug-ins designed to work with the Viz
Weather user interface and to manage meteorological data.

All scenes can be loaded to the Viz Weather user interface and added to a Viz
Weather playlist; however, a warning message will appear when loading a non-
weather scene for editing in Viz Weather user interface, informing that the scene
does not have any weather properties.

After a template is loaded to Viz Weather, the meteorological data editors will be
enabled, according to the graphics template’s exposed properties. In order to
expose properties that will allow you to control and set the parmameters of the
scene, the graphics designer must expose those properties using the
aforementioned plug-ins.

To load and save graphics templates see the following procedures:

• To load a graphics template


• To save a graphic template as a new graphic template to Viz

To load a graphics template


1. In the Control area click the Graphic Templates section to open the Graphic
Templates window.

136 Chapter 9: Working with Graphics Templates


2. Use the right click menu in the Viz folders area to set folders as favorites and
create shortcuts to those folder:

3. Browse the Viz scene


tree (the left side of the Graphic Templates window) and select the required
folder.
4. The graphic templates in the selected folder will be displayed in the right-
hand pane of the graphic templates area.

5. Use the right-click menu to sort the graphic templates, refresh or add a time
stamp to the graphic template names.
6. Double-click the required graphic template (scene).
• The graphic template will load to the render window and the exposed
properties will enable the editors in Viz Weather.

Chapter 9: Working with Graphics Templates 137


7. Edit the graphic template by adding meteorological data, weather point data,
setting the time range and save it as a data element.
• The graphic template will not be changed during editing or when the data is
saved as a data element.
• The data-element contains a reference to the scene and a list of the
meteorological data that was added to it.

Note: When loading scenes that were not designed as Viz Weather graphic
templates, a warning message will appear while loading.

IMPORTANT! The Viz data root folder displayed in Viz Weather is defined by the
parameter dir= in the initialization file (see the Application Level Settings section).

To save a graphic template as a new graphic template to Viz


• If a graphic template is edited and you want to replace it or save it as another
graphic template, select Save Scene in Viz from the Viz menu.

Note: It is not recommended to create a graphic template from the Viz Weather UI. If
editing is required, you can switch to Viz Artist and manage the graphic templates
from there. After the graphic template is saved in Viz Artist, you can switch back to
Viz Weather by clicking the Weather button at the top right panel of the Viz Artist UI.

See Also
• Using Viz Weather
• Working with Playlists
• Working with Data Elements
• Viz Weather Scene Design Tutorial for detailed information and examples.
• Viz DataPool tutorial scenes for supplement information on the DataPool
plug-ins.

138 Chapter 9: Working with Graphics Templates


10 Working with Data Elements
Viz Weather, as any other Vizrt control application, use template graphics from
Viz to create data elements for playout.

A Viz Weather data element is a graphic 3D scene with meteorological data added
to it. The data types (Model data, Weather point information, and so on) available
for editing are exposed in the graphic template and are time dependent. After a
data element was created, the meteorological data is inserted automatically into
the data element every time it is used, and the data is updated every time new
meteorological data is fetched.

This section contains information on the following topics:

• Data Element Folders


• Saved Data Elements List
• Creating and Editing a Data Element
• Data Editors
• Debugging a Data Element

10.1 Data Element Folders


The data element folder is used to group data elements that share a common
subject – show name, meteorological data type, and so on. When viewing the data
elements list, the folders are used as a filter for the list. When selecting a folder
from the list, only data elements that were saved under this folder will be
displayed. A data element can be saved under one folder only. If two data
elements with the same name are saved under different folders – they exist as
different entities in the system.

10.2 Saved Data Elements List

After creating a data element, it will be added to the ‘Saved Data Elements’ list.
From the list the data element can be opened for editing or dragged to a playlist.
A context menu for manipulating the data element list is available.

Chapter 10: Working with Data Elements 139


• Copy (CTRL+C): Copies the selected data element to the clipboard.
• Delete (DELETE): Deletes the selected data element.
• Find (CTRL+F): Searches for a data element. When selected the Find Tool bar
will appear at the bottom of the data elements list.
• Release Lock: If the data element is locked by another user, release the lock
and allow to edit and save the data element.
• Properties: Opens the playlist properties window.
• Export To File: Exports the selected data element to a file.
• Goto Scene: Selects the graphics template, referenced by the data element, in
the graphics templates pane.

Figure 8: Data Elements search bar

When typing the text to look for in the text field the first occurrence of the typed
text in the data elements list will be selected (the selection will change as the text
is typed in the text field). If the typed string is not found, the text field will
become red. The Next and Previous buttons jumps between the data elements.

• Case Sensitive: Check box to filter letter casing.


• Exact: Check box to filter results that are not the exact string in the text field.
• X: Closes the Find Toolbar.

10.3 Creating and Editing a Data Element


For a step-by-step instruction on how to create and edit a data elements use the
following procedures:

• To create a data element


• To delete a data element
• To edit a data element
• To add meta data to a data element

To create a data element


1. Load a graphic template to Viz Weather:

140 Chapter 10: Working with Data Elements


• Expand the Graphic Templates area.
• Select a folder in the Viz scene tree.
• Double-click a graphic template.
• The graphic template will load to Viz and Viz Weather will enable the
required editors.

Note: For additional information about Graphic Templates, see the Working with
Graphics Templates chapter and the Viz Weather Scene Design Tutorial.

2. Set the required meteorological data by selecting one of the editors, and set
the time range for the data element. For additional information see section
Data Editors.
3. In the Data Element menu select Save As, or click the Save As button on the
right top side of the screen.

4. Select a Data Element Folder, type a name and click OK to save.

Note: If Viz Weather Gateway is defined and used, select the monitor option and task
in the Save As window.

To delete a data element


1. Select a Data Element from the Saved Data Elements list.
2. Right-click the selected item and select Delete or press the Del key on the
keyboard.

Chapter 10: Working with Data Elements 141


3. Click Yes to confirm the delete operation or No to cancel.

To edit a data element


1. Load a data element to Viz Weather by double-clicking a saved data element.
• After loading, the editors for the properties (meteorological data types)
exposed to the user by the graphic template will become enabled. All other
editors will remain disabled (hidden).
2. Select a property editor and the editing window will be displayed.
3. Edit the parameters and save the data, or create a new data by using the Save
As option.

To add meta data to a data element


Meta data is additional general information added to the data element. It is
possible to add comments, explenations or any other required information.

This data is exported with the data element and imported back when the data
element file is imported.

1. Click the Additional information button.


A meta data text window will open.
2. Set the required information and click OK to close the window.

10.4 Data Editors

There are 16 data type editors in Viz Weather, and three data element properties
editors. Each data type editor affects the display of a different type of
meteorological data. The data element property editors define global parameters
for the data element such as animation length, time range, and so on.

When no graphic template or data element is loaded to Viz Weather the editors
will be hidden.

For each graphic template, the designer determines which meteorological data
types will be exposed to the user for editing. When loading the graphic template
to Viz Weather, the corresponding editors will be enabled. The user can edit the
data by selecting an editor and changing the content.

All the editors (except the Animation editor) have a “layer visible” radio button to
show or hide the edited layer.

Animation and Time range editors are enabled for all data elements.

This section contains information on the following topics:

• Text Editor

142 Chapter 10: Working with Data Elements


• Weather Points Editor
• WGrid Points Editor
• Weather Points Filter Editor
• Fronts Editor
• Model Data Editor
• Satellite Editor
• Map Editor
• Pressures Editor (Extremes)
• Images Editor
• Radar Editor
• Special Objects Editor
• Flows Editor
• Clouds Editor
• Winds Editor
• Storm Path Editor
• Hops Editor
• Graffiti Editor
• Time Range Editor
• Animation Editor
• Camera Selection Editor

10.4.1 Text Editor

The text editor can display, add and modify text objects in the data element.

A free text object (not part of any weather point design) can be used when the
designer exports some text designs to allow the addition of any text to the
graphics.

Properties and Parameters

• Add text (button): Adds a new text object to the scene. If no text designs are
exported in the graphic template this button will be disabled.
• Delete text (button): Deletes a text object from the scene. Exported texts in
the scene (original nodes) cannot be deleted.
• Text Layer Visible (button): Hides or displays the text layer. All added text
objects will be affected by this check box.
• Text from file: Defines if additional text objects will be used in the graphics.
When checked, the file browser and text field will be enabled. Select a Viz
Weather text objects file. The file will open and the texts from the file will be
loaded to the graphics. When the data element is saved, the text objects are

Chapter 10: Working with Data Elements 143


not saved with other text objects. Only a link to the file is saved. Every time
the data element is opened or initialized, the text objects will be loaded from
the file.

Note: The same text designs must be a part of the graphic template.

Editor Context Menu

The context menu provides a few options for line manipulation:

• Copy Lines (CTRL+C): Copy the selected lines to the clipboard.


• Paste Lines (CTRL+V): Paste lines from the clipboard to the editor.
• Delete Lines (CTRL+DELETE): Delete the selected lines.
• Select All Lines (CTRL+A): Select all lines in the editor.

Columns
The lines that appear in the text editor includes all ‘editable text’ that are used in
the currently open data-element. The lines may include text that were placed by
the graphic designer in a specific location in the graphics, and only their content
is editable. It also includes text that were dynamically added by the Viz Weather
operator by using the option of add text.

• The Text: Displays the content of the text object. Use the shortcut ALT+Left-
click on the node to edit the value of the text.
• Style: Displays the selected style (design) of the text node. If the text object
was saved in the data element, the column’s value will be In Scene.
• The number of options in the drop-down list displays is the number of
exported text designs in the graphic template.
• Selecting a style will create a copy of the design and insert the data from the
line in the table into the corresponding fields, creating a text object (see
graphic Design - export text).
• Longitude/X, Latitude/Y: Displays the X, Y position of the text object in the
render window or the Long/Lat location of the text object, if the object is
geographically referenced. Values are set in the UI by or by changing the
position of the object in the render window (dragging the node in Viz).
• Geo: Displays the object’s positioning properties:
• Fixed (locked): The user cannot move the object in the graphics. The fixed
objects are marked with a lock icon.
• Movable: The user can move the object by dragging it in the render window
or by setting an X/Y value in the UI. The movable objects are marked with an
axis icon.
• Geo: The object is positioned according to its Long/Lat values. The user
cannot move the object manually. These objects are marked with a lock
icon.

144 Chapter 10: Working with Data Elements


• Geo-Movable: The object is positioned according to its Long/Lat values. The
user can move the object by changing the Long/Lat values manually. The
Geo-Movable points are marked with a globe icon.
• Visible: Sets a visibility switch for each of the text objects. When checked, the
text will be visible in the rendered output.

To create a new text object


1. Add a text node to the graphic template using the Add text button, or copy
and paste an existing line.
2. Change the text in the editor to the required string.
3. Select a style.
4. Place the text node in the render window by changing the Pos X, Pos Y column,
or by dragging the node in the Viz scene.
5. Save the created data by selecting Save As under the Data Element menu or by
clicking the Save As button next to the “Saved Data Elements” window.

Note: Selecting a row in the text table will select the text object in the render window
and vice versa - selecting the text node in the render window will highlight the row
in the text editor.

10.4.2 Weather Points Editor

The Weather Points editor can display, add and modify weather points in the data
element.

A Weather point is an object that displays meteorological information according


to its location & date (temperature, wind direction, wind speed, and so on).

The entries that appear in the WPoint editor include all editable points that are in
this data element. These may include points that were exposed by the graphic
designer in a specific location in the graphics (as in a 5day forecast table - in
which case only their content are editable) and points that were added by the Viz
Weather operator by using the Add Weather Point option.

Selecting a row in the weather point table will select the weather point object in
the render window and vice versa - selecting the weather point object in the
render window will highlight the row in the text editor.

This section contains information on the following topics:

Chapter 10: Working with Data Elements 145


• Properties and Parameters
• Editor Context menu
• Columns
• To add a new weather point
• To add new weather points from a filter

Properties and Parameters

• Add weather point: Adds a new weather point to the data element. This
button is enabled only if a weather point design was defined in the graphic
template.

• Delete weather point: Deletes an added weather point from the data
element. Exported weather points in the graphic template (In Scene) cannot be
deleted.

• Add weather points from filter: Adds a group of weather points to the
data element, according to the filter parameters. Filtering of points are done
by category and by data fileds of a symbol type and a combo type. This button
is enabled only if a weather point design was defined in the graphic template.

• Points Layer Visible: Hides or displays the weather points layer. The
button will affect all weather points in the data element.

• Send Min/Max Values: When pressed, the minimal and maximal


temperature values of the points in the data element will be sent to the
graphics. When used in a graph scene supporting this feature, the graph
points will be interpolated according to the minimal and maximal values.

Editor Context menu

The context menu provides a few options for line manipulation:

1. Copy Lines (CTRL+C): Copy the selected lines to the clipboard.


2. Paste Lines (CTRL+V): Paste lines from the clipboard to the editor.
3. Delete Lines (CTRL+DELETE): Delete the selected lines.
4. Select All Lines (CTRL+A): Select all lines in the editor.

Columns
• Container: Displays the weather point’s container name (in The graphic
template).

146 Chapter 10: Working with Data Elements


• Point Type: Displays the point type as it was saved in the graphic template.
Only points from the same point type can be used in the data element.
• Point Name: Displays the selected point name.
• Style: Displays the available styles (design) of the weather point node If the
point was saved in the graphic template, this field value will be “In Scene”. The
options in the drop-down list are the exported weather point designs in the
graphic template. Selecting a style will create a copy of the design and insert
the data from the line in the table into the corresponding fields, creating a
weather point object in the renderer (see graphic Design: export weather point
design).
• Day: time of the weather forecast displayed. Options for the drop-down menu
are either the default values or the values defined in the WD_Admin forecasts
tab.
• Longitude/X, Latitude/Y: Displays the X, Y position of the weather point object
in the render window or the Long/Lat location of the weather point object, if
the object is geographically referenced. Values are set in the UI by or by
changing the position of the object in the render window (dragging the node
in Viz).
• Geo: Displays the object’s positioning properties:
• Fixed (locked): The user cannot move the object in the graphics. The fixed
objects are marked with a lock icon.
• Movable: The user can move the object by dragging it in the render window
or by setting an X/Y value in the UI. The movable objects are marked with an
axis icon.
• Geo: The object is positioned according to its Long/Lat values. The user
cannot move the object manually. The geo objects are marked with a lock
icon.
• Geo-Movable: The object is positioned according to its Long/Lat values. The
user can move the object by changing the Long/Lat values manually. The
geo-movable objects are marked with a globe icon.
• Visible: This attribute defines if the weather point will be displayed in the
graphics or not.

To add a new weather point


1. Click the Add weather point button to add a weather point node to the scene,
or copy and paste an existing line.
2. Select a weather point name from the PointName drop-down list.
The list of cities contains the cities shown in the Points Data tab under the
Data import window.
3. Select the weather point’s style.
4. Select the time of data to be displayed.
5. Position the weather point in the render window by changing the Pos X, Pos Y
values or by dragging the point in the Viz scene.
6. Save the created data by selecting Save As under the Data Element menu or by
clicking the Save As button next to the Saved Data Elements window.

To add new weather points from a filter


1. Click the Add weather points from filter.
The Points Filter Parameters window will open.

Chapter 10: Working with Data Elements 147


2. Set the required filter by setting parameter values in the filter.

3. For the Global filter parameters:


• Select the Point Type to add from.
• Select the Forecast that will be displayed in the added points.
• Select the Point style that will be applied to the added points.
• Include Data Element Date Range. This parameter will be enabled only if a
pair of specific data fields were added to the selected point type. The
parameter is used when working with weather alerts and warnings, where a
point also has a time range in which it is effective. It does not apply for
regular weather point types.

4. For the Filter parameters:


• Select the checkbox next to the parameters you wish to include in the filter,
and set the parameter values.

148 Chapter 10: Working with Data Elements


Note: To use the BETWEEN option in a parameter, set the values separated by a
comma: 10,20.

Note: Select the Auto Calc option to see the updated number of points selected by
the filter.

Click OK.A message box displaying the number of points that will be added
will appear.
Click OK.The weather points will be added to the data element.

Note: The Points filter in the Weather Points editor is used only for adding points.
After the points were added the filter is reset.

10.4.3 WGrid Points Editor

A WGrid point is an object that displays meteorological information according to


its location and date, where the data is derived from various model data types
(temperature, wind direction, wind speed, and so on). The WGrid Points editor can
display, add, and modify such points in the data element.

The entries that appear in the WGrid Points editor include points that were added
by the Viz Weather operator by using the Add WGrid point option.

Selecting a row in the WGrid point table will select the WGrid point object in the
render window and vice versa - selecting the WGrid point object in the render
window will highlight the row in the text editor.

IMPORTANT! When using a graphic template with WGrid points, the time range of the
data element must be set according to the model data’s time range. If the time range
is not set, the data is not sent to the points.

This section contains information on the following topics:

• Properties and Parameters


• Editor Context menu
• Columns
• To add a new WGrid point

Properties and Parameters

• Add WGrid point: Adds a new WGrid point to the data element.

Chapter 10: Working with Data Elements 149


• Delete WGrid point: Deletes an added WGrid point from the data
element. Exported WGrid points in the graphic template (In Scene) cannot be
deleted.
• Grid Models: Select a grid from the drop-down list. The selected model will
define the data that will be sent to the WGrid points.

Note: See To configure WP Grid Types for additional information.

• Points Layer Visible: Hides or displays the WGrid points layer. The button
will affect all WGrid points in the data element.

Editor Context menu

The context menu provides a few options for line manipulation:

1. Copy Lines (CTRL+C): Copy the selected lines to the clipboard.


2. Paste Lines (CTRL+V): Paste lines from the clipboard to the editor.
3. Delete Lines (CTRL+DELETE): Delete the selected lines.
4. Select All Lines (CTRL+A): Select all lines in the editor.

Columns
• Container: Displays the WGrid point’s container name (in The graphic
template).
• Style: Displays the available styles (design) of the WGrid point node. If the
point was saved in the graphic template, this field value will be In Scene. The
options in the drop-down list are the exported WGrid point designs in the
graphic template. Selecting a style will create a copy of the design and insert
the data from the line in the table into the corresponding fields, creating a
WGrid point object in the renderer (see graphic Design; export WGrid point
design).
• Longitude/X, Latitude/Y: Displays the X, Y position of the WGrid point object
in the render window or the Long/Lat location of the WGrid point object, if the
object is geographically referenced. Values are set in the UI by or by changing
the position of the object in the render window (dragging the node in Viz).
• Geo: Displays the object’s positioning properties:
• Fixed (locked): The user cannot move the object in the graphics. The fixed
objects are marked with a lock icon.
• Movable: The user can move the object by dragging it in the render window
or by setting an X/Y value in the UI. The movable objects are marked with an
axis icon.

150 Chapter 10: Working with Data Elements


• Geo: The object is positioned according to its Long/Lat values. The user
cannot move the object manually. The geo objects are marked with a lock
icon.
• Geo-Movable: The object is positioned according to its Long/Lat values. The
user can move the object by changing the Long/Lat values manually. The
geo-movable objects are marked with a globe icon.
• Visible: This attribute defines if the WGrid point will be displayed in the
graphics or not.
• Caption: Set the text to be displayed in the WGrid point object label, or click
the ... button and search a place from the search point window. Click select to
use the place name and geographical location in the WGrid point.

To add a new WGrid point


1. Click the Add WGrid point button to add a WGrid point node to the scene, or
copy and paste an existing line.
2. Select the WGrid point’s style.
3. Position the WGrid point in the render window by changing the Pos X and Pos
Y values or by dragging the point in the Viz scene. Set the WGrid point caption.
To position the point at a specific place, click the Caption column in the editor
and open the Search Place window by clicking the ... button.
4. Check the data element’s time range.
5. Save the created data by selecting Save As under the Data Element menu or by
clicking the Save As button next to the Saved Data Elements window.

10.4.4 Weather Points Filter Editor

The Weather Points filter editor can display, add and modify weather point filters
in the data element. A Weather points filter is an dynamic object that defines a
group of weather points by using common parameters. Every time a data element
is opened, the filter is re-calculated and the matching points are added.

The Filters editor will be enabled only if the following conditions are met:

• The point type used in the graphics template was defined as a filtered point
type (see To configure a point type).
• The graphics template includes Weather Point designs, and the desings use a
point type that is defined as a filtered point type.

This section contains information on the following topics:

• Properties and Parameters


• Columns

Chapter 10: Working with Data Elements 151


• To add a new points filter

Properties and Parameters

• Add new points filter: Adds a new weather points filter to the data element.
This button is enabled only if a weather point design was defined in the
graphic template.

• Edit filter: Opens the selected point filter for editing. Another option to open
the filter parameters editor is to double-click the filter entry.

• Delete a filter: Deletes weather point filters from the data element.

• Populate selected filters: Re-calculates selected filters and updates the points
in the data element.

• Populate All filters: Re-calculates all filters in the data element and update the
points in the data element.

Columns
• ID: Displays the filter ID.
• Name: Displays the filter name (as it was set in the filter parameters editor.
• Num: Displays the number of points matching the filter parameter that were
added to the data element.
• Text: display the filter fields and selections in text format.
• Visible: this attribute defines if the weather point of the filter will be displayed
in the graphics or not.

To add a new points filter


1. Click the Add weather points filter button to add a filter node to the data
element.
The Point Filter Parameters window will open.

152 Chapter 10: Working with Data Elements


2. Set the required filter by setting parameter values inthe filter.

3. For the Global filter parameters:


• Select the Point Type to add from.
• Select the Forecast that will be displayed in the added points.
• Select the Point style that will be applied to the added points.
• Include Data Element Date Range. This parameter will be enabled only if a
pair of specific data fields were added to the selected point type. The
parameter is used when working with weather alerts and warnings, where a
point also has a time range in which it is effective. It does not apply for
regular weather point types.

4. For the Filter parameters:

Chapter 10: Working with Data Elements 153


• Select the check box next to the parameters you wish to include in the filter,
and set the parameter values.

Note: To use the BETWEEN option in a parameter, set the values separated by a
comma: 10,20.

Note: Select the Auto Calc option to see the updated number of points selected by
the filter.

5. Click OK.
The weather points will be added to the data element and the filter entry will
be added to the editor.

10.4.5 Fronts Editor

The fronts editor can display, add and modify weather fronts.

The front is animated by changing its position and shape, and setting keyframes
in the different positions.

The date time range for the data element must be declared in order to add
keyframes to the animation.

Selecting a row in the weather front table will select the weather front object in
the render window and the other way around- selecting the weather front in the
render window will highlight the row in the text editor.

This section contains information on the following topics:

• Properties and Parameters


• Columns
• To create a front
• VisibilityTo animate a front
• To delete a front
• To add a keyframe
• To delete a keyframe

154 Chapter 10: Working with Data Elements


Properties and Parameters

• Add front: Adds a new front to the scene.

• Delete front: Deletes the selected front from in the scene.


• Fronts layer visible: Defines if the fronts layer will be displayed in the graphics.
When unchecked al fronts will be hidden.

• Add/Update front keyframe: Adding new keyframe or updating an existing


keyframe of the front. The keyframes create an animation of the front object.
The animation is time dependent and the keyframes are displayed in the Front
forecast time area.

• Delete front keyframe: Deletes the selected keyframe.

• Vertical Flip: Flips the selected front vertically.

• Horizontal Flip: Flips the selected front horizontally.

• Mirror: Mirrors the selected front texture.

• Reset: Resets the selected front as a flat front object in the middle of the map.
• Fronts from file: When selected, the text field and the browser will be enabled.
When a file is selected the fronts from the file will be loaded to the graphics.
Note that the file is an exported weather element file (Weather element->
Export weather elements).

Columns
• ID: The front’s serial ID.
• Style: The design used for the front. Select a design from the drop-down list.
• Type: The type of front. Values are: warm, cold or occluded.
• Alpha: The alpha value used for the front object.
• Visible: This attribute will set the visibility of the specific front. When
unchecked the front will not be displayed in the graphics.

Chapter 10: Working with Data Elements 155


When right-clicking the editor area, a context menu will appear. The context
menu provides a few options for line manipulation and columns view:

• Copy Lines (CTRL+C): Copy the selected lines to the clipboard.


• Paste Lines (CTRL+V): Paste lines from the clipboard to the editor.
• Delete Lines (CTRL+DELETE): Delete the selected lines.
• Select All Lines (CTRL+A): Select all lines in the editor.
• View Columns: When selected, additional columns will be displayed: X1,
X2..X6 - The X values of the front points Y1, Y2..Y6 - The Y values of the front
points.
• Hide Columns: When selected, the values of the front points locations are
hidden.

To create a front
1. Click the Add a front button to add a front to the graphic template.
A new front entry will be added in the editor. Note the hand icon in the Edit
field; this means the front object is in editing mode, and you can left-click on
the map to add points to the front and create a front object.

2. To exit editing mode, right-click the render window.


3. Select a front style from the drop-down list to change the front object and
select the front type.
4. Set the front attributes:
• Alpha value
• Width
• Smoothing

156 Chapter 10: Working with Data Elements


VisibilityTo animate a front
1. Select the Data animation in the animation combo box.
2. Move the date time track bar to the required keyframe location.
3. Choose the required front in the Viz scene or in the editor.
The control points on the front will appear. The selected point will be colored
yellow and the object’s global point is colored red.
4. To move the front in the render window interactively, use the options in the
following table:

Left mouse Middle mouse Right mouse


(MOVE) (ROTATE) (SCALE)

(default mode) Moves 1 point. Rotate around Scale all shape.


point.

SHIFT Move all points


(relative mode) according to
selected point.

5. Another option for moving the front is to change any of X1..x6 or Y1..Y6 val-
ues in the UI.
6. To see the X,Y columns in the editor right-click the column titles area.
7. Select View Columns to see all the X,Y values, or select Hide Columns to hide
the X,y columns.

Note: The animation buttons (add keyframe) will be disabled if no time range was set
for the data element.

To delete a front
• Select a front and click the Delete front button.

To add a keyframe
1. Add the keyframe to the front by clicking the Add / Update front keyframe
button.
2. Repeat the process to add more keyframes.

To delete a keyframe
• Select the keyframe by clicking the keyframe button then clicking the Delete
front keyframe button.

Chapter 10: Working with Data Elements 157


10.4.6 Model Data Editor

The Iso Bars, Iso Therms and Iso Precip editors can display and modify
atmospheric pressure levels, temperature map, and the graphic representation of
precipitation levels, respectively. The functionality for each of them is similar,
with the exception of GUI parameters and the type of data that is read.

The Model Data editor includes three types of data editors:

• Iso Bars (Lines): Used to display contours of areas, created from fetched model
data. This option is usually used to display pressure levels (IsoBars).
• Iso Therms (Bands): Used to display sequential colored segments on the map.
These segments are created from fetched model data and cover the entire
defined area. This option is usually used to display temperature levels.
• Iso Precip (Filled): Used to display areas of colored segments on the map.
These segments are created from fetched model data and cover pieces of the
defined area.This option is usually used to display precipitation levels.

Multiple model data objects can be used in one graphic template. Each tab in the
editor represents such an object and displays the object’s Control Tab ID and
name (set by the designer in the scene).

Select one of the model data tabs of the editor. The editor will change according
to the selected object type.

Properties and Parameters

• Visible: When pressed the Iso layer will be turned off and will not show in the
render window.
• Use Pre Processing Cmd: This check box is enabled only if a pre processing
command was defined in the fetch parameters settings window. Default pre
processing command is null, i.e. no processing is performed. The pre
processing command is used to define a program that will process the
downloaded data before it is used by the IsoGrid plug-in, to create the iso
objects.
• Loaded images: Displays the number of frames generated by the IsoGrid plug-
in.
• Model Name: Select the model to be displayed. Iso information is used in
different meteorological models, used by different data suppliers. The list of
models is configured in the WD_Admin window, in the Model Data tab.
• Time Step (min): Defines the time gap between the Iso frames. If the time step
is set to 15 minutes, four frames per hour will be created. Default is 30

158 Chapter 10: Working with Data Elements


minutes. The smaller the time step is, the smoother the animation between
the iso frames will be, but, the larger the number of images will be. Using a
small time step will slow down the system and will decrease the performance
of the renderer.
• Smoothing: When the check box is checked the smoothing editor will be
enabled. The smoothing parameter defines the interpolation performed on the
model data to reduce the jagged edges of the displayed data. The higher the
smoothing is, the less jagged the displayed iso information will be. Note that a
high smoothing value also reduces the accuracy of the information. When
setting a smoothing parameter it is applied only to the currently displayed
frame. When reaching the desired effect, click the Apply button to apply the
smoothing parameter to all data frames.
• Levels: This group of parameters varies between data types.
• Min: Minimum level used in the plugin calculations
• Max: Maximum level used in the plugin calculations
• Level SIze: The gap between every displayed level, i.e. the number of levels
will be Max-Min/Interval.
• No of Levels: Number of levels to display, i.e. the gap between each level is
Max-Min/No of Levels.
• Data: Specifies the required precipitation levels, if any.
• Contours Width: The width of the contour lines between the levels or the
width of the pressure lines.

• Displays the minimum and maximum levels of the loaded data. This
button is enabled only after setting the time range of the data element.
• Latest: Use the latest downloaded information. The path to the latest
downloaded information is defined in the Data Import window under the Fetch
tab.
• From Directory: Select a directory containing the information to be displayed.
Use the browser or type the path in the text field. When browsing, select a
model folder and go down to a folder named hours.

10.4.7 Satellite Editor

Properties and Parameters

• Satellite layer visible: When pressed, Satellite layer will be turned off and will
not show in the render window.

Chapter 10: Working with Data Elements 159


• Area: select the satellite from which the images were taken. The list of
satellites is derived from the satellites defined in the fetch parameters
configuration.
• Alpha min threshold: Sets a minimum threshold of an alpha value (0=black,
255=white). All the parts of the image under the minimal threshold will be cut
from the satellite image (luminance key).
• Alpha max threshold: Sets a maximum threshold of an alpha value (0=black,
255=white). All the parts of the image above the maximal threshold will be cut
from the satellite image (luminance key).
• Latest: Uses the latest downloaded satellite images. The path to the latest
downloaded information is defined in the Data Import window under the Fetch
tab.
• From Directory: Select a directory containing satellite images to be displayed.
Use the browser or type the path in the text field.

Note: The number of satellite images is shown in the editor after loading.

10.4.8 Map Editor

Modify the map of the graphic template. Map source is a Geo Image in the Viz
Images library or a map produced by Viz World Map Server.

This section contains information on the following topics:

• Properties and Parameters


• Map Browser
• Map Editor

Properties and Parameters

• Map layer visible: When pressed, the map layer will be turned off in the
graphics.

Note: This operation will also turn off all geo referenced layers residing under the
map container in the graphic template scene tree.

160 Chapter 10: Working with Data Elements


• Map Layers: Map layers is a feature supported by Viz World Maps Server. When
requesting a map from the server, the server returns the map and additional
information about the selections made by the user (Layers).
• The layers are different types of information added to the map, like borders,
roads, railways, and so on. When using a graphic template that is designed
to support this information, it will appear in the layers area.
• The user can switch on or off any layer exposed in the graphic template by
checking the visibility check boxes of the layers.

Note: The relation between Map Layer Visible parameter and the Map Layers
parameter is derived from the graphic template’s design. If the layers are placed
under the map container then Map Layer Visible will affect the map layers.

• Map Params from file: When checked, additional parameters specified in the
defined file will affect the map. This file is a Viz Traffic data file and contains
zoom information for the map.
• Map Parameters: When the map icon in the editor is clicked the map browser
window will open.

Chapter 10: Working with Data Elements 161


Map Browser

• Viz Images: Browse the Viz image folder tree on the left side of the window.
Double-click a map or select and click the OK button to change the map in the
graphic template.

Note: The root of the images in Viz image tree is defined by the parameter
“images_dir=” in the initialization file (see the Application Level Settings section).
Default is the images root.

• The images with the globe icon are geographically referenced images that
enable the use of the geographic data to position weather points at their
actual geographic location relative to the image.

• From Server: When selecting the From Server radio button, a Viz World Maps
Editor will open. The radio button “From Server” (i.e. Viz World Maps Server) is
only enabled if the following conditions are met:
a. Viz World Maps Client is installed on the Viz Weather machine.
b. Viz World Maps Server is enabled and configured in Viz Config.
c. Viz World Maps is enabled and configured in the initialization file (see the
Application Level Settings section).

162 Chapter 10: Working with Data Elements


Map Editor

The Viz World Maps Editor allows you to create a map on-the-fly. Creating a will
change the map in the graphic template to the map created by Viz Curious Maps.

See Also
• Viz World User’s Guide

10.4.9 Pressures Editor (Extremes)

The Pressures editor can display, add and modify pressures objects. The pressure
editor is used for manually adding pressure sign objects to the graphic template
and animating the added objects.

Note: Selecting a row in the pressures table will select the pressure node in the Viz
scene, and vice versa - selecting the pressure node in the render window will select
the row in the pressures editor.

Chapter 10: Working with Data Elements 163


This section contains information on the following topics:

• Properties and Parameters


• Editor Context menu
• Columns
• To create a pressure sign
• To animate a pressure sign
• To add a keyframe
• To delete a keyframe
• To delete a pressure sign

Properties and Parameters

• Add high pressure sign (H): Adding a new high pressure object to the graphic
template.

• Add low pressure sign (L): Adding a new low pressure object to the graphic
template.

• Delete pressure sign: Delete the selected pressure object.


• Pressure layer visible: when checked all pressure objects will be visible to the
user. When unchecked, pressure objects layer will be turned off and will not
show in the render window.

• Add / Update pressure sign keyframe: Adding new keyframe or updating an


existing keyframe of the front.

• Delete pressure sign keyframe: Delete the selected keyframe.

Editor Context menu

The context menu provides a few options for line manipulation:

• Copy Lines (CTRL+C): Copy the selected lines to the clipboard.


• Paste Lines (CTRL+V): Paste lines from the clipboard to the editor.

164 Chapter 10: Working with Data Elements


• Delete Lines (CTRL+DELETE): Delete the selected lines.
• Select All Lines (CTRL+A): Select all lines in the editor.

Columns
• ID: Unique identifier
• Type: Low or High object.
• Longitude: Longitude position value of the object on the map
• Latitude: Latitude position value of the object on the map
• Scale: Scale factor of the pressure object
• Alpha: Alpha values of the object
• Visible: Defines the visibility of each object.
• Smooth: Animation smoothing

To create a pressure sign


• Add a pressure object to the graphic template by clicking the Add High
pressure sign or Add Low pressure sign button, or by copying and pasting a
line in the editor.

To animate a pressure sign


The pressure signs are animated by changing its position and size, and setting
keyframes in the different positions. The date time range for the data element
must be declared in order to add pressure signs animation.

1. Choose the Data animation in the animation combo box.


2. Move the date time track bar to the required keyframe location.
3. Choose the required pressure sign in the Viz scene or in the editor.
4. Drag the pressure sign by using the mouse or by changing the X, Y columns in
the editor list to change the object’s Position.
5. Change the value in the Scale column in the editor list to change the scaling.

To add a keyframe
1. Add the keyframe to the pressure by clicking the Add / Update pressure sign
keyframe button.
2. Repeat the steps above to add more keyframes.

To delete a keyframe
• Select the keyframe by clicking the keyframe button, then click Delete
pressure sign keyframe the button.

To delete a pressure sign


• Select the pressure then click the Delete pressure sign button.

Chapter 10: Working with Data Elements 165


10.4.10 Images Editor

Modify an image in the graphic template (replace the image). This editor is
enabled if the graphic designer exposed an image or more for editing.

Properties and Parameters

• Image layer visible: Defines if the exposed images will be visible in the
graphics. If pressed, all exposed images will be hidden in the graphics.

• Targa clips editor: This editor enables the user to replace the clips defined in
the scene as sources for Video Hub, Targa or Matrox video cards clips. When
the button is clicked a Targa configuration window will open, enabling the
user to browse and select a video clip.

Columns
• Node Name: The Viz scene node name
• Icon: The icon of the currently selected image
• Image Name: The full Image name (full path)
• Visible: This attribute defines if the image will be visible in the graphics. When
selected, the image will show in the renderer.

166 Chapter 10: Working with Data Elements


To change video clips

1. Browse and select the new clips for codec1 (video 3) and codec2 (video 4).
2. Click OK.
The clips used in the scene will be replaced by the newly selected clips.
3. Click the VME button to browse the Viz One clips.
4. Select a clip and click OK.

Note: The Viz One (VME) buttons will be enabled only if a Viz One has been
configured in the Settings > System window.

To change an image

1. Double-click an image in the image editor to open the Choose Image window.

Chapter 10: Working with Data Elements 167


2. Select one of the following options: Viz images, VIDEO source, From file (on
disk) or a Clip.
• When selecting Viz images you will be able to browse the Viz image tree to
select an image.
• When selecting VIDEO you will be able to choose between the 4 output
channels.
• When selecting From file you will be able to browse the local and mapped
directories to select an image from disk.
• When selecting Clip you will be able to browse the local and mapped
directories to select a clip.
3. When done, click OK.

10.4.11 Radar Editor

Properties and Parameters

• Radar layer visible: Defines if the radar images will be visible in the graphics. If
unchecked, all radar images will be hidden in the graphics.
• Area: Select the area shown in the radar images. The drop-down menu
options are Viz Weather defaults, or taken from Radars tab in the Fetch
Parameters configuration.
• Latest: Use the latest downloaded radar images. The path to the latest
downloaded information is defined in the Data Import window under the Fetch
tab.
• From Directory: Select a directory containing radar images to be displayed.
Use the browser or type the path in the text field.

168 Chapter 10: Working with Data Elements


10.4.12 Special Objects Editor

The objects editor can add and modify special objects. An object can be a storm,
fire, blizzard, and so on. Special Objects are designed by the graphic designer in
the graphic-template, and exported to be used by the user in Viz Weather. The
graphic designer can also export the option to use objects from Viz objects
library.

Note: Selecting a row in the weather object table will select the object in the render
window and vice versa - selecting the object in the render window will highlight the
row in the object editor.

This section contains information on the following topics:

• Properties and Parameters


• Columns
• To create an object
• To add a keyframe
• To animate an object
• To delete a keyframe
• To delete an object

Properties and Parameters

• Add object: Adds a new object to the scene.

• Delete object: Deletes the selected object from in the scene.


• Special objects layer visible: Defines if the special objects will be visible in the
graphics. If unchecked, all the special objects will be hidden in the graphics.

• Add / Update object keyframe: Adds a new keyframe or updates an


existing keyframe of the selected object.

• Delete object keyframe: Deletes the selected keyframe.

Chapter 10: Working with Data Elements 169


Editor Context menu

The context menu provides a few options for line manipulation:

• Copy Lines (CTRL+C): Copy the selected lines to the clipboard.


• Paste Lines (CTRL+V): Paste lines from the clipboard to the editor.
• Delete Lines (CTRL+DELETE): Delete the selected lines.
• Select All Lines (CTRL+A): Select all lines in the editor.
• Display Options: Defines how field information is displayed in the editor:
• Icon only
• Text only
• Icon and text

Columns
• ID: The object’s serial ID
• Style: The style of object. Values are derived from exported object designs in
the graphic template.
• GH: Highlights if the selected object style is defined as a Viz Graphic Hub
object.
• Longitude/X: The object’s longitude value
• Latitude/Y: The object’s latitude value
• Geo: Displays the object’s positioning properties:
• Fixed (locked): The user cannot move the object in the graphics. The fixed
objects are marked with a lock icon.
• Movable: The user can move the object by dragging it in the render window
or by setting an X/Y value in the UI. The movable objects are marked with an
axis icon.
• Geo: The object is positioned according to its Long/Lat values. The user
cannot move the object manually. The geo objects are marked with a lock
icon.
• Geo-Movable: The object is positioned according to its Long/Lat values. The
user can move the object by changing the Long/Lat values manually. The
geo-movable objects are marked with a globe icon.
• Scale: Set the object’s scale.
• Rotate: Set the object rotation around the Z axis.
• Alpha: Set the alpha value of the object.

170 Chapter 10: Working with Data Elements


• Visible: This attribute defines if the object will be shown in the graphics. If
visible is checked the object will appear in the graphics.
• Link to file: Defines a Viz Weather elements file that will be used in the
graphics. The file contains objects and related data. The objects in the file are
linked to the data element. When saving the data element, only the file name
and path are saved. When loading the data element or initializing it, the file is
reloaded.

Note: The graphic template must have the same objects defined in the loaded file.

To create an object
1. Add an object to the graphic template using the Add Object button or copy
and paste lines in the editor.
2. Select the required object design.
If a Graphic Hub object is selected, a GH icon will appear in the line.
3. Click the icon to open the object browser in Viz library.
4. Select the required object and click OK.
The object will appear in the graphics.

To add a keyframe
• Add the keyframe to the object by clicking the Add / Update object keyframe
button.

To animate an object
The object is animated by adding keyframes at different time points and in
different positions.

The date time range for the data element must be declared in order to add object
animation.

1. Select the Data animation in the animation combo box.


2. Move the date time track bar to the required keyframe location.
3. Select the required object in the Viz scene or in the editor.
4. Drag the object in the render window using the left mouse button.
5. Change the scale value in the UI.

To delete a keyframe
• Select the keyframe by clicking the keyframe button, and then clicking the
Delete object keyframe button.

To delete an object
• Select an object and click the Delete object button.

Chapter 10: Working with Data Elements 171


10.4.13 Flows Editor

The flows editor can display, add and modify flows. A flow can be a wind stream,
oceanic stream, and so on. The different types & designs of the flows (styles) are
designed by the graphic designer in the graphic-template, and exported to the
user.

Note: Selecting a row in the weather flow table will select the weather flow object in
the render window and vice versa - selecting the weather flow in the render window
will highlight the row in the flow editor.

This section contains information on the following topics:

• Properties and Parameters


• Columns
• To create a flow
• To animate a flow
• To add a keyframe
• To delete a keyframe
• To delete a flow

Properties and Parameters

• Add flow: Adds a new flow to the scene.

• Delete flow: Deletes the selected flow from in the scene.


• Flows layer visible: Defines if the flows layer (i.e. all added flows) will be
displayed in the graphics. When checked the flows will be visible.

• Add / Update flow keyframe: Adds a new keyframe or updates an existing


keyframe of the flow.

• Delete flow keyframe: Deletes the selected keyframe.

172 Chapter 10: Working with Data Elements


• Reset: Resets the selected flow as a flat flow object in the middle of the map.

• Visible: Defines if the flows layer will be shown in the graphics.

Columns
• ID: Shows the flow’s serial ID.
• Style: The style of flow. Values are derived from exported flow designs in the
graphic template.
• Closed: This attribute defines if the flow’s ends will be open or closed.
• No. of points: Displays the number of control points defined when the flow
was added. The number of points cannot be changed after the flow was
created.
• Color: Displays the selected color of the flow. When clicked, a color palette will
open enabling the user to change the color.

When right-clicking the editor area, a context menu will appear. The context
menu provides a few options for line manipulation and columns view:

• Copy Lines (CTRL+C): Copy the selected lines to the clipboard.


• Paste Lines (CTRL+V): Paste lines from the clipboard to the editor.
• Delete Lines (CTRL+DELETE): Delete the selected lines.
• Select All Lines (CTRL+A): Select all lines in the editor.
• View Columns: When selected, additional columns will be displayed: X1,
X2..X6; the X values of the flow points, and Y1, Y2..Y6; the Y values of the flow
points.
• Hide Columns: When selected, the values of the flow points locations are
hidden.

To create a flow
1. Click the Add a flow button to add a flow to the data element.
A new flow entry will be added in the editor. Note the hand icon in the Edit
field; this means the front object is in editing mode, so that you can left-click
on the map to add points to the front, and create a front object.

Chapter 10: Working with Data Elements 173


2. To exit editing mode, right-click the render window.
3. Select a flow style from the drop-down list to change the flow object and
select the flow type.
4. Set the flow attributes:
• Alpha value
• Width
• Smoothing
• Visibility
• A color can be applied to the flow.
• Select the Closed check box to connect between the flow ends and create a
closed flow.

To animate a flow
The flow is animated by changing its position and setting keyframes in the
different positions.

The date time range for the data element must be declared in order to add flow
animation.

1. Select the Data animation in the animation combo box.


2. Move the date time track bar to the required keyframe location.
3. Select the required flow in the Viz scene or in the editor.
4. Change the flow location and shape and click the Add flow keyframe button.
5. To move the flow in the render window interactively, use the options in the
following table:

Left mouse Middle mouse Right mouse


(MOVE) (ROTATE) (SCALE)

(default mode) Moves 1 point. Rotate around Scale all shape.


point.

SHIFT Move all points


(relative mode) according to
selected point.

6. Another option for moving the flow is to change any of X1..x6 or Y1..Y6 values
in the UI.
7. To see the X,Y columns in the editor right-click the column titles area.

174 Chapter 10: Working with Data Elements


8. Select View Columns to see all the X,Y values, or select Hide Columns to hide
the X,y columns.

To add a keyframe
• Add the keyframe to the flow by clicking the Add / Update flow keyframe
button.

To delete a keyframe
• Select the keyframe by clicking the keyframe button,and then click the Delete
flow keyframe button.

To delete a flow
• Select a flow and click the Delete flow button.

10.4.14 Clouds Editor

The clouds editor is used for displaying cloud forecast. Three levels of clouds are
available for display.

Properties and Parameters

• Clouds layer visible: When pressed cloud images layer will be turned off and
will not show in the render window.
• Area: select the area shown in the clouds images.
• Number of images loaded: Displays the number of cloud images loaded in the
graphics, in each cloud elevation.
• High, Medium, Low: Elevation levels of the displayed clouds. Select a check
box to display the data of the specified elevation.
• Latest: Use the latest downloaded clouds data. The path to the latest
downloaded information is defined in the Data Import window under the Fetch
tab.
• From Directory: Select a directory containing clouds images to be displayed.
Use the browser or type the path in the text field.

Chapter 10: Working with Data Elements 175


10.4.15 Winds Editor

The Winds editor is used for displaying wind flow data. The wind flow is displayed
with arrows over particles simulating wind movement.

Properties and Parameters

• Visible: When selected, the layer will be turned off and will not show in the
render window.
• Loaded images: Displays the number of frames generated by the WGrid plug-
in.
• Model Name: Select the model to be displayed. Iso information is used in
different meteorological models, used by different data suppliers. The list of
models is derived from the ServerConfig.xml file located under the
XMLConfigFiles folder.
• Fixed Size: Defines if the particles representing wind movement will have the
same size.
• Size Factor (%) / Size: If Fixed Size parameter is checked, Size parameter will
define the particles size. If Fixed Size parameter is un-checked, Size Factor
parameter will be applied to all particles size.
• Speed Factor: Defines a factor for particles movement speed. A high value will
cause the particles to move faster.
• Latest: Use the latest downloaded information. The path to the latest
downloaded information is defined in the Data Import window under the Fetch
tab.
• From Directory: Choose a directory containing the information to be
displayed. Use the browser or type the path in the text field. When browsing,
select a model folder and go down to a folder named hours.

176 Chapter 10: Working with Data Elements


10.4.16 Storm Path Editor

The Storm Path editor displays, adds and modifies storms and storm path forecast
in the data element.
All storm information is taken from a storm path forecast file. The file is in an XML
format and contains the data according to the defined parameters in the fetch
parameters configuration. The data file is fetched (downloaded) with other
meteorological data from the data supplier. The file contains storm ID (name),
time and geographical location describing the storm path.

The number of storms in the data file is displayed next to the Area file. After
selecting the time range, the number of storms in the defined time range is
displayed. If adding storm objects from the data, and then clicking the magic
dates button in the time range window, the time range will be set according to the
selected storms.

Properties and Parameters

• Add storm: Adds a storm to the display. Select a style for the storm and an
animation mode for displaying the storm progress.

Note: The maximal number of storms added to a data element is limited to 16.

• Delete storm: Deletes the selected storm from the display.

• Storm Path Layer Visible: Hides or displays the storm path layer. The button
will affect all added storms.

Chapter 10: Working with Data Elements 177


Editor Context menu

The context menu provides a few options for line manipulation:

• Copy Lines (CTRL+C): Copy the selected lines to the clipboard.


• Paste Lines (CTRL+V): Paste lines from the clipboard to the editor.
• Delete Lines (CTRL+DELETE): Delete the selected lines.
• Select All Lines (CTRL+A): Select all lines in the editor.
• Area: This field is enabled when using Latest as the data source folder. Select
the data type to be used from a list of storm sources defined in the system
(Configuration -> Fetch Parameter).

Columns
• Storm Name: Sets the name of the selected storm. Storm name list is derived
from the available storms found in the data file. If a storm no longer exists a
popup message will warn the user and the storms will not be displayed.
• Style: Select a design to be used with the storm instance. The designs are a set
of graphic objects, created by the designer, used for visualizing the storm
path.
• Display Mode: Defines if the style is static thru the graphic animation or the
objects will be animated, and is only used in an array type style.
• Range: Select the time range that will be represented by the selected style. The
range options are:
• Observation: Use only observed data of the storm path.
• Last Observation: Use only the last observed data of the storm path.
• Forecast (+last observation): Use the last observed data of the storm path
and all forecast data of the storm path.
• Forecast: Use only forecast of the storm path.
• Forecast (custom): When selected, a list of forecast points will be displayed
for selection. Select the forecast points to display.
• Custom: Displays the selected forecast points list by their index. This
column is used when range is set to Forecast (custom) option.
• All: Displays all available data in the storm path file.
• Visible: Check the storm objects to be displayed in the graphic.

178 Chapter 10: Working with Data Elements


10.4.17 Hops Editor

Hops are smooth location leaps over a map. A Hop is one location defined on the
map. Minimal number of hops required in a data element is two. After the hops
are defined, the animation will leap from one place to the other, while zooming
out from the initial location, “flying” over the map to the other location and
zooming back in.

This option requires a special scene design, using plug-ins supplied in the Viz
World Maps Client installation package. The hop containers are exported by the
WInterface plug-in, enabling the Hops editor in Viz Weather. When the editor is
selected it will allow the user to Display/Add/Modify the hops (location, flight
pattern and other parameters).

Properties and Parameters

• Add Hop: Adds a Hop to the data element.

• Delete Hop: Deletes the selected Hop from the data element.

Note: Pre-defined hops in the scene design cannot be deleted. Only added hops can
be deleted from the data element.

Context Menu

• Copy Hop: Copy the values of the selected hop.


• Paste Hop: Paste the values of the last copied hop to the currently selected
hop.

The Hop Parameters affect the selected hop. The hop is selected by clicking the
hop button.

• Name: Edit the hop name. The initial name displayed on the button is derived
from the container name in the graphic template. Set the name by typing a
new name in the text box.

Chapter 10: Working with Data Elements 179


• Type: There are two defined types of hops:
• Map: The hop location is defined by the selected map in the Map parameter.
Click the Map icon to select a map from Viz images library or from Viz World
Maps server (This option requires a licensed server running and connected
to your network). Adjust the Pan, Tilt and Zoom parameters to fine tune the
hop location (See image above).
• Point: The hop location is defined by a point on the map (geographical
point). When selecting Point as the hop type the editor will change and
different parameters will be displayed:

Figure 9: Settings for manual map selection

There are three ways to set the hop location:

• Manual: Manually change the values of the Longitude, Latitude and Distance
parameters. The map view will change accordingly.
• Search for a place: Click the Search City button (next to the Longitude/Latitude
parameters) to open the Search Place window. Enter a search string or the full
name and select a location from the results list. When the OK button is clicked
the Longitude and Latitude parameters will be updated with the selected place
values and the map will jump to show the selected location. Adjust the
Distance and fine tune the Longitude and Latitude values.
• Interactive: Click the map while pressing the I (for Interactive) key. By clicking
and dragging the map the location is changed and by using the mouse roller
the map distance will change. When the I key is released, the Longitude,
Latitude and Distance parameters will be updated according to the selected
location (center of the render window). Adjust the Pan, Tilt and Zoom
parameters to fine tune the hop location.

Note: When using a graphic template with the CWMClient and pyramid plug-ins, and
changing the hop location, the pyramid will be rebuilt only if the hop type is set to
Map and the map is selected from the Viz World Maps server. In any other case the
base map resolution will be the highest resolution available and the pyramid.

• Flight Time (Sec): Set the current hop flight time.

The Common Parameters are used for all the defined hops:

• Stop Type: Defines the animation behavior when arriving at a hop. If Stop is
selected, the animation will stop and wait for a continue command to animate
to the next hop. If Pause is selected the animation will pause, for the number
of seconds defined in the edit box, at the hop location.
• Flight Time (Sec): Set the gloabl hop flight time.

180 Chapter 10: Working with Data Elements


Note: The hop flight time is defined as Global or single hop in the graphic template
(Navigator plug-in). When Global flight time is set, the single hop flight time is
disabled and the other way around.

10.4.18 Graffiti Editor

Graffiti editor is used to manually draw lines and shapes using the mouse or other
pointing device. The Graffiti enables the user to draw free hand over a graphic
template, and save the data element. This feature is mainly used in an interactive
setup.

Note: The Graffiti functionality is supported over a Globe object only. Other scene
hierarchy may produce unexpected results.

Properties and Parameters


• Visibility: Hide or show the Graffiti layer (all graffiti layers will be hidden).
• Layer: Select a graffiti layer to work with. Different layers can effect different
drawing areas, Z offset, and so on.
• Visible: Defines if the selected layer will be visible or not.

The Graffiti Parameters affect the selected layer:

• Mode: Select Draw to draw a line or Erase to delete a line.


• Width: Set the required line width.
• Color: Select a drawing color.
• Recognize: When selected, the Graffiti plug-in will identify and convert the
drawn pattern into one of the enabled shapes:
• Ellipse: Complete a drawn pattern into an ellipse shape
• Circle: Complete a drawn pattern into a circle shape
• Cross: Change the drawn pattern into a cross shape
• Arrow: Change the drawn pattern into an arrow (add the arrow point)

Note: If Recognize is disabled (un-checked), the drawn pattern will not be modified.

• Undo: Revert the last drawing operation.


• Redo: Re-draw the last reverted operation.

Chapter 10: Working with Data Elements 181


• Clear: Delete the drawn objects in the selected layer.

10.4.19 Time Range Editor

The time range editor defines the time range for meteorological data that will be
used in the data element. If existing data does not cover the entire time range
selected, a red indicator will be displayed under the From or To time fields,
indicating the difference between existing data and requested time range. If the
time range is within the existing data, the indicator will turn green.

The Time Range editor button has three states:

Time range is not set for the data element in editing.

Time range is set and data exists for the selected time range.

Time range is set but not all data exists for the selected time range.

Properties and Parameters

Figure 10: Select from calendar date

• From: Defines the start time of the data element. Set the day and time by
selecting a relative day from the drop-down list or by clicking the calendar
icon next to the list and selecting the required date.

182 Chapter 10: Working with Data Elements


Figure 11: Select from relative day list

• To: Defines the end time of the data element. Set the day and time by selecting
a relative day from the drop-down list or by clicking the calendar icon next to
the list and selecting the required date.
• Details: When clicked, the Time Range editor window will expand displaying
the available data on disk for the data types displayed in the data element.

• Magic Dates: When pressed, Viz Weather will automatically fill the From and To
fields, according to the data types used in the data element and the data
existing on disk.

10.4.20 Animation Editor

The Animation editor is a common editor shared by all data elements. It defines
the animation properties that will be used in the data element.

Animation parameters are enabled once a time range for the data element has
been set.

Chapter 10: Working with Data Elements 183


Properties and Parameters
• Length: Set the total time of the data element animation.
• Iterate: Set the data element iteration type:
• Once: Run the animation once and stop
• Loop: Run the animation repeatedly in a loop.
• Data Element Length: Select the check box to set the data element time in the
playlist. There are two options to set the duration in the playlist:
• By Sound: This option is disabled until a sound file is selected. When a
sound file is selected, the data element length will be set to the length of
the sound file.
• Manual: Set the duration in seconds.

Note: When the data element is dragged to the playlist, the take out type will be
automatic and the Time will be set to the specified value.

• In the Playlist Continue Control area, select the director that will be effected by
playlist continue commands.
• Select the Expose stop points option to use the animation stop points in the
playlist.
• Sound File: Set a sound clip to be played with the data element.

Note: Additional settings are required to play sound clips with data elements. See
Application Level Settings in the System configuration chapter.

• Expose Multi Snaps: Use multi snap points in the data element when post
rendering snap shots. Snap shot points are defined in the graphic template by
the graphic designer.
• Stop/Pause Points: Add stop points or pause points to the data element
animation.

These points are added to the stop/pause points defined in the graphic template
(if any). Select the animation director to add the stop/pause points. When adding
a pause point, set the pause time parameter.

184 Chapter 10: Working with Data Elements


10.4.21 Camera Selection Editor

The camera selection editor allows the user to change the camera view in Viz.
Selecting a camera from the editor will change the view of the graphics to the
selected camera in Viz. The camera point of view is saved with the graphic
template in Viz.

10.5 Debugging a Data Element


When experiencing a problem with data element behavior a debug option is
available in Viz Weather.

This section contains information on the following topics:

• To enable debug logging using the Viz Weather UI


• To enable debug logging using the initialization file

To enable debug logging using the Viz Weather UI


1. Add the following entry to the initialization file (see the Application Level
Settings section):
[MISC]
show_debug_info=y

2. Start Viz Weather, and click View and select Debug Window from the appearing
menu.
3. In the debug menu at the bottom of the Debug Messages tab select the
options to record the playlist and/or the data.

• When the options are checked (from the UI or from the INI file), files will be
created in the viz_weather folder:
• InitCommands_On-air.txt: Commands that were send to On-air machine.
• InitCommands_Preview.txt: Commands that were send to Preview machine.
• Commands_DblClick_Data.txt: Commands that were send during opening a
data to edit.

To enable debug logging using the initialization file

Add the following entries to the initialization file (see the Application Level
Settings section):

Chapter 10: Working with Data Elements 185


[MISC]
record_init_command=y
record_data_command=y

These entries will record init commands sent to Viz by Viz Weather and data
commands sent to Viz.

See Also
• Debug Window

186 Chapter 10: Working with Data Elements


11 Working with Playlists

A Playlist is a sequence of data elements, clips, Viz scenes and external Viz
commands that will be executed during production.

A playlist is associated with one or more Viz Engine machines, used for rendering
the graphics. The Viz Engine machines are defined as an On-Air machine or a
Channel (multiple channels are allowed). See the Playlist Properties section for
additional information about channels.

Chapter 11: Working with Playlists 187


Usually the list will be executed in the same order it was created/organized,
playing line by line manually or automatically.

This section contains information on the following topics:

• Playlist Properties
• Playlist Content Area
• Playlist Control
• Exporting A Playlist
• Importing a Playlist

188 Chapter 11: Working with Playlists


Figure 12: Playlists

Playlist Folder
Playlists are organized in folders. The folders are defined in the System
Configuration window, under the Concepts & Folders tab. To add folders to the
list, click the Add button. To delete a folder, click the Delete button.

Note: The Delete button is enabled only if the folder is empty from playlists.

Chapter 11: Working with Playlists 189


Note: One default folder named pool_1 is used in the system and is defined by Viz
Weather.

This section contains information on the following topics:

• Context Menu
• To create a playlist
• To copy a playlist
• To delete a playlist

Context Menu

• Save: Saves the selected playlist.


• Save As: Saves a copy of the selected playlist using a new name.
• Copy: Copies the selected playlist to the clipboard.
• Paste: Pastes the playlist above the selected playlist. If the playlist name exists
the new playlist will be renamed (e.g. <playlist name_0>).
• Delete: Deletes the selected Playlist.
• Rename: Change the selected playlist name.
• Export To File: Export the selected playlist to a file, containing the playlist,
data elements, viz archive, weather points, and so on.
• Sort Playlists: A toggle menu item for sorting/unsorting the playlists list.
• Properties: Opens the Playlist properties window of the selected Playlist.

To create a playlist

1. Click the New Playlist button next to the Playlists editor, or select New
from the Playlist menu at the top of the Viz Weather menu, or right-click the
Playlist area and select New from the context menu.
A new Playlist will be added to the playlists.
2. Rename the Playlist.
3. Drag data elements to the temporary area.
4. Save the Playlist by selecting Save from the Playlist menu, or by clicking the
Save button left of the Playlist editor, or by right-clicking the Playlist area and
selecting Save from the context menu.

190 Chapter 11: Working with Playlists


To copy a playlist
1. Click the Save As button next to the playlist area, or select Save As from the
Playlist menu from the main menu, and in the appearing Save dialog enter a
new name and click Save, or
2. Right-click a playlist and select Copy from the context menu, then right-click
and Paste the playlist.
The playlist will be automatically renamed as <playlist name_0>.
3. Rename and Save the Playlist.

To delete a playlist
• Select a Playlist from the list, and Press the Delete key or right-click the
selected Playlist and select Delete from the context menu.

11.1 Playlist Properties


Right-click a playlist in the playlist area and select Properties from the context
menu and the Playlist Properties menu will open.

This section contains information on the following topics:

• General
• Layers

Chapter 11: Working with Playlists 191


11.1.1 General

This section contains information on the following topics:

• Transitions
• Prepare Ahead
• DataPool Actions
• Length
• Initialization
• Iteration

Transitions
• Default Transition: The default transition check box defines if Viz Weather will
use a transition when switching between data elements in the playlist during
playout.

192 Chapter 11: Working with Playlists


• If Default Transition is unchecked, data elements will go on-air using a
simple cut transition, unless a specific transition line is included in the
playlist.
• If Default Transition is checked, the transition editors will be enabled.
• Clicking the stop icon will open the transition selection window.Select a
transition from the list and click OK.

Note: The transitions list is defined by the transitions_dir parameter in


viz_weather.ini file. The content of the transitions folder is displayed in the
transitions window.

• Transition Duration: Defines if the transition should use the transition scene’s
animation length or a custom parameter (in seconds) to set the duration of the
transition effect.
• Set in Scene: The transition duration will use the animation length defined in
the transition scene.
• Automatic after X seconds: The transition duration will use the value of the
Time text field to set the transition length in seconds.

• Animation Freeze: Defines the scene mode during a transition:


• NONE: Both incoming and outgoing scenes will continue running the
animation during the transition.
• IN: Incoming scene will freeze the animation until the transition is
completed. Outgoing scene will continue to play the animation during the
transition.
• OUT: Incoming scene will play the animation during the transition. Outgoing
scene will freeze the animation when the transition begins.
• BOTH: Both incoming and outgoing scenes will freeze the animation during
the transitions.

Prepare Ahead
Prepare Ahead is an automatic fetch mechanism that fetches points data,
satellite/radar images and model data, during Playlist playback, for a defined
number of data elements ready to be played.

Prepare Ahead will not fetch the current data element and the next data element,
but the first element that will be updated is the current plus the defined offset in
the Prepare Ahead Offset parameter.

Prepare ahead will fetch or update the data elements according to the user’s
selection of the check boxes. If fetch is selected the required data will be fetched
during execution of the playlist. If update is selected, the required data will be
sent to the following data elements.

• Enable Prepare Ahead for: When checked, the prepare Ahead feature will be
activated for the current Playlist and the numeric text box will be enabled. The
text box value defines the number of data elements that will be updated
during playlist playback.

Chapter 11: Working with Playlists 193


• Prepare Ahead Offset: Defines the offset, from the current playing data
element, of the first data element that will be prepared.

If a Playlist contains 7 data elements and Prepare Ahead is enabled with Prepare
Ahead Elements set to 3, and offset is 2, the following behavior is expected:

a. After initializing the Playlist elements 1-5 will be updated with the Prepare
Ahead mechanism at time intervals defined in the System Level Settings’s
Playlists Default tab. This action will loop until the playlist is played.
b. When the first data element is triggered, elements 3-5 will be updated, and
again at the defined time interval until the second element is triggered.
c. When the second element is triggered, elements 4-6 will be updated, and
again at the defined time interval until the third data element is triggered.
d. When the third data element is triggered, elements 5-7 will be fetched, and
again at the defined time interval until the fourth data element is triggered.
e. When the fourth data element is triggered, elements 6-7 will be fetched,
and again at the defined time interval until the fifth element is triggered.
f. When the fifth data element is triggered, element 7 will be fetched, and
again at the defined time interval until the sixth element is triggered.

DataPool Actions
When Show DataPool Action Column is checked, a DPAction column will be
displayed in the Playlist editing area. This column is intended for sending
commands to the DataPool plugin in the scene when the line is triggered.

Currently, only one use of DPAction is implemented: setting the REAL scene name
of the current data element to a DataPool variable.

Viz Weather makes a temporary copy of the graphic template, with the modified
values assigned by the Viz Weather UI, during initialization. The temporary name
of the saved copy is generated by Viz Weather and it might be required by
DataPool commands used in the scene.

To avoid the dependency of commands on a specific scene name – a DataPool


variable is used and the scene name is assigned to it. The same variable used in
the scene is then used in the DPAction column. When a variable name is found in
the DPAction column, when the line is triggered, Viz Weather will generate the
following command and send it to Viz:

RENDERER*FUNCTION*DataPool*Data SET
<variable_name>=SCENE*vizweather/temporary/<TempSceneName>

This functionality is currently used to initialize and operate interactive Playlist in


Viz Weather, using commands that include the scene name, but can be used for
other implementations.

Length
The Playlist Length parameter is used to set a global play time for an automatic
playlist. The parameter will be enabled only if all the data elements have a defined
time, using the “Automatic after X seconds” take out type (including transitions).
When setting a playlist length (in seconds) all data element’s play time will be
recalculated proportionally.

194 Chapter 11: Working with Playlists


Initialization
Initialization defines the mode that Viz Weather will initialize the playlist.

Playlist initialization can take a long time, depending on the number of items in
the playlist, and the Optimize parameter can be used, in some cases, to shorten
initialization time.

Data elements that can be optimized must meet the following conditions:

• Can only contain original weather points (weather points saved in the scene,
not added from Viz Weather points editor)
• Can only contain texts saved in the scene (not added texts from the text editor
in Viz Weather)
• Can only contain images controlled by Viz Weather (Images cannot be added
from the image editor in Viz Weather)

Any data element containing any combination of the above, and resaved in Viz
Weather version 1.9.5 or later, will be optimized during initialization. If any other
type of data from Viz Weather is saved with the data element it will not be
optimized.

Note: This feature is useful, mainly, when using the same graphic template in many
data elements within a playlist. A major improvement in initialization time is
obtained in this case.

Optimize defines if the playlist will use the optimization feature when initialized.

Auto Update Data Elements defines the update mode of optimized data elements
when the playlist is initialized. When working in a multiple client environment,
one client can modify a data element while it is being used in an initialized playlist
played by another client. When the data element is saved with changes, the icon
next to the modified data element in the initialized playlist will change. The user
may decide to reinitialize the changed data element or continue playing the
initialized version. When Auto update changed is selected the changed data
elements will be updated automatically by Viz Weather when changed by another
client.

Auto update limitations are:

• Only Viz Weather optimized data elements including weather points, texts and
image (excluding weather objects).
• Viz Content Pilot data elements (when working in DB configuration).

Iteration
Iterate defines if a Playlist will run once and end at the last data element or loop to
the beginning after the last data element is played.

Chapter 11: Working with Playlists 195


11.1.2 Layers

This section contains information on the following topics:

• Layers
• Channels

Layers
The Layers section enhances the capabilities of Viz Weather’s Playlist by enabling
control and usage of all Viz layers, including texture layers, and additional Viz
engines (Channels), providing richer graphics on screen and multiple Viz Engine
control.

Note: Texture layers refer to Viz dynamic images. For more information about
creating and using dynamic images in Viz scenes, see Viz Artist user manual.

196 Chapter 11: Working with Playlists


New: Add a controlled layer to the playlist. By default, a playlist has one layer
which is Viz Middle Layer. By adding layers to a playlist, additional graphic
elements can be displayed and controlled while playing the playlist. Every added
layer will add a column in the playlist content area, enabling the user to add data
elements or scenes to these layers.

Delete: Remove the selected layer from the playlist.

Main Layer sets the main layer to be used in the Playlist. The main layer is the
layer that the Playlist will be loaded to (i.e. when a data element is dragged to the
Playlist it will be loaded to the defined main layer during initialization).

Default main layer is Viz middle layer. Only one layer can act as the Main layer.
Select the main layer from the drop-down list.

Note: When a Playlist is run, all the elements in a line will be triggered when the line
is played.

Middle, Front and Back are all Viz layers.

A Host Scene is a scene, built with specific guidelines, used for virtual studio
shows of weather and other multiple scene applications. When a playlist is defined
as a host scene playlist, the scene will be added automatically to the playlist, as
the first line, and all other data elements and scenes will be loaded to a defined
layer within the scene during execution of the playlist. The resulting effect is of a
graphic scene running within another graphic scene.

Texture Layers consist of dynamic images added to the Playlist properties and
used by the data elements in the Playlist.

All data elements and scenes, in all the enabled layers, will be loaded to Viz
during Playlist initialization. When a line is triggered all the data elements in the
line will run. Main layer behavior is unchanged – when a line is triggered the data
element is loaded to Viz and the animation is started. Other enabled layers will be
affected only if the triggered line contains a data element or a scene in these
layers. This way the layers are separated during play out, enabling richer graphic
effects on screen.

Channels
The Channels property enhances the capabilities of Viz Weather’s Playlist by
enabling control of additional Viz Engines during playlist run. When a channel is
defined in the playlist properties, a column in the playlist area will be added.

When a data element is played (i.e. one line in the playlist), all data elements or
Viz scenes in that line will be triggered. The data element in the channel columns
will also be played on the specified machines. This feature enables running and
compositing of multiple graphics with one control UI.

Chapter 11: Working with Playlists 197


Note: Viz must be running in On-Air mode on the defined channels. If Viz is not On-
Air, an error message will appear indicating that the channel is not available.

11.1.3 Interactive

The Interactive tab is used to define a specially designed Viz scene, that uses
interactive elements to control the graphics.

198 Chapter 11: Working with Playlists


11.1.4 Additional Info

The Additional Info tab is used for comments and any other information related to
the playlist, like data path, shared folders, and so on.

Chapter 11: Working with Playlists 199


11.2 Playlist Content Area

This section contains information on the following topics:

• Context Menu
• To add data elements to the playlist
• To delete data elements in the playlist
• To arrange data elements in the playlist
• To add external Viz commands to a data element
• To add a Viz Content Pilot data element
• Columns

200 Chapter 11: Working with Playlists


11.2.1 Context Menu

Additional editing of the Playlist can be done using the context menu options:

• Copy: Copies the selected data-elements to the clipboard (CTRL+C).


• Paste: Inserts a data element from the clipboard to the Playlist before the
selected line (CTRL+V).
• Delete: Deletes the selected data-elements (DELETE).
• Disable/Enable: This menu item will toggle a data element mode between
Disabled/Enabled. The enabled mode is the normal mode, where a data
element is initialized, played, fetched, and so on with all other data elements
in the playlist. When a data element is disabled it will be skipped when
performing playlist operations, as if it was deleted from the playlist.

Note: During playlist initialization disabled data elements will not be initialized.
When disabling a data element after the playlist was initialized, the disabled data
elements will be skipped during playback and prepare ahead.

• Reinitialize (CTRL+I): Re-initializes the selected lines in the playlist. All data
elements in the selected lines (from all layers) will be loaded to Viz.
• Update: Sends all weather data in the selected lines to the playlist. All data
elements in these lines (from all layers) will be updated.
• Fetch: Fetches the data used in the selected lines.
• Fetch + Initialize: Fetches all the data used in the selected lines and initializes
the lines. All data elements in the selected lines (from all layers) will be
reloaded to Viz.

Chapter 11: Working with Playlists 201


• Insert Transition: Adds a transition between two data elements. The command
will open a list of transition effects. The transitions list is derived from the
transition scenes folder in VIz. The transitions folder is defined in the Viz
Weather INI file, inthetransitions_dir parameter (default is set to
SCENE*transitions folder).
• Insert Stop Next: Inserts a Stop Next command into the playlist, before the
selected line. The stop next command will load the following data element in
the playlist to the renderer and stop the animation on the first frame of the
scene. The next play or continue command will start the animation.

202 Chapter 11: Working with Playlists


• Insert Commands: Inserts Viz commands into the Playlist before the selected
data element. Any legal Viz command can be used - select a predefined
command from the drop-down list or type a command into the text field and
click the Add/Replace button. To delete a command, select the command from
the list and press the delete button. A single command or a sequence of
commands can be used in one playlist line.
• Insert Continue Command: Inserts a Viz continue command to the playlist,
before the selected line.

Chapter 11: Working with Playlists 203


• Insert VCP Element: This menu item is enabled when Working in Integrated
Environments using the Viz Content Pilot (VCP) database. When the Insert VCP
Element is selected a window with a list of all data elements in the VCP
database will open. Selecting a data element will insert it into the playlist
before the selected line. A special icon indicating that the inserted line is a
VCP element will appear in the playlist’s icon column.

204 Chapter 11: Working with Playlists


• Insert VME Clip: Inserts a clip from the configured Viz One into the playlist.
When selected, the Viz One clip browser will open. Select a clip and close the
window.

• Insert Playlist: A window with a list of the saved playlists in the system will
open. Select one of the playlists and click OK. The playlist content will be
added to the playlist before the currently selected item.
• DirectTake (CTRL+A): Loads and plays the selected data element in the
renderer. If the playlist is initialized, the data element will start playing
instantly. If the data element is not initialized, Viz Weather will initialize the
data element and play it in the renderer.
• Create Clip: Opens the post render window for rendering the last selected data
element. The render window will open if the data element is initialized. If the
selected data element is not initialized a warning message will appear asking
to initialize the data element.

Chapter 11: Working with Playlists 205


• Go To Scene: Select the graphic template, used in the data element, in the Viz
scene tree (Graphic Templates pane).
• Go To Data Element: Show the selected data element in the data elements list.

To add data elements to the playlist


1. Open a Playlist by selecting the required playlist folder and then the required
playlist.
The data elements will be displayed in the window below the playlist area.
2. Add one (or multiple) data element to the playlist by dragging it from the data
elements list into the Playlist content area (location in the playlist’s list of data
elements), or by copy and pasting it.
Data elements are added above the selected line.

To delete data elements in the playlist


• Select a data element from the playlist and press the Delete key or right-click
and from the appearing context menu select Delete.

To arrange data elements in the playlist


• Drag and drop the data elements in the playlist editing area to change the
order.

To add external Viz commands to a data element


• Add external Viz commands by right-clicking a data element in the playlist,
and from the appearing context menu select Insert commands or Insert
continue command.

To add a Viz Content Pilot data element


• Add Viz Content Pilot (VCP) data elements by right-clicking the playlist
content area and selecting Insert VCP element (see Working in Integrated
Environments).

206 Chapter 11: Working with Playlists


11.2.2 Columns

The playlist area displays information about the data elements and playlist
structure in columns. Right-click the column headers area to open a context
menu for customizing the columns display.

• Init: Displays an icon when the data element is initialized in Viz.


• Data Name: Displays the data element name.
• Icon: Displays an icon representing the data element that will be loaded to the
main layer defined in the playlist properties window, or a command icon or a
transition icon.
• Modified: Displays the date that the data element was saved.
• Scene Name: Displays the name of the graphic template (Viz scene) that the
data element uses.

• Take Out: Displays an icon describing the data element exit mode:
• Manual (radio button): Allows the operator to manually advance the data
element by pressing the ENTER key.
• Automatically at scene end (play button): Allows the playlist to automatically
advance to the next data element when the animation reaches its end. Note
that in scenes where looped animation is used the playlist will not advance
until all the loop cycles are finished.

Chapter 11: Working with Playlists 207


• Automatically after X seconds (play and clock button): Allows the playlist to
automatically advance to the next data element after the number of seconds
defined in the Time column have ended.
• Time: Displays the number of seconds that the data element will run when
Take Out column is set to “Automatically after X Seconds”. This field is
disabled when Take Out is set to any other option (manual or “Automatically at
the end of scene”).
• Post Time: Displays the duration of the clip that will be created when the
playlist is post rendered to disk.
• Remark: Displays specific data element remarks.
• Index: Displays the line indexes of the data elements, transitions and Viz
commands.
• Middle: Displays the data element icon of the data element that will be loaded
to the middle layer. This column will be visible only if the middle layer is
enabled and not set as the main layer in the playlist properties window.
• Back: Displays the data element icon of the data element that will be loaded to
the back layer. This column will be visible only if the back layer is enabled and
not set as the main layer in the playlist properties window.
• Front: Displays the data element icon of the data element that will be loaded
to the front layer. This column will be visible only if the front layer is enabled
and not set as the main layer in the playlist properties window.
• Dynamic layer columns: For each layer defined in the playlist properties
window an additional column will be added, with the header displaying the
logic name given to the layer (in the image above a layer column is referred to
as “Board”). The columns display the data element icon of the data element
that will be loaded to the specific layer. This column will be visible only if the
dynamic layer is enabled and not set as the main layer in the playlist
properties window.
• Channel columns: For each channel defined in the playlist properties window
an additional column will be added, with the header displaying the logic name
given to the channel (in the image above a channel column is referred to as
“Channel”). The columns display the data element icon of the data element
that will be loaded to the specific channel. This column will be visible only if a
channel is defined in the playlist properties window.

11.3 Playlist Control

Before a playlist can be played out it has to be initialized by loading all graphic
templates to the Viz Engine and settings all meteorological data. The playlist tool
bar is used to perform the required actions.

This section contains information on the following topics:

• Using Concepts
• Initialization
• Running a Playlist

208 Chapter 11: Working with Playlists


11.3.1 Using Concepts
A concept is a set of graphic templates in Viz, grouped under one folder. When
using the same scene attributes (scene name, tab fields) in another concept, the
same data elements can be used to play any of the graphic templates in different
concepts.

The concepts enable you to use the same playlist while playing different graphic
designs.

1. Define the concepts in the Settings > System window (see Concepts and
Folders).
2. Select the required concept from the drop-down list in the playlist tool bar.
3. Initialize the playlist. The data elements will use the matching graphic
templates from the selected concept.

11.3.2 Initialization
The initialization stage is necessary to run the Playlist with minimal response time
when switching between data elements while running the Playlist.

Initialization takes a few seconds (up to a couple of minutes) to complete,


depending on the number and type of elements in a playlist. During the
initialization process, all the information stored in the Playlist is loaded to Viz: All
data elements in all layers, clips and scenes.

Initialization Settings
The initialization button will perform the operation defined in the Settings >
System > Playlist tab.

Additional initialization options are available in the drop-down menu next to the
button:

• Initialize: Initializes the selected lines. If the selected lines are intialized, no
action will be performed. All data elements (from all layers) will be loaded to
Viz.
• Clear and Initialize: All the loaded graphics from all Viz program/channels and
preview machines, and initializes the the playlist. and initializes the the
playlist. All data elements (from all layers) will be reloaded to Viz.
• Fetch + Initialize: Fetches all the weather points used in the selected lines and
initializes the lines. If the selected lines are intialized, only fetch will be
performed.

Chapter 11: Working with Playlists 209


• Fetch + Clear + Initialize: Fetch all weather points in the playlist, clear all the
loaded graphics from all Viz program/channels and preview machine, and
initializes the the playlist. All data elements in the selected lines (from all
layers) will be reloaded to Viz.
• Initialize Changed: Initializes data elements changed by a remote Viz Weather
client or by the current user. This menu item will only be enabled if the playlist
is initialized and one or more of the data elements included in the playlist
were modified by a running Viz Weather client.
• Fetch + Initialize changed: Fetches all the weather points used in the changed
lines and initializes the lines changed by a Viz Weather client after the playlist
was initialized. All data elements in the selected lines (from all layers) will be
reloaded to Viz.
• Clear Viz Memory: All the loaded graphics from all Viz program/channels and
preview machines, and initializes the the playlist.

When initializing a playlist, no warning messages will be displayed during the


initialization process. However, if a problem occurred during the initialization, the
error messages will be written to the initialization log.

The information button will become red if any of the data elements did not
initialize successfully. Clicking the i (information) button will open the Playlist
InitializationLog window, displaying a log of the initialization process. Another
option is from the View > Initialization Log menu item.

If an Viz Engine machine is defined, and is in On-air mode, the data elements can
be loaded to it for playout.

Note: In a Program-Preview configuration, a playlist will be loaded to the Preview


and to the Program machines according to the configuration set in the
viz_weather.ini file, or according to the preview option, set in the Viz menu.

This section contains information on the following topics:

• To initialize data elements


• To initialize un-initialized data elements

To initialize data elements


1. Click the Init All button located on the left side of the playlist control area, or
2. Click the Fetch Playlist Point Data and init Playlist button to fetch all the
weather points used in the Playlist and then initialize the elements, or
3. Right-click the playlist entry in the list and from the appearing context menu
select Init All Data Elements.

210 Chapter 11: Working with Playlists


To initialize un-initialized data elements
1. Open the drop-down menu of the initialization button and select the initialize
option, or
2. Select the lines to initialize and press CTRL+I.

Note: When using the Init All option, Viz Weather will clear Viz Engine’s memory
before loading the scenes. When using other init options (init selected, init
uninitialized, and so on) Viz Engine’s memory is not cleared. If using a large playlist
use the Init All option to avoid memory issues.

11.3.3 Running a Playlist


A playlist can be played out in several ways. You can control the playout using the
user interface with mouse and keyboard, GPI or TCP commands.

• ENTER (keyboard): By pressing ENTER the selected data element from the
playlist will show in the render window and start running the scene animation.
Normally, a playlist will play sequentially from the first data element on. If the
animation includes stop-points, adding continue commands or using the
Expose Stop Points property, in the animation editor, will enable playing the
entire animation by pressing ENTER every time the animation stops at a stop
point.
• Play (buttons): By clicking the Play button next to the Playlist status display
you can play the current data element and advance the selection to the next
data element in the playlist.

• Playlist Control Panel (buttons): By using the Playlist Control Panel, you can
play the Playlist and to move the selection in the Playlist. Click the + button to
expand the Playlist Control Panel.
• GPI: Using GPI can be used to trigger Viz Weather events using an external
device connected to a GPI box that is connected to the Viz Weather machine
(see System Level Settings).
• TCP: Sending external TCP commands can also be used to control the playlist.

Note: When a line is activated, the current line is played and the next line is selected,
ready to be played out.

In a Program-Preview configuration, the current data element loads to the On-air


machine (program), and the next element(s) loads to the preview machine
(localhost).

Chapter 11: Working with Playlists 211


See Also
• Application Level Settings for the on_air_machine and
on_air_preview_disable settings

11.4 Exporting A Playlist


In a multi-system environment or a geographically spread system, exporting and
importing a playlist is required. Viz Weather enables you to export a playlist and
import it back to another system.

To export a playlist
There are two ways to export a playlist:

1. From the context menu of the playlist area, select the Export To File menu
item, or alternatively
2. Click the Export Playlist button in the Playlist panel, next to the playlist folders
drop-down list.
The Export Playlist window will open.

3. Select the required information that will be included in the exported playlist.
4. Click the Export button.
5. Set the archive name and save the file.

11.5 Importing a Playlist


In a multi-system environment or a geographically spread system, exporting and
importing a playlist is required. Viz Weather enables you to export a playlist and
import it back to another system.

212 Chapter 11: Working with Playlists


To import a playlist
There are two ways to import a playlist:

1. Select the File > Import Playlist menu item, or alternatively


2. Click the Import Playlist button in the Playlist panel, next to the playlist folders
drop-down list.
A file browser will open.
3. Select the playlist archive to import and click Open.
The Import Playlist window will then open.

4. Select the required playlist content, and click Import.

Chapter 11: Working with Playlists 213


12 Playout Mode

Viz Weather can be run as a playout application. The playout mode is a limited
mode of running Viz Weather, intended for control rooms where editing of data
elements are not required. It enables the user to control, modify playlists and
playout playlist data elements during production.

214 Chapter 12: Playout Mode


Playlist editing is possible by the following:

• Using the Playlist menu items or playlist buttons


• Context menu on a selected playlist
• Context menu on a selected data element in a playlist.
• Using the Saved data elements window to select a data element and drag it to
the playlist.

Note: For additional information about Playlist editing and management, see the
Working with Playlists chapter.

The playout application will open when running Viz Weather with the –playout
flag.

Note: The flag is used when running viz_weather.exe from a command shell, a batch
script file or by configuring a windows shortcut.

To run Viz Weather in playout mode


1. Create a program shortcut for Viz Weather.
2. Right-click the shortcut, and from the appearing context menu select
Properties.
3. Click the Shortcut tab.
4. In The target path add -playout.
• The target paths should look something like this: "C:\Program
Files\Vizrt\vizWeather2\viz_weather.exe" -playout
5. Click Apply and close the Properties window.
6. Double-click the shortcut to run Viz Weather in playout mode.

Note: The flag is used when running viz_weather.exe from a command shell, a batch
script file or by configuring a windows shortcut.

Editing a playlist in playout mode


1. To delete a data element from a playlist, use the context menu->delete or
press DELETE on the keyboard.
2. To add a data element to the playlist, open the Saved Data Elements window,
by selecting the Saved Data Elements menu item from the View menu.

Chapter 12: Playout Mode 215


3. Select the required data elements and drag them to the playlist.
4. Click Close to exit.

See Also
• Playlist Control

216 Chapter 12: Playout Mode


13 Fetch Application

The Fetch Application is a standalone application installed with the Viz Weather
package, and is used to fetch data manually or automatically. The application is
used for downloading data from the data supplier as configured in the Providers
Info tab, in the WD_Admin application, and according to the defined fetch profile.

A common use of the Fetch Application is to define an automatic fetch at fixed


intervals or at a specific time of day, making sure all data is updated periodically.
Loading fetch profiles using TCP commands enables the system to perform
different fetch type or different fetch operations while the application is running,
without the need to manually configure the application.

The Fetch Application can fetch all types of meteorological data including weather
points data.

Chapter 13: Fetch Application 217


The TCP fetch mode is used for fetching prepare ahead items when playing a
playlist. When running in TCP fetch mode, Viz Weather will not stall while
performing the fetch.

When TCP fetch mode is defined in the Viz Weather initialization file, the fetch
application will be launched and minimized to tray. When opening the application,
only the TCP command window will open. Fetch settings are derived from Viz
Weather’s UI, and used according to the Prepare Ahead configuration of the
playlist in use.

To run the Fetch application, create a shortcut on your desktop with the same
Media Sequencer machine used as a DataHub in the environment.

This section contains information on the following topics:

• Main Menu
• Points Data (Live), Fetch and Points

13.1 Main Menu


This section contains information on the following topics:

• File
• View
• Settings
• Tools

13.1.1 File
• Exit: Close the fetch application.

218 Chapter 13: Fetch Application


13.1.2 View

• FetchLog: Opens the fetch log window, displaying the fetch log, data log and
data on disk tabs.

Note: For additional information about the fetch log, refer to Using Viz Weather
chapter, View > Show Log menu item description.

• TCP Commands: Opens the TCP command window, displaying all incoming
TCP commands.

Note: For additional information about the TCP commands, refer to Using Viz
Weather chapter, View > Show TCP Commands menu item description.

13.1.3 Settings
• Data: Run WD_Admin application.

Note: For additional information about the Data Settings, see the Viz Weather Data
Configuration section.

• Refresh Data Settings: reload data settings from the Data Hub.

13.1.4 Tools
• Send All Values: When selected all point values will be sent to the defined Viz
Engine machines. The Viz Engine machines are pre-configured in Viz
Weather’s initialization file, under the fetch_application section, as a list of
machines:

Machine1=
Machine2=

13.2 Points Data (Live), Fetch and Points


This section contains information on the following topics:

• Points Data
• Fetch
• Profile columns
• Adding a new Fetch Profile
• Editing a Fetch Profile
• Deleting a Fetch Profile
• Setting a Fetch Profile
• Satellite Images
• Model Data Forecast

Chapter 13: Fetch Application 219


• Radar
• Points
• Misc Information
• Clouds Forecast
• Storm Path
• Points List

13.2.1 Points Data

The Points Data tab displays a table of the defined points and the defined
columns (Points data fields) in the system. The data table is displayed per point
type, selected in the drop-down list, at the upper part of the tab. Other drop-
down lists filter the data according to the define values.

The Points Data tab is also used for manually modifying data values and for
locking values and records in the table. This lock means that when new data is
fetched and populate the table, it will not overwrite the locked fields or records.
The locked cells are marked with pink color as the cell background.

A right-click over a cell in the table will open a context menu, enabling the user to
lock/unlock the specific field or record.

220 Chapter 13: Fetch Application


• Lock Selected Field: Locks only one field in the table (one cell).
• Lock whole record: Locks an entire point in the table (one row).
• Empty all points data: Resets and delete all the data from all the points.

13.2.2 Fetch

The Fetch tab is used for configuring what data type (including weather points)
will be fetched. The data types are defined in Fetch Profiles. A fetch profile can be
triggered automatically or manually. When a fetch profile is triggered, all the data
types defined in the profile will be downloaded from the meteorological data
supplier to the system.

13.2.3 Profile columns

• Profile Name: Name of the fetch profile.


• Last Fetch: Displays when the last fetch occurred (date and time).

Chapter 13: Fetch Application 221


• Active: When selected, the fetch profile will be triggered according to the
defined time pattern. If unchecked, the fetch profile will not be triggered
automatically.
• Additional XML: Sets an additional action that will be sent to VIz Weather after
the fetch operation has been triggered. The delay of the additional XML
command is set in the timecode attribute of the node.

<timematch name="CurrentAndForecast">
<interval begin="0 0,5,10,15,20,25,30,35,40,45,50,55 * * * *">
<weather action="fetch_profile">
<profile_name>CurrentAndForecast</profile_name>
</weather>

<weather name="weather#2" action="export_points_dictionary"


PointTypeDPName="CurrentAndForecast" ExportFileName="C&#58;\Program
Files\vizrt\Viz Ticker Client\present

<weather name="weather#2"action="export_points_dictionary"
PointTypeDPName="CurrentAndForecast" ExportFileName="C&#58;\Program
Files\vizrt\Viz Ticker Client\presentations\Dictionary_Forecast.xml"
timecode="00&#58;01&#58;00&#58;00" status="Export Finished.">

</weather>
</interval>
</timematch>

Note: The string &#58; represents the character “:” (colon) in the time code value.

13.2.4 Adding a new Fetch Profile


To add a new fetch profile, click the add button. The Profile Editor will open, with
all options disabled.

Set the profile name, and enable the check boxes next to the data types to be
used in this profile. Configure the data types and data time range according to the
guidelines in the Setting a Fetch Profile section.

13.2.5 Editing a Fetch Profile


To edit an existing fetch profile, click the edit button. The Profile Editor will open,
with the selected profile’s settings. Configure the data types, data time range,
Time Pattern or profile name, according to the guidelines in the Setting a Fetch
Profile section.

13.2.6 Deleting a Fetch Profile


To delete a fetch profile, click the delete button. The selected profile will be
removed from the list.

CAUTION! When deleting a fetch profile, no confirmation message will appear.

222 Chapter 13: Fetch Application


13.2.7 Setting a Fetch Profile
Figure 13: Profile Editor window

The Profile Editor is used to set the fetch properties and the meteorological data
types:

Fetch Settings
• Profile Name: Name of the fetch profile. This name is displayed in the Fetch
tab under the Profile Name column.
• Time Pattern: The time pattern defines the time in which the fetch action will
be executed. The time pattern can be a fixed hour during the day, or an
interval between fetch operations. The time pattern will be used only if the
Fetch Profile is defined as Active in the Fetch tab. When a Fetch profile is
active, an automatic fetch will be triggered whenever the time pattern occurs.
Click the button next to the time pattern field. The Time Match window will
open. Select the Standard tab to set the time/interval and the days in which
the fetch will occur. Select the Advanced tab to set the time interval and the
days in a detailed representation.

Chapter 13: Fetch Application 223


• Fetch Now: When this button is pressed, the fetch operation will be executed
instantly, on the current machine, using the current machines settings.

Data settings

To set the time range

1. Click the Calendar button to change the Date Time Range:

2. Set the From and To date and time for the required data.
• Absolute Date: Sets a fixed date and time. Click the Calendar icon to select a
date for the From and To fields. Set the time for the From and To fields.
• Relative Date: Sets a relative date and time (relates to today). Select a
relative day from the drop-down list in the From and To fields. Set the time
for the From and To fields.

Note: Any combination of relative and absolute date/time can be used in the time
range.

224 Chapter 13: Fetch Application


13.2.8 Satellite Images

In the Area drop-down list, a list of configured satellites can be selected. To select
a satellite area, check the check box next to the required satellites.

For each satellite, images can be fetched with land (no alpha) or with alpha
displaying only the clouds in the image (clouds with alpha). The Satellites list is
defined in the WD_Admin application. See the Viz Weather Data Configuration
section.

Note: Time setting for satellite images should be in the past (since it is not a forecast
but a set of images taken by satellite).

Chapter 13: Fetch Application 225


Figure 14: Satellites - D1 to D9

Figure 15: Satellites - GEOS and MeteoSat

226 Chapter 13: Fetch Application


Table 3: Available satellites

Satellite Description

D1

D2 Europe

D3 East Europe and west Asia.

D4 North of south America.

D5 West Africa.

D6 East Africa.

D7 () South-east of south America.

D8

D9

GOES-W West USA, west Canada and the Pacific Ocean.

GOES-E North and south Americas.

GMS East Asia, Oceania.

IODC West and central Asia, and east Africa.

D2D3 Europe and west Asia.

US_ALL

US_WEST

US_EAST

SOUTH_AMERICA

EUROPE

AUSTRALIA

WORLD

Chapter 13: Fetch Application 227


13.2.9 Model Data Forecast

The Model data selection area supports Iso parameters selection, time range and
model type for fetch.

From the drop-down list, select the required data type. Type name is defined in
the WD_Admin application. See the Viz Weather Data Configuration section.

228 Chapter 13: Fetch Application


To set the model parameters

1. Click the ellipsis (...) button to open the Fetch Profile window.
The Fetch Profile window displays the configured model types and the
available data for each type.
2. Select the data to be fetched: Lines (pressure), Bands (temperature), Filled
precipitation), Zones or Winds, and click OK to confirm the selection.
3. Set the time range for the fetched data.
Time setting for Model Data can use future time since model data is based on
forecast model, predicting weather behavior.
Zones are weather conditions forecasts, supplied in a form of a geographical
grid. Every point in the grid has a value and the grid is converted into shapes
derived from areas with the same value. Zones are displayed with the WGrid
plug-in, extending Viz Weather’s ability to display additional meteorological
data formats.

Chapter 13: Fetch Application 229


13.2.10 Radar

In the Area drop-down list a list of radars can be selected. Radar options are
configured in the WD_Admin application. See the Viz Weather Data Configuration
section.

Note: Time setting for radar images should be in the past (since it is not a forecast
but a set of images taken by radar).

13.2.11 Points

Check the Points check box to fetch Weather points data when the Fetch Profile is
triggered. Select the points type to fetch from the drop-down list.

230 Chapter 13: Fetch Application


13.2.12 Misc Information
Miscellaneous information is used to fetch any additional data configured in the
Misc Information tab in the WD_Admin application (see the Viz Weather Data
Configuration section). When defined in the system a drop-down list will be
enabled with the defined options and the user will be able to fetch data into the
system.

13.2.13 Clouds Forecast


Cloud forecast data is a set of black and white images representing clouded areas
(like satellite images). When the cloud forecast images available from the data
suppliers are defined in the system, the images can be fetched and used to
display 3D clouds forecast. Cloud forecast is defined in the WD_Admin
application. See the Viz Weather Data Configuration section.

13.2.14 Storm Path


Storm path data is an XML file describing all the storms (hurricanes, typhoons and
so on), within the defined time range (for the defined area), observed path and
expected path.

Select one of the defined areas to fetch the storms information. Storm path is
defined in the WD_Admin application. See the Viz Weather Data Configuration
section.

Chapter 13: Fetch Application 231


13.2.15 Points List

The Points tab displays a table of the defined points in the selected Point Type.
Other dropdown list options filter the displayed points table.

• New Point From Database: Adds a new point from the web.
• New Point (Blank): Manually add a point to the list. An empty line will be
opened above the selected line.
• Delete Points: Deletes the selected points from the system.
• Refresh Points: Reloads the table values from the database.
• Change Category: Sets a category for the selected lines (cities).

232 Chapter 13: Fetch Application


• Export Points: Select the type of points to export. The points will be exported
to a CSV file format.
• Select All Points: Selects all lines in the table.

Chapter 13: Fetch Application 233


14 External Commands
This guide a list of external commands used to trigger Viz Weather actions via
TCP. The external commands enhance the flexibility of using Viz Weather, when
running with the GUI or in No_GUI mode.

• The TCP/IP port number to connect to Viz Weather is 6112.


• The TCP/IP port number to connect to Fetch Viz Weather is 6113.

This chapter contains information on the following topics:

• Running Viz Weather Application Without the UI


• Commands List
• Example XML
• Handler Parameters

14.1 Running Viz Weather Application Without the UI


When using the external commands to control Viz Weather, Viz Weather can be
used without the UI (in most cases).

To run Viz Weather application without the UI, use the following command line
parameters:

localhost -control -NoGUI -ShowLog -weather_machine <the viz machine


name>

Example: <Viz Weather Folder>\viz_weather.exe -NoGUI -ShowLog -


weather_machine <engine_name>

• NoGUI: Will cause Viz Weather to run without a user interface and without a viz
preview window.
• ShowLog: This flag will launch Viz Weather with the TCP log window opened.
• weather_machine <viz machine name>: This flag will set the connection to a
Viz Engine machine.

License Checking
There is no license check if Viz Weather is running with the NoGUI flag, since no
Viz preview is launched.

Note: When running Viz Weather with the -NoGUI flag, the commands are sent only
to the defined Viz Engine machines (there is no preview).

234 Chapter 14: External Commands


14.2 Commands List
Table 4: External Commands

Operation Description Command Format

Activate Viz Weather using run process with this <weather


application command line parameters, action="launch_weather"
this will cause: >
1. Viz Weather application /weather>
to run with loading only the
necessary weather XML to
the already loaded XML
2. Run in NoGUI mode
(meaning the application will
be minimized)
start viz_weather.exe
localhost -control -NoGUI

Start a show Start a new show <weather


1. Add a new rundown action="start_show">
named: </weather>
'temporary remote playlist'
2. Clears the viz memory
(scene, fonts, images, and
so on)

Kill Viz Weather Kill Viz Weather application. <weather


If the application is busy action="kill_weather">
(initializing or executing a </weather>
command), the command
will be executed after the
application is done.

kill_weather_now Kill Viz Weather application <weather


immediately action="
kill_weather_now">
</weather>

Restart Viz Weather The command will restart <weather


the running Viz Weather action="restart_weather"
application >
</weather>

Chapter 14: External Commands 235


Table 4: External Commands

Operation Description Command Format

Set a VIz Engine as Change (set) the On Air viz <weather


an On air machine machine in the weather action="set_onair_machi
application ne">
<machine_name>Machin
eName</
machine_name>
</weather>

Init Data This action will do the <weather


following: action="init_data">
1. Add data element to the <data_name>DataName
current playlist </data_name>
2. Initialize the data element <concept_id>1</
to viz concept_id>
</weather>

Play a data element Play a named data element <weather


from the current initialized action="play_data">
playlist.
<data_name>DataName
</data_name>
<concept_id>1</
concept_id>
</weather>

Initialize a playlist Initialize playlist by name <weather


action="init_playlist">
<playlist_name>MyPlayli
st/playlist_name>
</weather>

Play playlist Play playlist by name <weather


action="play_playlist">
<playlist_name>MyPlayli
st</playlist_name>
</weather>

Play playlist and Play playlist by name and <weather


release release it after the last data action="play_playlist_and
element was played. This _release">
option works if the playlist is <playlist_name>MyPlayli
automatic - when the last st</playlist_name>
element ends, Viz Weather </weather>
releases the playlist.

236 Chapter 14: External Commands


Table 4: External Commands

Operation Description Command Format

set_current_playlist Set a named playlist as the <weather


current playlist action="set_current_playl
ist">
<playlist_name>MyPlayli
st</playlist_name>
</weather>

Stop playlist Stop the current playlist <weather


from running. action="stop_current_pla
ylist">
</weather>

Fetch the current Fetch the weather points of <weather


playlist weather the current playlist and send action="fetch_current_pl
points DataPool values to viz aylist">
machines
</weather>

Update current Send the DataPool values of <weather


playlist the current playlist to viz action="update_current_
machines playlist">
</weather>

Initialize playlist Initialize a named data <weather


data element in the current action="init_playlist_data
playlist. ">
The data element is not <data_name>DataName
added to the playlist and it </data_name>
should be a part of the
playlist when the commad is <concept_id>1</
sent. concept_id>
</weather>

Init uninitialized Select the specified playlist <weather


and init the uninitialized action="init_uninitialized
data elements in the playlist _playlist">
<playlist_name>PlaylistN
ame</playlist_name>
</weather>

Fetch playlist data Select the specified playlist <weather


and fetch the weather points action="fetch_playlist">
data and image data used in
the playlist. <playlist_name>PlaylistN
ame</playlist_name>
</weather>

Chapter 14: External Commands 237


Table 4: External Commands

Operation Description Command Format

Fetch profile Fetch a weather fetch profile <weather


by name action="fetch_profile">
<profile_name>ProfileN
mae</profile_name>
</weather>

Control playlist Available command id's: <weather


GOTO_FIRST = 0; action="control_playlist"
>
GOTO_PREV = 1;
<command_id>Comman
GOTO_NEXT = 2; d_Index</command_id>
PLAY_AND_NEXT = 3; </weather>
PLAY = 4;
STOP_TIMELINE = 5;
CONTINUE_TIMELINE = 6;
GOTO_START_TIMELINE = 7;

Post render playlist This TCP command works <weather


(with GUI running) ONLY when Viz Weather is action="post_playlist_gui
running in GUI mode (noGui ">
is not supported) and ONLY <playlist_name>PlaylistN
for Viz 3. ame</playlist_name>
The post_profile value <post_profile>QT_Small_
should be one of the profiles Cinepak</post_profile>
defined in the <out_dir>FolderPath</
Viz3PostDeviced.xml file. out_dir>
</weather>

Snap gateway gui This TCP command works <weather


only when Viz Weather is action="snap_playlist_gu
running in GUI mode (NoGUI i" name="weather">
is not supported). The <playlist_name>PlaylistN
command will generate ame</playlist_name>
snapshots of all the data
elements in the playlist <height>557</height>
<width>577</width>
<type>RGB</type>
<format>tif</format>
<do_after_cmd>true</
do_after_cmd>
<out_dir>FolderPath</
out_dir>
</weather>

Play the next <weather


element in the action="play_next">
playlist </weather>

238 Chapter 14: External Commands


Table 4: External Commands

Operation Description Command Format

Play the current <weather


loaded playlist action="play_current_pla
ylist">
</weather>

Clean the gateway <weather


queue action="clear_gateway_q
ueue">
</weather>

Clean the pending <weather


TCP commands of action="clear_pending_jo
the weather queue bs"></weather>

Fetch data element <weather


weather points action="fetch_data_wp">
<data_name>DataEleme
ntName</data_name>
<concept_id>1</
concept_id></weather>

Fetch data element <weather


images (sat, radar, action="fetch_data_imag
storms) es"><data_name>DataEl
ementName</
data_name><concept_id
>1</concept_id></
weather>

Fetch data element <weather


weather points and action="fetch_data_wp_i
images (sat, radar, mages"><data_name>D
storms) ataElementName</
data_name><concept_id
>1</concept_id></
weather>

Fetch data element <weather


data where you can action="fetch_data_elem
specify which data ent_data" images="true"
you want; weather wp="true"
points, images (sat, storms="true"><data_na
radar, storms) me>DataElementName<
/
data_name><concept_id
>1</concept_id></
weather>

Chapter 14: External Commands 239


Table 4: External Commands

Operation Description Command Format

Export weather <weather


points to CSV file action="export_points_to
_csv" file="MyPoints"
point_type_dp_name="W
eatherPoint"></
weather>

Snap Playlist (does <weather


not work in NoGUI action="snap_playlist_gu
mode) i"
><playlist_name>Red</
playlist_name><viz_conc
ept>green</
viz_concept><height>5
76</
height><width>576</
width><type>RGB</
type><format>RGB</
format>
<out_dir>C:\Temp\snap
s</out_dir></weather>

Clear viz memory <weather


action="clean_viz_memo
ry"></weather>

240 Chapter 14: External Commands


Table 4: External Commands

Operation Description Command Format

Export Points <weather


Dictionary : action="export_points_di
EmptyDataFields; if ctionary"
not specified, the PointTypeDPName="Weat
dictionary will herPoint"
include also empty ExportFileName="c:\tem
fields. If specified p\WeatherDictionary.xml
(with values like ALL "ForecastName="Tomorr
or a specific field ow"
like Temp), then if EmptyDataFields="ALL"
this field is empty ExportDataFields="Temp
the point will not be ;Min"></weather>
exported to the
dictionary.
ExportDataFields; if
specified, weather
data fields will be
included in the
export (for example
ExportDataFields="
Temp;Min")
ForecastName; if
exporting data
fields, this identifier
will define which
forecast to export
(for example
ForecastName="To
morrow")

Command to check <weather


connection to the action="check_connectio
vizWeather (sent n"></weather>
'OK' in the socket
back )

Note: When working in an integrated environment with a VCP database, you can add
a DNR (Data Number) tag, specifying the DNR of the data element to all the
commands that are data element related. The DNR tag is optional.

Name Tokens
Name Tokens can be used when creating snapshots or clips. The tokens are
replaced with their value:

• <concept_name>: Name of the playlist folder


• <name>: Name of the data element

Chapter 14: External Commands 241


• <tag_name>: Tag names in the animation of the data element (pilot1, pilot2,
and so on). The tags must follow the standard of the pilotX format.

14.3 Example XML


<entry name="test weather TCP commands">

<weather action="start_show">
</weather>

<weather action="set_onair_machine">
<machine_name>Machine1</machine_name>
</weather>

<weather action="play_data">
<data_name>DataName1</data_name>
<concept_id>1</concept_id>
</weather>

<weather action="init_playlist">
<playlist_name>MyPlaylist</playlist_name>
</weather>

<weather action="play_playlist">
<playlist_name>MyPlaylist</playlist_name>
</weather>

<weather action="play_playlist_and_release">
<playlist_name>MyPlaylist</playlist_name>
</weather>

<weather action="set_current_playlist">
<playlist_name>MyPlaylist</playlist_name>
</weather>

<weather action="stop_current_playlist">
</weather>

<weather action="fetch_current_playlist">
</weather>

<weather action="update_current_playlist">
</weather>

<weather action="init_playlist_data">
<data_name>fronts test 1</data_name>
<concept_id>1</concept_id>
</weather>
</entry>

14.4 Handler Parameters


A handler is a Media Sequencer plug-in that encapsulates certain logical and
operational capabilities. The Weather handler encapsulates partial Viz Weather
logics and operations. The Weather handler is the link between the Media
Sequencer and Viz Weather.

The handler is defined in the Media Sequencer tree in the following way:

<handler name="weather" type="weather">


<entry name="viz_machine"></entry>
<entry name="encoding">UTF-8</entry>
<entry name="host">localhost</entry>

242 Chapter 14: External Commands


<entry name="port">6112</entry>
</handler>

• Name: Handler name; multiple handlers are supported by using a different


name for each handler. Send the TCP command to the specific Viz Weather
handler name.
• Host: Viz Weather machine name (the name of the machine running the Viz
Weather application)
• Port: The TCP/IP port number used by Viz Weather (set to 6112)
• Viz_machine: The name of the On Air Viz machine
• Encoding: Not used

Note: To connect to the Fetch Viz Weather application, use port number 6113.

Chapter 14: External Commands 243


15 Appendix
This section contains information on the following topics:

• Initialization File
• Weather Data Suppliers
• Using XML Formatted Data in Viz Weather
• Working in Integrated Environments
• Using Multiple Viz Weather Clients
• Additional Columns
• Using VDCP to Control Weather
• MOS Configuration with Avid iNEWS
• Viz One Configuration

15.1 Initialization File


The initialization file is described in the Application Level Settings section. The file
defines parameters that are application specific. When used with the -inifile flag,
any Viz Weather application can run with the defined parameters.

Note: Default configuration file name is viz_weather.ini. If the -inifile flag is not
used, the application will run using the viz_weather.ini file.

15.2 Weather Data Suppliers


This section contains information on parameters used for connection to weather
data suppliers:

• Storm
• XML

Storm
The file dataFetchStorm.dll is the application that connects to the data supplier
Storm, and fetches the data.

DLL parameters:

• newWod: Defines if the file read is in the old format or the new format. Use
always 1 (new format).
• URlUser: User name for connecting to the server using HTTP
• URlPasswd: Password for the user above
• FtpUser: User name for connecting to the server using FTP
• FtpPasswd: Password for the user above
• timeout: Timeout value (in seconds) during download
• connectionTimeOut: Timeout value (in seconds) when trying to establish a
connection to the server.

244 Chapter 15: Appendix


• httpProxy: Optional. Use proxy for accessing HTTP. Format is host:port
• ftpProxy: Optional. Use proxy for accessing FTP. Format is host:port
• proxyType: Proxy type. Default is 0. Options are 0,4(socks4) or 5 (socks 5)

XML
The file dataFetchXML.dll is an application that downloads an XML file, from a
defined data supplier server, to a given location on the disk and reads the data
from the file. The dataFetchXML.dll can be used to process XML files from the
local disk, without connecting to a data supplier, and retrieve data from that file.

DLL parameters:

• xmlDateUrl: The path to a file containing the time and date of the last update
to the XML weather files on the server.
• Example: ftp://user:pass@ftp.storm.no/tmp/xmlDate.txt

• xmlDatePath: The path to a file containing the time and date of the last
downloaded weather data files on the local machine.
• Example: . \XMLFile\xmlDate.txt

• xmlUrl: Location of the data files on the server.


• Example: ftp://user:pass@ftp.storm.no/tmp/point_data.xml

• xmlPath:Full or relative path to the downloaded XML file containing the


weather points data.
• Example: E:\Projects\weather\XMLFile\File.xml

Note: For using a local forecast file, place the local file under xmlPath and leave the
xmlUrl parameter empty.

• FtpUser : User name


• FtpPasswd:: User password

In the dataFetchXML.dll, tags for basic data types may be defined to override the
default tag name. Us the following parameters to affect the tags to be used:

XML xmlDateTag=fecha
XML xmlKeyTag=nombre_ciudad
XML xmlTemperatureTag=temperatura_media
XML xmlTemperatureMinTag=temperatura_minima
XML xmlTemperatureMaxTag=temperatura_maxima
XML xmlPrecipitationTag=precipitacion
XML xmlWindDirTag=vientodirecion
XML xmlWindSpeedTag=vientovelocidad
XML xmlSymbolTag=simbolo

If no tags are defined, the values are:

xmlDateTimeTag = "datetime";
xmlKeyTag = "name";
xmlTemperatureTag = "temperature";
xmlTemperatureMinTag = "temperaturemin";
xmlTemperatureMaxTag = "temperaturemax";
xmlPrecipitationTag = "precipitationmm";
xmlWindDirTag = "winddirection";

Chapter 15: Appendix 245


xmlWindSpeedTag = "windspeedms";
xmlSymbolTag = "symbol";

15.3 Using XML Formatted Data in Viz Weather


Viz Weather point data is retrieved from the data supplier’s server or from local
files. The files storing the point information are XML files, read by Viz Weather
and inserted into the Points database. The process of retrieving data and storing
it in the database is called “fetch”.

When the data for one (or more) of the weather points defined in the system is
required, the following process occurs:

a. Check when the last update of the requested point’s data took place.
b. If the data expiration time was exceeded, download the XML file from the
server.
c. Parse the file and get the data for the requested point.
d. If the data for the point was found, update the database with the new
values.

This section contains information on the following topics:

• Required Files
• XML File Format
• XML File Tokens
• Symbols

Required Files
The date file is a file with the date of the XML file. The reason for this file is that
the date on the FTP might sometime be wrong, or there might be many files on
the FTP, which will make it slow to check the date.

The XML file is the file with the weather information.

XML File Format


The format in the XML is as follows:

<?xml version="1.0" encoding="iso-8859-1" ?>


<countries>
<country name=”spain”>
<location_id name=”1001”>
<lon>10</lon>
<lat>20</lat>
<forecasts>
<forecast>
<datetime>20031129120000</datetime>
<temperature>-2</temperature>
<winddirection>223</winddirection>
<windspeedms>9</windspeedms>
<precipitationmm>1.2</precipitationmm>
<symbol>17</symbol>
</forecast>
</forecasts>
</location_id>

246 Chapter 15: Appendix


</country>
</countries>

XML File Tokens


1. <Countries> In case that there are few countries or states or regions in the
same XML.
2. <Country name=”spain”> Current country/state/region in the XML with
name attribute.
3. <location_id name=”1011”> Unique name for the location like city name or
unique id. This field is not used currently, so you can just put the city name
there or a unique id.
4. <lon>10</lon> The longitude of the city. It is not in use, so you can put a
dummy value there, or omit it for a while.
5. <lat>10</lat> The latitude of the city. Not in use now, and might be omitted
as well.
6. <forecasts> The beginning token for all the forecasts of the given city. For
example the first forecast might be for today, the second one might be for
tomorrow and so on.
7. <forecast> The token for a single weather forecast.
8. <datetime>20031128120000</datetime> The date for the current forecast.
9. <winddirection>180</winddirection> Wind direction is measured from
the north clockwise.
10. <windspeedms>12</windspeedms> Wind speed in meter/second.
11. <precipitationmm>1.2</precipitationmm> precipitation in millimeters.
12. <symbol>17</symbol> The symbol of the weather like stormy or rainy.

Symbols

• Symbol 1: Clear, sunny


• Symbol 2: Almost clear
• Symbol 3: Partly cloudy
• Symbol 4: Mostly cloudy
• Symbol 5: Rain-showers
• Symbol 6: Rain-showers with thunder
• Symbol 7: Sleet showers
• Symbol 8: Snow showers
• Symbol 9: light rain
• Symbol 10: rain
• Symbol 11: rain and thunder
• Symbol 12: sleet
• Symbol 13: snow
• Symbol 14: snow and thunder
• Symbol 15: fog
• Symbol 16: clear, sun below horizon (polar night)
• Symbol 17: partly cloudy, sun below horizon (polar night)
• Symbol 18: rain-showers, sun below horizon (polar night)
• Symbol 19: snow-showers, sun below horizon (polar night)

Chapter 15: Appendix 247


15.4 Working in Integrated Environments
When working in a complex environment, using newsroom and automation
software, integration between systems is required.

Viz Weather is able to work with a shared database used by other Vizrt software,
utilizing the database for saving data elements.

Vizrt’s Viz Content Pilot is a newsroom and control software using an Oracle
database for storing data of template based graphics.

Control room automation systems use a Viz Content Pilot Newsroom Component
to fill data into the graphics and to add the data elements to news stories and
playlists (aka. rundowns and running orders).

Viz Weather data elements, stored in the database, are added via the Newsroom
Component in the same manner, using a special template for identifying the data
elements.

Note: Viz Weather is using the same database with Viz Content Pilot 5.0 schemas
and later.

Note: To use Viz Weather with the database, when upgrading Viz Weather, a
conversion of the XML file is required since the file structure is different from the
XML file used by Viz Weather without a database. No conversion is required after
installing a new system.

This following sections contain information on how to integrate the two


environments:

• To configure the database


• To configure Viz Weather

To configure the database


Since Viz Weather is using the Viz Content Pilot database schema, initial
configuration of the database is required:

1. Install Oracle client on the Viz Weather UI machine (version 11.0).


2. Configure the Oracle client’s network connection.
3. Test the database connection.
4. From a Viz Content Pilot machine, connected to the same database, run Viz
Template Wizard.
5. Create a new concept called viz_weather2.
6. Create a blank template, and save it under the name viz_weather2 and assign
it to the viz_weather2 concept.
7. Run Viz Template Wizard’s Template Manager and check that the viz_weather2
template appears in the viz_weather2 concept, and that a default variant was
created.
8. Close Viz Template Wizard.

248 Chapter 15: Appendix


To configure Viz Weather
1. Run Viz Weather.
2. Select the Settings > System menu item.
3. Select the VCP Integration tab.
4. Select the Enable check box.
5. Set a connection alias or a connect string to the database.
6. Set the user, password and schema name.
7. Click the OK button to save the changes.
You will be prompted to restart Viz Weather.
8. Restart Viz Weather.
9. Select the Settings > System menu item.
10. Select the VCP Integration tab.
11. Click the Load Viz Weather Template For VCP From File button.
12. Click OK to close the load message.
13. Click OK to close and save the System Settings.

15.5 Using Multiple Viz Weather Clients


Viz Weather can be launched as a client application connected to a Media
Sequencer server machine.

This environment setup enables multiple users to share Viz Weather data
elements, playlists and system settings. The information is constantly updated
and all clients can access the most updated information.

The following sections explain how to use multiple Viz Weather clients:

• To configure multiple Viz Weather clients


• Editing Playlists and Data Elements
• Locked Playlist

To configure multiple Viz Weather clients


1. Set the following launch flag in the program shortcut target path: -mse
<machine name>
• <machine name>: Refers to the IP or hostname of the Media Sequencer
server.
2. Copy the viz_weather.ini file to all machines that use the same setup.
3. Map the same SharedFolders on all clients.
4. For Viz 2.x users: Map the Viz data root directory on all client machines and
Viz Engine machines.
5. For Viz 3.x users: Connect all client machines and Viz Engines to the same Viz
Graphics Hub.

Note: Every client has to run on a licensed Viz Weather machine with a full Viz
Weather installation.

Chapter 15: Appendix 249


15.5.1 Editing Playlists and Data Elements
When working in a multiple client environment, every client can modify a data
element or a playlist on the server. The changes will be updated on the server and
visible to the other clients after the modifications were saved.

If a data element was updated and saved by one client and another client is using
the same data element in an initialized playlist, an icon in the Init column will
change to indicate that the data element was modified.

The user can continue playing the initialized version of the data element or select
Init Changed Lines to reinitialize the modified data element.

If a data element is edited by one client, and another client tries to open the same
data element for editing, a message will appear warning the user that the data
element is used and cannot be updated. The data element will open as read only.

See Also
• Working with Playlists
• Working with Data Elements

15.5.2 Locked Playlist


A locking mechanism is implemented to prevent two clients from editing the
same playlist, however, in some setups, editing a playlist on one machine while
playlist it from another machine is requires. Both workflows are supported in Viz
Weather. A system parameter, Playlist Lock, is used to define if the playlist locking
mechanism is used or not used.

When using the system with Playlist Lock off, all the clients can edit the same
playlist. Changes will be applied in the order they were made and the playlist
display will be refreshed on all clients. A playlist Counter displays information
about the number of clients using the playlist.

When using the system with Playlist Lock on, if a playlist is locked by one client,
other clients can access this playlist only in read mode and will not be able to save
any changes in the playlist. A red frame around the playlist area will indicate that
the playlist is locked and cannot be edited.

A locked playlist can be modified and saved as another playlist. A client can
unlock a locked playlist, by right-clicking the playlist name and from the
appearing context menu select Unlock Playlist.

A confirmation dialog box will appear if the unlock option has been selected.

Note: Use the unlock playlist option with extreme care. Do not modify a locked
playlist unless you are sure it is not being used in production.

250 Chapter 15: Appendix


See Also
• Working with Playlists

15.6 Additional Columns


Additional columns refer to columns in the Points Data table. These columns
contain data about the points which relates to a forecast time. The data is fetched
from the data supplier and updated in the database tables.

Note: The additional columns data should refer to a place/time combination.

See Also
• Viz Weather Data Configuration
• Working with Meteorological Data

15.7 Using VDCP to Control Weather


VDCP is a common protocol used in the broadcast industry. The protocol is based
on a serial connection between the machines, using the COM port.

15.7.1 VDCP Configuration


The configuration settings are described in the VDCP section.

Configuring VDCP
1. Select the Settings > System menu item.
The System Settings window will open.
2. Select the VDCP tab.
3. Configure the VDCP parameters:
• Enable the VDCP connection.
• The port parameter defines which port number is used to connect the
controlling machine. Default value is COM4.
• playlists_folder is the name of the playlists folder that the VDCP can control.
If the playlists_folder parameter is empty, all the playlists in all folders will
be exposed to the VDCP.
4. Click the Load Commands From File button, to set predefined VDCP
commands in the system.

Note: When sending VDCP commands to Viz Weather, playlist names is case
sensitive.

IMPORTANT! Playlist name is limited to 8 characters when used with VDCP.

Chapter 15: Appendix 251


15.8 MOS Configuration with Avid iNEWS
Viz Weather integration with newsroom systems, using the MOS protocol, is
available via the Viz Content Pilot (VCP) ActiveX module.

In the following example configuration, Viz Weather data elements are saved in
the VCP database under a template called viz_weather2.

IMPORTANT! Before performing the following configuration steps, make sure you
know the machine names and IP addresses of the iNEWS server (Linux machine) and
the Avid MOS Gateway machine (Windows). Also, you need to know the NCS ID,
which is used in your iNEWS system.

In our example environment, the NCS ID is INEWS2 (note that the letter casing is
important).

Tip: The iNEWS system is sometimes referred to as NCS (Newsroom Computer


System).

Edit the host files on all three machines; iNEWS server, iNEWS MOS server, and Viz
Gateway, so that they include each other, and then afterwards test the connection
by pinging the machines by name (make sure each machine can ping the other
machines by name).

This section contains information on the following topics:

• iNEWS MOS Gateway Configuration


• Viz Gateway Configuration
• iNEWS Client Configuration
• Pilot ActiveX Configuration

See Also
• Viz Gateway Administrator’s Guide
• Viz Content Pilot User’s Guide
• System Level Settings
• Application Level Settings

15.8.1 iNEWS MOS Gateway Configuration


On the iNEWS MOS Gateway machine:

1. Open the folder C:\Program Files\Avid\MosGateway.


2. Double-click the mosconfig.xml file and check the following settings:

Check the ncs tag and set the following:

<ncs>
<ncsID>INEWS2</ncsID> <!-- This is only for replication (which we,
vizrt, don't use), but it should match the ncsID of the system -->
<host>INEWSISR</host> <!-- This is the name of the linux (inews server)
machine -->
<!-- the following two lines define the user name and password for
replication (not used by us) just leave the defaults -->

252 Chapter 15: Appendix


<ReplicationUsername>mosrep</ReplicationUsername>
<ReplicationPassword>mosrep</ReplicationPassword>
<!-- Specifies whether MOS Gateway is connecting to a Unicode iNEWS
Server or not. -->
<Unicode>NO</Unicode>
<!-- Allow or Disallow Replication, YES/NO -->
<!-- default is YES -->
<AllowReplication>NO</AllowReplication>
<!-- Allow or Disallow mosItemReplace, YES/NO -->
<!-- default is YES -->
<AllowMosItemReplace>YES</AllowMosItemReplace>
</ncs>

Set the correct device values under the listdevices tag:

<listDevices>
<mosDevice>
<names>

The mos tag is the MOS ID used by Viz Content Pilot. Make sure you use the same
MOS ID throughout the entire system, i.e. in the VCP ActiveX (registry settings),
in the Viz Gateway, and in the VCP INI file. The default installed value for the MOS
ID is PILOT (note that the letter casing is important).

<mos>PILOT</mos>

pilotmos is the device name used by the ActiveX and defined in the iNEWS client
under the MOS-MAP folder (see iNEWS client configuration section):

<amcp>pilotmos</amcp>

Network value is the name (not IP) of the machine running Viz Gateway:

<network>qa-hp</network>
</names>

The following settings define the device permissions and options. This would
normally be a part of the existing mosconfig file and will not require editing, but if
it is missing, copy the following section to the mosconfig.xml file.

<roChannels>
<roChannel>
<iNewsChannel>A</iNewsChannel>
<MosDevChannel>A</MosDevChannel>
</roChannel>
<roChannel>
<iNewsChannel>B</iNewsChannel>
<MosDevChannel>B</MosDevChannel>
</roChannel>
</roChannels>
<!-- -->
<roSlugMaps>
<roSlugMap>
<iNewsRunningOrderName>iNEWSSYSTEMNAME/SHOW.5P.RUNDOWN</
iNewsRunningOrderName>
<MOSroSlug>5P</MOSroSlug>
</roSlugMap>
<roSlugMap>
<iNewsRunningOrderName>iNEWSSYSTEMNAME/SHOW.6P.RUNDOWN</
iNewsRunningOrderName>
<MOSroSlug>6P</MOSroSlug>
</roSlugMap>

Chapter 15: Appendix 253


<roSlugMap>
<iNewsRunningOrderName>iNEWSSYSTEMNAME/SHOW.10P.RUNDOWN</
iNewsRunningOrderName>
<MOSroSlug>11P</MOSroSlug>
</roSlugMap>
</roSlugMaps>

<!-- The handlesEmptyStories element specifies whether this device


accepts -->
<!-- a roStoryInsert message that contains no item. -->
<handlesEmptyStories>YES</handlesEmptyStories>
<!-- -->
<!-- The handlesRoStoryMoveMultiple element specifies whether this
device supports -->
<!-- the roStoryMoveMultiple message. The router defaults to YES. -->
<!-- Valid settings are YES or NO -->
<handlesRoStoryMoveMultiple>YES</handlesRoStoryMoveMultiple>
<!-- -->
<!-- The handlesRoItemLevelCommands element specifies whether this
device supports -->
<!-- roItemInsert, roItemDelete and roItemReplace. The router defaults
to YES. -->
<!-- Valid settings are YES or NO --><handlesRoItemLevelCommands>YES</
handlesRoItemLevelCommands>
<!-- -->
<!-- If YES then the stories page number from NRCS is prepended to the
story -->
<!-- slug. -->
<prependPageNumber>NO</prependPageNumber>
<!-- -->
<!-- The character seperator used between the page number and the story
slug.-->
<prependSeparator>-</prependSeparator>
<!-- -->
<!-- The character string which is used in place of an empty page
number.-->
<prependStringForEmptyPageNumber>NO PAGE</
prependStringForEmptyPageNumber>
<!-- -->
<!-- When set to NO, all MOS items in the rundown will be contained
within -->
<!-- the roCreate message. When set to YES, a blank roCreate message
is sent -->
<!-- and all MOS items in the rundown will be added using roStoryInsert
-->
<!-- messages. The recommended setting is NO unless it's absolutely
required. -->
<sendRoCreateOnStartLoad>NO</sendRoCreateOnStartLoad>
<!-- -->
<handlesSpecMosReqAll>NO</handlesSpecMosReqAll>
<!-- The statusTranslations element defines the status strings that
correspond -->
<!-- to the various NRCS status codes. This allows the MOS Gateway to
translate -->
<!-- the roItemStatus messages received from a MOS into status codes
that NRCS -->
<!-- can recognize and display. -->
<!-- -->
<!-- Should we ignore the item status in roAck messages? -->
<!-- Valid settings are YES or NO, default is NO -->
<ignoreItemStatusInRoAck>NO</ignoreItemStatusInRoAck>
<!-- -->
<!-- Does this device expect the MOS 2.8 version of roListAll -->
<!-- Valid settings are YES or NO, default is NO -->
<handlesRoListAll28>NO</handlesRoListAll28>
<!-- -->

254 Chapter 15: Appendix


<!-- Does this device handle roStorySend messages? -->
<!-- Valid settings are YES or NO, default is NO -->
<handlesRoStorySend>NO</handlesRoStorySend>
<!-- -->
<!-- The retry timeout in seconds for this device. -->
<!-- Set to 0 if you do not want to have retries -->
<!-- Valid values: 0 - 214748647 -->
<!-- Default is 0 -->
<retryTimeout>0</retryTimeout>
<!-- -->
<statusTranslations>
<statusUnknown>UNKNOWN</statusUnknown>
<statusUnavailable>BAD CLIP</statusUnavailable>
<statusUnavailable>NOT READY</statusUnavailable>
<statusUnavailable>UNKNOWN - ERROR INSERTING ITEM</
statusUnavailable>
<statusAvailable>LOADED</statusAvailable>
<statusAvailable/>
<statusCueing>Cueing</statusCueing>
<statusCued>Ready</statusCued>
<statusTensionReleased/>
<statusPlayRequested/>
<statusPlaying>ON AIR</statusPlaying>
<statusPaused>PAUSED</statusPaused>
<statusStopped/>
<statusRewinding/>
</statusTranslations>
<!-- -->
<mosObjReplication>
<trigger>manual</trigger>
<replicationTime>12:31:15 PM</replicationTime>
<clearQueue>true</clearQueue>
<path>mos.mosdevicename</path>
<mosItemBrowserProgID/>
<mosItemEditorProgID/>
</mosObjReplication>
<!-- -->
</mosDevice>
</listDevices>

Note: The file is locked for editing if the Avid MOS services are running. Run the bat
file restart_services.bat until the script is waiting for the user to press any key after
stopping the services and before starting them again. Now open the mosconfig.xml
for editing if you need to make changes.

15.8.2 Viz Gateway Configuration


When installing a stand alone machine with Viz Gateway, a connection to the
Oracle database is required.

1. Install Oracle client to enable a database connection. Test the connection to


the database when configuring Oracle network connection (with the network
admin or network configuration tool).

Note: On older versions of Viz Gateway (1.0), after the connection has been
successfully established, install BDE and configure a connection entry to the
database. Test that connection from the BDE is successful.

Chapter 15: Appendix 255


2. Install Viz Gateway.
3. After the installation is completed, open the Viz Gateway Controller client and
select the Gateway tab.

4. Configure the Newsroom Computer System (NCS) section:


• NCS ID: The iNEWS system ID (in this example INEWS2)
• Server IP: The IP address of the iNEWS MOS Gateway
• MOS Lower Port: Keep the default 10540 port (see advanced configuration
for more details).
• MOS Upper Port: Keep the default 10541 port (see advanced configuration
for more details).
• MOS Version: Version of the MOS protocol used. Keep the default 2.6.0
version.

5. Configure the Gateway section:


• MOS ID: Viz Content Pilot MOS ID used in the system. Make sure this the
same MOS ID as configured in the iNews MAP-MOS folder and in the Viz
Content Pilot ActiveX (default is PILOT).
• MOS Lower Port: Keep the default 10540 port (see advanced configuration
for more details).
• MOS Upper Port: Keep the default 10541 port (see advanced configuration
for more details).
• Control Station Port: This is the port used by the Media Sequencer to
communicate with the Viz Gateway. Keep the default 10640 port.
• Controller Client Port: Defines the port number that the GUI (client
controller) of Viz Gateway connects to. Keep the default 10002 port.

256 Chapter 15: Appendix


The steps above is the configuration required for receiving MOS rundowns from
iNEWS.

6. To receive alerts from the database about modified data elements, the data-
base triggers should be enabled, and the Enable DB section in the Viz Gateway
Controller client should be enabled and configured.

• SID: The Oracle SID used by the database (in most Vizrt installations this will
be VIZRTDB).
• User: pilot
• Password: pilot
• Encoding: Use the database encoding
• DB Event Mechanism: Set the correct database schema used. If using VCP
version 5.0 or higher, select VCP 5. If not, select VCP 4.

7. Press the Save button, and then restart the Viz Gateway.

15.8.3 iNEWS Client Configuration


1. In the iNEWS folder SYSTEM/MOS-MAP, define a device for VCP using the Pilot
MOS ID (PILOT is the default used in Vizrt installations). The MOS-MAP should
look like this:

TABLE-START DeviceTable
.
.
.
PILOT pilotmos ;This line maps the MOS ID used by VizContentPilot
to a mos device name in inews.
.

Chapter 15: Appendix 257


.
TABLE-END

2. In the iNEWS folder SHOW, create a sub folder for the rundown (in this exam-
ple the folder name is NAME).
3. Right-click the iNEWS folder SHOW/NAME, and create a new queue (rundown).
4. Rename the rundown (in this example the queue name is RUNDOWN_1).
5. In the iNEWS folder SYSTEM, double-click the MAP entry to define the Pilot
MOS Device in your rundown (iNEWS queue):

258 Chapter 15: Appendix


First the rundown (queue) is defined in the following format:

Show.NAME.MyRundown Show.NAME - 2400

And then the device:

mos pilotmos@inewsmos update MCT-CG

Note: The device name is the same name as defined before in the MOS-MAP folder
(pilotmos) and the machine name is the name of the iNEWS MOS Gateway machine
(inewsmos).

15.8.4 Pilot ActiveX Configuration


Pilot ActiveX is installed when running the Viz Content Pilot installer.

1. Select the option for Newsroom integration; Newsroom Connect Component.

Chapter 15: Appendix 259


2. Configure the database connection.

3. Configure the parameters of the ActiveX as they will be used in the newsroom
system.

260 Chapter 15: Appendix


IMPORTANT! The MOS ID is the same as configured in all the other software
components used in the integrated environment; Viz Gateway, iNEWS MOS-MAP
folder, and iNEWS MOS Gateway. Also, the BCS device name is the same as defined in
the iNEWS MOS-MAP and MAP folders.

15.9 Viz One Configuration

IMPORTANT! Before you start this configuration, make sure you know the Viz One
machine IP address, machine name, and username/password to the Viz One.

15.9.1 Viz Engine Configuration

IMPORTANT! Check your Matrox card version. Not all cards support all codecs or clip
resolutions. With a 6k model you have only SD codecs support. With an 8k model
you have SD+HD codecs.

1. On a Viz Engine machine with a Matrox card, install the following:

• ffdshow
• MatroskaSplitter
• VideoDownloadConvert

Chapter 15: Appendix 261


Note: Browse to locate these installers from the Internet. Download the latest
software versions, and install.

2. Open a file browser to the Viz One server, and open the folder Soft-
ware\vmeX.X.X.
3. Copy the file ardftp-XXXX.exe and the file ardfsmon.exe to a local folder (for
example C:\temp).

Note: The latest installers can be found on the Vizrt FTP:


http://releases.ardendo.se/builds

4. Open a command shell and install the applications by using the following
commands:

ardftp-XXXX.exe --install --root=<FullPath> --simpleauth

ardfsmon.exe --install --mqserver=<vmeServerName> --


hostname=<VizEngineName> --root=<FullPath>

• root: A folder on the Viz Engine machine, to which the Viz One high resolution
clips are downloaded to. When working in a multiple Viz Engine environment,
set the root path to a shared drive used by the engine machines.
• Mqserver: Name of the Viz One server machine
• Hostname: Name of the Viz Engine you are now configuring

IMPORTANT! Make sure you use the same root path in both the application
command lines above.

5. To remove the applications above, in case you need to re-install, use the
folowing command:

ardftp-XXXX.exe --uninstall

ardfsmon.exe --uninstall

15.9.2 Weather Control Machine Configuration


A pre-requirement for using Viz One clips in Viz Weather is that the Media
Sequencer default.xml file must be configured by Viz Trio with the following
settings:

• Output profile (defining the Viz Engine machines used)


• A Viz Trio scene was created, including the clip channels to be used. Save the
path to this scene, as it will be used later in Viz Weather INI file configuration.

Setting up clip browsing and preview


1. Run Viz Weather and open the System Settings window (Settings > System).
2. Select the Media Engine tab.
3. Select the Enable the Media Engine handler check box.

262 Chapter 15: Appendix


4. Set the Service document URI to the Viz One server URI (http://
MyVMEServer/api/).

Example: http://10.211.3.40/api/

5. Type the username and password to use when connecting to the server.
6. If rendering post clips to be used on the server, enable the Export to VME
check box and set the drop box folder. Load an XML metadata template to use
with the rendered clips.
7. Click OK and restart Viz Weather.
A connection indicator at the bottom of the window will become green,
indicating that Viz Weather is connected to the Viz One server.

The configuration steps above will enable the user to browse the clips on the Viz
One machine, to select a clip and save it in a data element, and to preview the
clip, by selecting Preview from the context menu.

Setting up high resolution clip play on the engine


The following steps define some Viz Trio settings, to be used by Viz Weather. Viz
Weather uses the same settings of Trio, through the Media Sequencer. These
settings are used when connecting to the Viz Engine and playing the clips from
the defined root folder.

8. Open viz_weather.ini file and set the following entries:

[VME]

;vme_trio_scene -> default value is empty, set it to the value of a


default trio scene that
;uses video. Example:

vme_trio_scene= SCENE*02_GFX/VizWeather/vme/VME_textures

;control room - set this value to the output profile name defined in
Trio

control_room= -> default value is vizroom1

15.9.3 On the Viz One Server Side


1. The Viz Engine must be defined in the Servers tab of the Viz One
administration window.
2. After defining the server, check the FTP credentials.
3. Open the Viz One dashboard to control the Viz One by running a web browser
and the address:

http://<servername>

4. In the Dashboard navigation pane, select Administration.

Chapter 15: Appendix 263


The Administration page will open.

264 Chapter 15: Appendix


5. Select Services > Video Servers.
6. In the Video Servers panel that opens, click the Add button, and then select
Viz Engine from the list.
7. Set the machine name (the name of the Viz Engine machine).
8. Click the Save button.
The Viz Engine is now added to the servers list.
9. Select Settings > Servers.
10. In the Servers panel that opens, expand the Select Server drop-down list.
11. Select the server you just added.

Chapter 15: Appendix 265


The following information is displayed:

266 Chapter 15: Appendix


12. Check that the Handle details appear on the right side of the window.
13. Select the ftp/ardftp tab, and check the connection parameters.
14. Close the browser window.

Chapter 15: Appendix 267


16 Troubleshooting Guide
This guide is based on known issues and support cases received from customers.
If a problem was not solved, please contact your Vizrt support person.

This section contains information on the following topics:

• Meteorological Data
• Viz Weather
• Viz Engine
• Mixed Environment
• DataBase Integrated Environment
• Graphic Display Issues

16.1 Meteorological Data


The following section describes problems with fetching meteorological data from
different data suppliers. Make sure the general check-list results are good before
advancing to the specific troubleshooting issues.

• General
• Storm
• Custom Weather

16.1.1 General
General issues
• Check the Internet connection. Browse to a known web site and see that the
connection is good (for example www.google.com).
• Check you local network connection.
• Check the fetch.log file for errors and connection messages. File is found
under the defined fetch data folder (see the Providers Info Configuration
section).

Server is not reachable (Proxy used)


• Check the following link in your web browser:
http://www.storm.no/vizrt/WOD.aspx?la=60&lo=5&date=today
• if the above link does not work, contact your system administrator to make
storm server reachable.
• If the above link works from the web browser, but does not work from Viz
Weather, check your internet browser’s Proxy settings and compare it to the
setting in the Providers Info Configuration: HttpProxy (ip:port).

Firewall preventing connection to server


• Contact your system administrator to setup a web browser connection to the
following link: http://www.storm.no/vizrt/
WOD.aspx?la=60&lo=5&date=today

268 Chapter 16: Troubleshooting Guide


Note: If using a data supplier other than Storm, use your supplier HTTP address to
test the connection.

Entry in fetechParameter.ini file has no effect:


Check the Providers Info Configuration for commented lines. A line that begins
with a ‘#’ sign is commented out. If the parameter is required for fetching the
data, remove the ‘#’ sign to enable the setting.

16.1.2 Storm
Weather points data fetch not working (no data is received):
• Perform the General connection tests.

Fetch DLL is not defined properly


Check the Providers Info Configuration configuration:

dll_path=.\dataSuppliersDlls\dataFetchStorm.dll
dll_logic_name=STORM_NEW_WOD

Make sure that the priorities are properly defined and that the same alias defined
in the dll_logic_name parameter is used in the parameters section (typing errors).

No model data (isobars, etc.) fetch


Check the <weather_folder>/fetch_scripts/log.txt file for errors and other
messages.

Cannot access Storm server


• Check the web browser connection to the following link:
http://storm1.storm.no/viz_data
• you will be prompted for a user name and password. Enter the user &
password as defined in Providers Info Configuration tab, in the WD_Admin
appication.
• if this link does NOT work, contact your system administrator to fix the
connection to the Storm server.
• if the web browser connection is good but Viz Weather is unable to connect,
check the parameters in the Providers Info Configuration tab, in the
WD_Admin appication for typing errors, wrong parameters usage, and so on.

Wrong parameters sent to fetch script


• Check this line in Providers Info Configuration tab, in the WD_Admin
appication: isoScriptParams=-WHWOD,storm1.storm.no,viz_data/
GFS,<userName>,<Password>
• Check user/password, and check the folder name.

NoSatellite, Cloud Forecast or Radar images are fetched


• Perform the General connection tests.
• Check this link in explorer: http://storm1.storm.no/viz_data/satimg/
• You will be prompted for a username and password. Enter the username &
password as defined in Providers Info Configuration tab, in the WD_Admin
appication.
• If this link does not work, contact your system administrator to fix the
connection to the Storm server.

Chapter 16: Troubleshooting Guide 269


• If the web browser connection is good but Viz Weather is unable to connect,
check the parameters in the Providers Info Configuration tab, in the
WD_Admin appication for typing errors, wrong parameters usage, and so on.

Images are not fetched (connection OK)


• Set the following parameter in the Providers Info Configuration tab, in the
WD_Admin appication: <Priority name> fetchMode=pythonScript
• The images will be fetched using a python script and not with HTTP.

Note: To leave the python shell opened after the fetch (for debugging), set the
following parameter in the Providers Info Configuration tab, in the WD_Admin
appication: <Priority name> isoShell=1

16.1.3 Custom Weather


No weather-points are fetched
• Perform the General connection tests.
• Check the following log file for possible issues: <weather_folder>/
FetchData/dataFetch.log

CustomWeather server is not reachable (Proxy used)


• Check your web browser for connection to the following link: http://
xml.customweather.com/
xml?product=current_extended&latitude=32.01&longitude=34.8&clie
nt=vizrt_test&client_password=t3mp
• If this link does not work, contact your system administrator to setup the
connection to the CustomWeather server.

Fetch DLL not defined properly

Check the Providers Info Configuration parameters:

dll_path=.\dataSuppliersDlls\dataFetchCustomWeather.dll
dll_logic_name=CUSTOM_WEATHER

No model data (isobars, etc.) fetch


• Check the following log files for possible issues: <weather_folder>/
FetchData/dataFetch.log and <weather_folder>/fetch_scripts/
log.txt

Cannot access CustomWeather server


• Check the web browser connection to the link: http://
images.myforecast.com/images/cw/client/vizrt_test/
• You will be prompted for a username and password. Enter the username &
password as defined in the Providers Info Configuration tab.
• If this link does not work, contact your system administrator to setup the
connection to the CustomWeather server.

Wrong parameters sent to fetch script


Check this entry in Providers Info Configuration:

isoScriptParams=-W,http://
images.myforecast.com,<UserName>,<Password>,images/cw/client/
vizrt_test/model_data -Pfetch_scripts/log.txt

270 Chapter 16: Troubleshooting Guide


• Check username/password
• Check that the folder is images/cw/client/vizrt_test/model_data

No satellite images fetch


• Perform the General connection tests.
• Check the web browser connection to the link: http://storm1.storm.no/
viz_data/satimg/
• You will be prompted for a username and password. Enter the username &
password as defined in the Providers Info Configuration tab.
• If this link does not work, contact your system administrator to setup the
connection to the CustomWeather server.
• In Viz Weather, open the Settings menu and select Data... . Select the Satellite
tab. Check the satellite names, and that the remote folders match the folder
structure on the CustomWeather server (see the Imagery Configuration -
Radar and Satellite section).

No cloud forecast
• Cloud forecast is not yet available for CustomWeather.

16.2 Viz Weather


The following paragraphs describe potential problems with the Viz Weather user
interface.

Viz Weather stalls after startup


• Open the task manager and check that viz.exe process is not running. If
viz.exe is still running kill the process and restart Viz Weather.
• Check if Media Sequencer is running.
• Check the Media Sequencer window for errors.
• Check system regional settings compared to data stored in MXL file (special
characters).

Weather points not placed correctly on a geographically referenced map


• Check that the Geo check box in the points editor is checked for each of the
selected points.
• Check that the map used in the scene is a GeoImage. Try changing the map
and check again.
• If only a small number of points are placed incorrectly, check that the point
coordinates are correct in 'Points List' tab. correct the values if required.
• If all the points are placed incorrectly, make sure that the config.dp file for the
point types used in the system are updated. To make sure you have the most
updated datapool fields in the config.dp files, run WD_Admin.exe and export
the config.dp file to the Viz Engine folder. for additional details on how to
export the config.dp file, see the Viz Weather Data Configuration section.
• If the problem occurs in a specific scene, check the scene design in Viz Artist.

Weather Points data is not updated in the graphics


• Check that DataPool data is sent to Viz Engine. In Viz Weather, click Viz from
the main menu and select Show Commands. Change a data value used in the
point graphics by editing the Points Data values. Check that a block of data is
sent to Viz Engine by looking at the Viz console.

Chapter 16: Troubleshooting Guide 271


• Make sure that the config.dp file for the point types used in the system are
updated.

Decimal point issues


• When using a decimal separator other than dot, with the default Viz Weather
XML file, error messages will appear during load and when trying to save data
elements etc.
• The better option is to convert the XML to the format used by the system, or
use your previous XML file (in case of an upgrade). Use the Viz Weather XML
convert tool to convert the file decimal character from dot to comma or
comma to dot.

Note: An error message "x.x is not a valid floating point value" indicates a decimal
point problem. This issue occurs if a new system is installed, or an upgrade
replacing the configuration files was performed.

Viz Weather Post Render Issues


• An error message of 'post-render-device' not defined, when using Viz 2.X,
indicates that no post-render device is configured in Viz. To define a post
render device in Viz:
• Run Viz Config or run Viz Artist and open the configuration page.
• Select the Device Manager section and set a Render_Disk_Device as one of
the devices.
• Set the required parameters, save and exit Viz.

• Message ”Clip length... is set to 0” - Indicates that no post render length was
set for all the data elements in the playlist. To set the data elements render
time:
• Make sure the column 'post time' exists in the playlist area. If the column
doesn’t exist, select ‘Customize columns' from the playlist area right-click
menu and drag 'post time' to the columns header.
• Set the render time values, in seconds, in the column 'post time' for each
data element.

• Clip come out in blurry black & whiteClip or size is not correct:
• Check the generated clip files properties (summary). Check the clip’s width
& height. Make sure they match your video output size. (PAL, NTSC, and so
on).

• Clip does not show (black scene is displayed)


• Clip file does not exist on the disk. Check for the path in windows explorer
and check that the clip file exists & plays in windows media

• Codec of clip not supported by Softclip


• Open Viz Artist
• Load scene weatherPost
• Browse in 'softClip' editor to the clip on the disk
• See if the Softclip manages to load the clip.
• If not, select another codec in the render_disk device

Playlist does not advance when hitting ENTER or Play and Next

272 Chapter 16: Troubleshooting Guide


pressing ENTER or play& next - the highlight on the playlist doesn't progress to
next line.

Possible cause 1:

• UDP messages from viz are not received by the control machine.
• Check that the engine machine sends UDP messages back to Viz Weather:
Under the [MISC] section, set the following parameter in viz_weather.ini file:
show_debug_info=y
Restart Viz Weather and open the Debug Window (View->Debug Window)
Select the PLAY UDP messages tab.

Make sure UDP messages are sent back to Viz Weather .


If the UDP messages are not received by Viz Weather, add to viz_weather.ini
file:
[MISC]
local_machine_ip=<ip address of weater GUI >

Possible cause 2:

• There are exposed stop points on the current element, and not all stops were
executed
Add the column 'stops' to the playlist panel and see if there are still stops to
be made on that line

Note: Do not use manual “continue” and "enter or play/next" during play. The stop
point count will probably be incorrect.

Chapter 16: Troubleshooting Guide 273


Possible cause 3:

• There are 2 transitions one after the other in the playlist. Make sure that there
is only one transition between data elements.

16.3 Viz Engine


The following paragraphs describe potential problems with the Viz Engine real-
time graphics rendering machine.

Weather Points are not updated with the correct point data
• The DataPool configuration file with the point type definition is missing:
• Run WD_Admin tool
• Select the Import/Export tabPress the Export config.dp button
• Select the path to Viz folder and save
• Restart Viz

IMPORTANT! Make sure to save the new config.dp file on all machines runnig Viz.

• The Datapool field name was not set in the WD_Admin, or the field name does
not match the field in the viz scene:
• Run WD_Admin tool
• Go to the Point Configuration tab. Press Point Data Fields
• Check the DataPool Name column
• Verify its content matches the name used in the fieldname inside the viz
scene ( graphic template )

Satellite/Radar/Shields animation not running


• ImageClip animation was not defined correctly:
• Check the animation of the ImageClip container. Make sure the animation is
defined.
• Check that the names of the keyframes in the animation are 'start_key' and
'end_key'
• Data was not found:
• Select the menu item ‘Show Commands’ from the Viz menu (in Viz Weather).
Change the dates of the data-element, to force reloading of images. Check
the messages in viz console.
• Fetch folders in the System Configuration window:
• Check that the fetch folders point to where the data is or perform a new
fetch and check that data was stored on disk at the specified folder.
• In a multiple users environment, check that all applications use the same
configuration files.
• If working in a PGM/PVW environment, make sure that the weather fetch
folders are shared between the control system and viz system, using the
same path (i.e. set the same drive letter when sharing the data folder or set
a replace string in Viz Engine).
• Selected area in the editor doesn’t match the map displayed - Change the
map to a world map, and see if the data is displayed.

IsoGrid animation not working in graphics (isobars, isotherms, isoprecip)

274 Chapter 16: Troubleshooting Guide


• Check the animation on the IsoGrid containers in viz. The animation should
consist of two keyframes, defined on the 'Current Frame' parameter of isoGrid.
The names of the keyframes should be 'start_key' and 'end_key'.
• Model data was not found:
• Select the menu item ‘Show Commands’ from the Viz menu (in Viz Weather).
Change the dates of the data-element, to force reloading of images. Check
the messages in viz console.
• Fetch folders in the System Configuration window:
• Check that the fetch folders point to where the data is or perform a new
fetch and check that data was stored on disk at the specified folder.
• In a multiple users environment, check that all applications use the same
configuration files.
• If working in a PGM/PVW environment, make sure that the weather fetch
folders are shared between the control system and viz system, using the
same path (i.e. set the same drive letter when sharing the data folder or set
a replace string in Viz Engine).
• Selected model type in the editor doesn’t match the map displayed -
Change the map to a world map, and see if the data is displayed.
• Browse button in isoGrid does not open the file browser - the defined path is
not found. Change the path string to a valid path (C:\ or any other valid path),
and click the Browse button again.

16.4 Mixed Environment


The following relates to mixed environment related issues (e.g. Viz Trio, Viz
Ticker 3D and Viz Weather).

• Make sure all applications use the same Media Sequencer server.
• The XML file may not match between different applications. Close all
applications and stop the Media Sequencer. Re-launch the Media Sequencer
and run the applications again.
• The Media Sequencer will not load if the default.xml file is corrupted. Delete
the default.xml file and restart the Media Sequencer (the default.xml file is
found in <commonappdata>\Vizrt\Media Sequencer).

16.5 DataBase Integrated Environment


The following issues relate to Viz Weather working in an integrated environment,
with Viz Content Pilot database.

Degrees sign is not correct in editable texts


• Check the following configuration:
The client registry value
HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\KEY_OraClient10g_home1\NLS_LANG
should be as the database was configured. Usually, the value should be:
AMERICAN_AMERICA.AL32UTF8.

Data elements are missing from the list


• Run the Viz Content Pilot client, and from the main menu select Options, Data
List and then Show All.

Chapter 16: Troubleshooting Guide 275


16.6 Graphic Display Issues
The following section describes problems related to the graphic display of the
data elements, which might occur when preparing/running a show.

16.6.1 No Images or Model Data Displayed


If you are running a newly installed system, the first thing to do is to check the
configuration:

• Are the data folders shared between all the machines you are using: Viz
Weather control, Viz Engine machines, Viz Weather Data Hub, Fetch
Application?
• Is the shared data folder mapped with the same drive letter on all machines
you are using (for example W:/)
• In a PGM/PVW setting, are Viz Weather plug-ins installed on the Viz Engine/
Viz Artist machine?

Note: See the Viz Weather System Configuration chapter for additional
information on how to configure the system.

If using a running system, check the following:

• Are all mapped drives connected? Open an Explorer window and check that
the content of the shared folders is available.
• Check for any network issues; disconnected cables, faulty network elements,
network card settings, and so on.
• Was there any kind of recent software update on the machines; new
installations, Windows update, and so on? If so, contact your IT department
and make them check that the settings used by Viz Weather were not effected,

If the meteorological data is not displayed on the Viz Engine machine:

• Open the data element on the control machine and check that the data
element is loading the data and the graphic display is ok.
• How do you send the graphics to the Viz Engine? Using INIT and then PLAY?

16.6.2 Performance Issues with ImageClip


If running a satellite, radar, or any other graphic template that uses the ImageClip
plug-in, some performance issues might occur if using a large number of images
or large images. If such a performance issue occurs, the following section
provides posible solutions to the problem:

• Can images be converted to VBN? VBN is an image type used by Viz Engine to
optimize performance and texture memory usage. The conversion is defined
in the fetch process and the result is a folder with the original images and the
converted VBN images.
• Can the images be scaled down? By using the CutScale application, installed by
Viz Weather, image data is cropped to fit the displayed area on the screen/
map, cutting down texture memory usage and speeding performance during
playout.

276 Chapter 16: Troubleshooting Guide


• Can the Thread option in the ImageClip plug-in be used? The thread option
reduces the texture memory usage by the plug-in and improves the
performance.

Chapter 16: Troubleshooting Guide 277


E
Index Entry in fetechParameter.ini file has no
effect ................................................. 269
Extremes
A High and Low pressure graphics .........96
Additional software
DivX ................................................. 10 F
Oracle 10g ........................................ 10 Fetch dll not defined properly ........ 269
Python .............................................. 10
Firewall preventing connection to serv-
C er ....................................................... 268
Clouds Flows
graphics ........................................... 96 graphics ............................................97
Content area Fronts
columns ......................................... 207 graphics ............................................97
context menu ................................. 201
initialization ................................... 209 H
initialize selected lines .................... 201
initialize selected lines and fetch data ..... Hardware requirements .......................8
201, 209 Control machine ..................................9
insert commands ............................ 203 Render machine ...................................9
insert playlist .................................. 205
playout control ............................... 211
High pressure
post rendering ................................ 205
graphics ............................................96
to add data elements ....................... 206 HP xw8400
to add external Viz commands ......... 206 Render machine ...................................9
to add VCP data element .................. 206
to arrange data elements ................. 206 HP xw8600
to delete data elements ................... 206 Render machine ...................................9
to initialize ..................................... 210
transition, transition effect, insert transi-
HP z800
tion ................................................ 202 Render machine ...................................9
update selected lines ....................... 201
Viz Content Pilot, insert VCP element 204 I
Viz Video Hub, insert video clip ........ 205
Images are not fetched (connection OK)
D ............................................................ 270
Initialization file ................................. 81
Data elements are missing from the list
275 Installation ............................................5
Data Hub Machine ............................... 9 IsoBars
graphics ............................................98
Data Issues ....................................... 268
Database L
........................................ 10
Oracle 10g
Lines
DataBase integrated environment .. 275 graphics ............................................98
Degrees sign is not correct in editable Low pressure
texts .................................................. 275 graphics ............................................96
DivX M
Additional software ........................... 10
Meteorological data
graphics ............................................88

278
N Viz Video Hub, insert video clip ........ 205
Network configuration ...................... 20 Python
Additonal software .............................10
No model data (isobars, etc.) fetch 270
No model data (isobars) fetch ........ 269 R
No Satellite or Radar images are Radar Data
fetched ............................................. 269 graphics ............................................98
Render machine
O HP xw8400, HP xw8600, HP z800 .........9
Oracle 10g
Additional software ........................... 10 S
Satellite Images
P ............................................99
graphics

Playlist Show command ................................ 112


auto update data elements ............... 195
automatic fetch ............................... 193
Storm ................................................. 269
channels ......................................... 197 Storm tracking
columns ......................................... 207 .......................................... 100
graphics
content area ................................... 200
context menu .......................... 190, 201 System requirements ...........................8
control, execution, run .................... 208
data elements ................................. 200 T
DataPool actions ............................. 194
delete ............................................. 190 Troubleshooting Guide ............ 234, 268
general properties ........................... 192
global play time .............................. 194 V
initialization ............................ 195, 209
initialize ......................................... 190 Viz Weather Database Schema up-
initialize selected lines .................... 201 grades ................................................. 12
initialize selected lines and fetch data .....
201, 209 Viz Weather software flow ................. 20
insert commands ............................ 203
insert playlist .................................. 205 W
iteration ......................................... 195
layers ............................................. 196 Weather point
length ............................................ 194 graphics .......................................... 101
loop ............................................... 195
new ................................................ 190
Weather points
flat map graphics, geo referencing ...... 90
optimized initialization .................... 195
globe graphics ................................... 90
playout control ............................... 211
table graphics ................................... 89
post rendering ................................ 205
weekly forecast graph graphics ........... 91
prepare ahead ................................. 193
properties ............................... 190, 191 Weather points data fetch not working
save ............................................... 190 269
texture layers ................................. 197
to add data elements ....................... 206 Weather Points Database Configuration
to add external Viz commands ......... 206 - WD_Wizard .......................................13
to add VCP data element .................. 206
to arrange data elements ................. 206 Weather special objects
to copy ........................................... 191 graphics .......................................... 101
to delete ......................................... 191
to delete data elements ................... 206
to initialize ..................................... 210
transition, transition effect, insert transi-
tion ................................................ 202
update selected lines ....................... 201
Viz Content Pilot, insert VCP element 204

279

You might also like