TS-WAVE User and Developer Guide
Introduction
Optimum Tool for Analysis and Visualization of Time-based Data
Optimum Tool for Analysis and Visualization of Time-based Data
Easily Customized for Proprietary Data Formats
Custom Analysis Using the Full Functionality of PV‑WAVE and the IMSL Numerical Libraries
TS-WAVE’s Features
TS-WAVE’s Main Interface
TS-WAVE Data Handlers
Customization
Analysis Functions
Tab File Output
Batch File Processing
Annotation Objects
Starting and Stopping TS-WAVE
Starting TS-WAVE
Starting TS‑WAVE on a Windows System
Starting TS‑WAVE on a UNIX System
Starting TS-WAVE on a 64-bit System
Execution Time Options
Stopping TS-WAVE
Using TS-WAVE
Navigating TS-WAVE's Main Interface
Getting Started and Configuring Your Session
Opening a Data File
Designing Your Page
What are Objects?
Working with Objects
Creating an Object
Selecting an Object
Resizing an Object
Removing an Object
Copying an Object
Selecting Multiple Objects
Deselecting an Object
Moving a Graph Object
Creating your Page Layout
Working with Multiple Pages
Displaying Your Data
Adding a Header to Your Page
Adding Graph Objects to Your Page
Selecting the Data Parameters to Plot
Customizing Your Graph Object
Customizing Your Y Axis and Overall Graph Appearance
Customizing Your X Axis
Adding a Second Parameter to Your Plot
Adding a Second Page
Creating a Contour Plot
Analyzing Your Data
Visual Data Analysis Tools
Data Zoom
Keyboard Operations on Data Zoom Window
Examine Data Points
Analytical Tools
Using the Standard Functions
Working with User Functions
Exporting Your Data
Working with Tab Files
Saving and Using Tab Templates
Pick Files
Viewing your Pick File
Saving and Using Templates
Saving Templates
Using Your Template
Saving Sessions
Using a Saved Session
Using Resource Files
Creating Your Own Private User Resources
Modifying Only the Resources You Need
Adding Other Resource Files to $USER_RESPATH
Printing
Batch Processing
Creating a Batch Job
Simple Batch Job Example
Tutorial
Defining a Data Source
Data Analysis using Standard Function: Smooth
Plotting Parameters
Customizing the TS‑WAVE Page
Creating a Graph Object
Graphing Data Parameters
Selecting, Resizing and Moving a Graph
Adding a Header Object
Printing your Page
Creating and Viewing a Tab File
Creating a Tab File
Viewng a Tab File
Creating a Batch File
User’s Reference
TS-WAVE Menus and Windows
File Menu
New
New Page
Close Page
Page Setup
Open DataSource
Close Data Source
Copy Open Source
Modify Open Data Source
Export
Save Template
Save Session
Open Template
Open Session
Print
Exit
Edit Menu
Object Select
Cut
Copy
Paste
Delete
Align Graphs
Plot Attributes
Select All
Deselect All
Redraw
Group
Ungroup
Front
Back
View Menu
Page Zoom
Fit To Display
Actual Size
Data Zoom
Window Buttons
Examine Data Points
Set Auto Scale
Set X-Axis Range
Synch X Axes
Show CM Grid
Show Half-CM Grid
Show MM Grid
Show No Grid
Show Page Grid
Print CM Grid
Print Half-CM Grid
Print MM Grid
Print No Grid
Custom Settings
Info Block Settings
Show Info
Auto Redraw
Auto Load
Create Menu
Graph Object
Graph Attributes Interface
Y Axis Interface
Y axis Label Fields
X axis Button
Header Object
Advanced Label Editing Interface
Contour Object
Contour Attributes Interface
Contour Plot Attributes
Level Settings
Contour Level Attributes Interface
Text Object
Text Attributes Window
Line Object
Line Attributes Window
Box Object
Rectangle Attributes Window
Ellipse Object
Ellipse Attributes Window
Create TabData
Select Tab Attributes Window
Output Settings
Tab File Tips
View TabData File
Open Pick File
Close Pick File
Batch Processing
Open Batch File
Add to Batch File
Close Batch File
The Batch Job (*.job) File
The Batch Template File (*tpl)
The Batch Shell Script (.bat for Windows, .sh for Unix)
Executing the Batch Job
Simple Batch Job Example
Batch Multi-Template Example
Batch Print-to File Example
Adding a Tab Data to a Batch Job Example
Adding a Tab Multi-Template to Batch Example
Adding More than One Template to Batch Example
Analyze Menu
Standard Functions
User Functions
Window Menu
Help Menu
User Fcn Help
About TS-WAVE
Resource Files
Customizing TS‑WAVE
Resource File Syntax
Standard TS-WAVE Resources
*.ad Resources
*.ads Resources
Private User Resources
Customizing Selected Resources
Placing Other Resource Files in $USER_RESPATH
NOTE about $USER_RESPATH for TS‑WAVE Developers
Example
Private User Function Example
Using Shortcut Keys
FORTRAN Format Strings
FORTRAN Format Specifiers
Developer’s Reference
TS-WAVE System Variables
Example
Customization Options
Show Info
Customized Startup Command Files
TS-WAVE Runtime Mode Startup File
TS-WAVE Developer Mode (NoBlock) Startup File
Resources
Adding User Functions and Data Handlers
Prerequisites for Creating User Functions and Data Handlers
TS‑WAVE Developer's License
Familiarity with PV-WAVE Programming Language
Understanding !Path Environment Variable
Compiling PV‑WAVE Routines
Understanding tool_name Argument
Example
Creating TS-WAVE User Functions
User Functions Specific Requirements
Modifying the User Function Directory
Creating a Help File
User Function Utilities
Summary of Steps for Creating a Simple User Function
Example 1: Simple Derived Parameter
To create the simple derived parameter user function, do the following:
Function 1
Function 2
Example 2: Derived Parameter with User Interface
To create the user function, do the following:
simpleeq_usr.pro
simpleeq.pro
Using a Plot Window in a User Function
Example
Creating TS-WAVE Data Handlers
Required Routines Overview
Data Handler Calling Sequence
fileinfo Associative Array
Required Keys
Keys Set by TS‑WAVE
Additional Keys
Setting Up Your Data Handler
datahandler.list File
Example
datahandler.ads Resource File
Example
Data Handler Example Overview
Example: <dhtype>_readfile Function
Example: <dhtype>_readdata Function
Data Handler Functions
<dhtype>_ReadFile Function
<dhtype>_ReadData Function
<dhtype>_WriteFile Function
Tips For Creating Data Handlers
Batch Processing
Copying and Modifying Data Sources
TS-WAVE’s Utility Functions
TS-WAVE’s DataManager Functions
DM_addFCN Function
Usage
Input Parameters
Keywords
Returned Value
Example
DM_addPSrc Function
Usage
Input Parameters
Keywords
Returned Value
Example
DM_getSrcList Function
Usage
Input Parameters
Keywords
Returned Value
DM_getSrc Function
Usage
Input Parameters
Keywords
Returned Value
DM_getParmList Function
Usage
Input Parameters
Keywords
Returned Value
DM_getParm Function
Usage
Input Parameters
Keywords
Returned Value
TS-WAVE’s User Interface Functions
GU_newParmlist_Component Function
Usage
Input Parameters
Keywords
Returned Value
GU_updateParmList_Component Function
Usage
Input Parameters
Keywords
Returned Value
GU_readParmList_Component Function
Usage
Input Parameters
Keywords
Returned Value
Discussion
TS‑WAVE’s PrintManager Functions
PM_getDefaultDriver Function
Usage
Input Parameters
Keywords
Returned Value
PM_getCurrentDriver Function
Usage
Input Parameters
Keywords
Returned Value
Example
PM_getDefaultPrinter Function
Usage
Input Parameters
Keywords
Returned Value
PM_getCurrentPrinter Function
Usage
Input Parameters
Keywords
Returned Value
Example
PM_getDriverList Function
Usage
Input Parameters
Keywords
Returned Value
Example
Output
PM_getPrintFile Function
Usage
Input Parameters
Keywords
Returned Value
Example
PM_isPrintToFileEnabled Function
Usage
Input Parameters
Keywords
Returned Value
PM_setPrintFile Function
Usage
Input Parameters
Keywords
Returned Value
TS-WAVE User and Developer Guide
PM_setPrintFile Function