The GridWare File Converter Manual 
Version 1.0 
 
Overview 
 
The GridWare File Converter is a versatile, user‐friendly tool to prepare files for 
use in GridWare
. The converter currently can only handle two input formats: Noldus 
Observer
 files (*.odf) and existing GridWare files (*.trj, *.gwf). Multiple files can be 
converted at one time and the GridWare File Converter will even create a *gwf file 
template based on the input files. Thus, there are two possible sets of steps in the 
conversion process: 
 
1. Raw Data (Noldus ODF files)
 Æ Recode Scheme Æ TRJ files
 and GWF Template 
2. TRJ files
 Æ Edit State Variables Æ new TRJ files and revised GWF file 
 
Table of Contents 
 
Overview
 
Table of Contents
 
i. System Requirements
 
ii. Installation Instructions
 
iii. Contact Information
 
1. GridWare Data Format (GridWare File Converter Output)
 
1.1 Trajectory Files:
 
1.2 GridWare File (*.gwf) and the Trajectories List File
 
Pdf to ppt converter - application control tool:C# Create PDF from PowerPoint Library to convert pptx, ppt to PDF in C#.net, ASP.NET MVC, WinForms, WPF
Online C# Tutorial for Creating PDF from Microsoft PowerPoint Presentation
www.rasteredge.com
Pdf to ppt converter - application control tool:VB.NET Create PDF from PowerPoint Library to convert pptx, ppt to PDF in vb.net, ASP.NET MVC, WinForms, WPF
VB.NET Tutorial for Export PDF file from Microsoft Office PowerPoint
www.rasteredge.com
1.3 GridWare Variable Types
 
2. GridWare File Converter Data Formats (Input)
 
2.1 ODF files
 
2.2 Recode File
 
3. The GridWare File Converter
 
3.1 Creating New Trajectory Files (ODF Æ TRJ)
 
3.2 Editing Existing Trajectory Files (TRJ Æ TRJ)
 
3.3 Preparing the converted data for use in GridWare
 
4. Tab‐delimited Text Files
 
5. Tips and Troubleshooting
 
 
i. System Requirements 
The user must have Java 2 Platform, JRE Version 1.5 (or later) installed on 
their computer. The Windows version can be downloaded for free from the Java 
web site (http://www.java.com
) and the Mac version can be downloaded from 
www.apple.com/java
. GridWare can be run on Windows XP and Mac OS X. The 
Windows version may run on other versions of Windows but the Mac version will 
not work with Mac OS 9 or earlier.  
ii. Installation Instructions 
 
The Windows download is compressed in a zip format (www.winzip.com
 
for a free download of the decompression software) and the Mac download is 
compressed in StuffIt format (www.stuffit.com
 for a free download of the 
decompression software, although it should be present on a Mac by default). Once 
you have downloaded the compressed file, decompress it (double‐click to open, 
right click to select decompression application, or open it from a decompression 
application) and save the GridWare File Converter in a folder of your choosing. 
The GridWare File Converter will run on data files that are located in another 
folder anywhere else on the computer’s hard drive. 
iii. Contact Information 
 
The GridWare File Converter was programmed by Ji Cho, Shawn Drape, 
and Vishnu Nair at Queen’s University under the direction of Tom Hollenstein
who wrote the manual and is available for consultation and technical assistance in 
the application of this software.   
application control tool:Online Convert PowerPoint to PDF file. Best free online export
Online Powerpoint to PDF Converter. Download Free Trial. Convert a PPTX/PPT File to PDF. Just upload your file by clicking on the blue
www.rasteredge.com
application control tool:C# PDF Convert: How to Convert MS PPT to Adobe PDF Document
Our XDoc.Converter for .NET can help you to easily achieve high performance PDF conversion from Microsoft PowerPoint (.ppt and .pptx).
www.rasteredge.com
1. GridWare Data Format (GridWare File Converter 
Output) 
 
This section describes the file formats that GridWare
 requires to run. 
Therefore, these are the formats of the output from the GridWare File Converter.  
All data for a project should be saved in the same folder (the data must be 
within a subfolder – see below), although this does not have to be the same folder 
as the GridWare
 program. There are 2 file types necessary for input to GridWare
The first is the raw trajectory data, one file for each trajectory. The second is a single 
text file that is the list of the Trajectory files. This is the GridWare file (*.gwf)
 that 
specifies the variables and values for each trajectory. Before using GridWare
, the 
user must prepare these files according to the following specifications.   
 
IMPORTANT! The folder that contains the data (Trajectory Files
must be in the same directory as the GridWare File or Trajectories 
List File
. This folder must be named in this way: the name of the 
Trajectories List File or GridWare File
 followed by “_trjs”. For 
example, if the name of your GridWare File is “Cohort 1.gwf”, then 
the data to which “Cohort 1.gwf” refers must be in a folder named 
“Cohort 1_trjs”. Each time you save 
in GridWare, the Trajectory Files
 
in the folder get overwritten to include information about the 
changes made and the color and position of all the nodes. Therefore, 
it is recommended that the user keeps a copy of the original 
Trajectory Files
 somewhere else as a backup before starting a new 
GridWare project
.  
1.1 Trajectory Files:  
The structure of each Trajectory file is as follows: 
‐ The first row contains the labels for each column 
‐ There must be only one column for onset times, and at least 2 other columns of 
time series data (state variables) 
‐ Each row is a new event. For event‐based data where each new row is not an 
onset time but a new event, ONSET can be simply an ordered sequence of 
integers. 
‐ the final row must have only a time value, but no values or spaces for any other 
variable. That is, the last digit of the last onset time (end time) must be the end 
of the file.
This value represents the OFFSET of the final event 
‐ Onset time for each event must be the first column. These times can be in one of 
several formats: decimal (...0000.000...), real time (hh:mm:ss), or a combination 
(mm:ss.00). All onsets will be converted to seconds, however, both within the 
application control tool:How to C#: Convert PDF, Excel, PPT to Word
How to for XImage. All Formats. XDoc.HTML5 Viewer. XDoc.Windows Viewer. XDoc.Converter. View & Process. XImage.Raster. How to C#: Convert PDF, Excel, PPT to Word
www.rasteredge.com
application control tool:VB.NET PowerPoint: Convert PowerPoint to BMP Image with VB PPT
NET PPT document converter allows for PowerPoint conversion to both images and documents, like rendering PowerPoint to BMP, GIF, PNG, TIFF, JPEG, SVG or PDF.
www.rasteredge.com
onscreen display and in any file output, including when re‐saving trajectory 
files. 
‐ Separation between columns must be tab delimited
. Blank spaces are 
considered part of a single text label or value. 
‐ Missing events (i.e. points where subject is inaudible or out of view) must be 
represented with a symbol that is consistent with the user‐defined symbol set in 
the Preferences
 menu option. It is recommended that the user select a missing 
symbol (i.e.”*” or “.” or “NA”) which is compatible with the statistical software 
that will be used with the exported measures. The default symbol is “–“. See 
Tips and Troubleshooting
 for details about how to change the missing value 
symbol. 
 
 
For example, here is a short trajectory file (“A1_1.trj”) with 3 state variables: 
 
Onset variable 1 
variable 2 
variable 3 
0.00 
1.65 
2.30 
4.10 
6.48 
8.60 
10.25 2 
12.82 2 
13.17 4 
15.00 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
In this file, the trajectory starts in variable 1 = 1, variable 2 = 3, and variable 3 
= 2. The next event is 1.65 seconds (or whatever time units these values represent) 
later when variable 3 switches to 3, but the other two variables remain the same as 
before, so the display does not change. At 2.3 seconds, variable 1 now shifts from 
category 1 to category 2. The trajectory ends at 15 seconds. 
Back to Table of contents
 
1.2 GridWare File (*.gwf) and the Trajectories List File 
GridWare
 file begins as a Trajectories List File that the user wants to put 
into GridWare
. Before the first use, the Trajectories List File need only contain a 
minimum of one column of ID’s and one column of Trajectory file names. This file 
is also tab delimited
. This is the file that allows the user to specify other variables 
that are associated with each trajectory. Hence, these variables are called trajectory 
variables
. These variables may specify gender, the wave of the study, classifications 
application control tool:How to C#: Convert Word, Excel and PPT to PDF
All Formats. XDoc.HTML5 Viewer. XDoc.Windows Viewer. XDoc.Converter. View & Process. XImage.Raster. Adobe PDF. How to C#: Convert Word, Excel and PPT to PDF.
www.rasteredge.com
application control tool:VB.NET PowerPoint: Process & Manipulate PPT (.pptx) Slide(s)
VB.NET PowerPoint processing control add-on can do PPT creating, loading We are dedicated to provide powerful & profession imaging controls, PDF document, image
www.rasteredge.com
of those on whom the trajectory is based (i.e. depressed/non‐depressed, familiar 
peer/non‐familiar peer), experimental condition, or any other grouping which 
distinguishes one trajectory from another.  
 
For example, a longitudinal observational study of children’s behaviour 
with both father and mother might have a Trajectories List File that looks 
something like this: 
Family Wave 
Age 
Gender Filename 
A1 
11 
male 
A1_1.trj 
A1 
12 
male 
A1_2.trj 
A1 
13 
male 
A1_3.trj 
B2 
female B2_1.trj 
B2 
10 
female B2_2.trj 
B2 
11 
female B2_3.trj 
C3 
10 
male 
C3_1.trj 
C3 
11 
male 
C3_2.trj 
C3 
12 
male 
C3_3.trj 
In this file, Family and wave correspond to the file name. Wave designates 
the wave of observation for each trajectory, Age indicates the age of the child, and 
Gender indicates the child’s gender, and the file names are the Trajectory files that 
contain the multivariate time series data.  
Once this file is read in to GridWare
 and the trajectories are displayed, it is 
saved upon closing as a GridWare File. The saved GridWare File contains the 
original information provided by the user plus has all of the other specifications 
(variable definitions, preferences, axis labels) necessary for each subsequent use. It 
is possible for the user to edit or even create the full, saved version of a GridWare 
File from scratch. Some users may find this a better way to prepare their files. 
However, there are strict limitations to the format of the file (i.e. tab delimiters
) and 
GridWare
 simply will not run if there is any
 deviation from the format (see section 
2.1 Opening a New Project
).  
 
For the above example, the saved GridWare File might look like this: 
<GridWare> 
<Config> 
trajectory 
categorical 
family  
trajectory 
ordinal wave 
trajectory 
ordinal age 
13 
trajectory 
categorical 
gender  
state ordinal variable 1 
state ordinal variable 2 
state ordinal variable 3 
MinReturns 
MaxReturnTime 10 
MaxReturnVisits 6 
MinEventDuration 
MinCellDuration 0 
MissingValueSymbol 
-- 
</Config> 
<Trajectories> 
Family Wave 
Age 
Gender Filename 
A1 
11 
male 
A1_1.trj 
application control tool:VB.NET PowerPoint: Use .NET Converter to Convert PPT to Raster
VB.NET PPT to raster images converter very well. Check PPT to PNG image converting sample code in VB powerful & profession imaging controls, PDF document, image
www.rasteredge.com
application control tool:VB.NET PowerPoint: Convert & Render PPT into PDF Document
VB.NET PowerPoint - Render PPT to PDF in VB.NET. What VB.NET demo code can I use for fast PPT (.pptx) to PDF conversion in .NET class application?
www.rasteredge.com
A1 
12 
male 
A1_2.trj 
A1 
13 
male 
A1_3.trj 
B2 
female B2_1.trj 
B2 
10 
female B2_2.trj 
B2 
11 
female B2_3.trj 
C3 
10 
male 
C3_1.trj 
C3 
11 
male 
C3_2.trj 
C3 
12 
male 
C3_3.trj 
</Trajectories> 
</GridWare> 
In this example file, the lines in red text are opening and closing tags that 
signal the different parts of the file. The Config section (<Config> to </Config>
specifies all the variable definitions and preferences. The trajectories section 
(<Trajectories> to </Trajectories>) is the specification of trajectory variables and the 
file names of the individual trajectory files. The contents of this section are identical 
to the contents of the Trajectory List File which the user must create before the first 
use of GridWare.  
The blue colored lines in the Configuration section are the variable 
definitions for the Trajectory Variables
. The first column is always “trajectory”, the 
second column specifies the variable format (categorical or ordinal), and the third 
column is the Trajectory Variable
 names. For categorical variables, the fourth 
column and beyond are the discrete categories (i.e. Family ID’s) for that variable. If 
the user is creating the GridWare File from scratch, it is not necessary to specify 
these categories – GridWare will include them when the file is saved. For ordinal 
variables, the fourth column is the minimum value and the fifth column is the 
maximum value.  
The purple colored lines are the definitions for the state variables (in the 
individual Trajectory Files
). The first column is always “state”, the second column 
is the variable format (ordinal or categorical), and the third column is the state 
variable name. If the state variable is ordinal, a minimum and maximum value 
must be provided in the fourth and fifth columns, respectively. Unlike Version 1.0, 
Version 1.1 now saves the labels for variables in the Trajectory Files
 directly and 
any edits (i.e. giving text names to integer categories: 1 = hostile, 2 = neutral, etc.) 
overwrite the original Trajectory Files
. See section on Saving a Project
 for more 
details. 
The green colored lines are the user preferences for methods of calculating 
measures and the missing value symbol. Preferences
 can be easily edited from 
within the program. See the section on measures 
for an explanation of these values.  
Back to Table of contents
 
1.3 GridWare Variable Types 
 
Trajectory variables (columns within GridWare File
 or Trajectories List File): 
These are variables that together uniquely identify, describe, classify, index 
or are otherwise associated with the trajectory or the source of the trajectory data. 
At minimum, the ID variable in the GridWare File
 must be entered here. Variables 
such as gender, experimental condition, and diagnosis are just a few examples of 
Trajectory Variables.  
State variables (columns within each trajectory file
 except ONSET): 
These are the time‐series variables which define the events within a 
Trajectory file
. Missing values are possible states that will be displayed as dotted 
lines when plotted on the grid. 
 
2. GridWare File Converter Data Formats (Input) 
 
There are two possible input formats for the Converter. First is a Noldus data file 
(*.ODF, henceforth identified as an ODF file) from the Observer program. The second 
possible input file is an existing Trajectory (*TRJ) file
 that can already be used in 
GridWare
. Because the Trajectory Files
 were described above, only the ODF files will be 
described in this section.  
2.1 ODF files  
ODF files are text files that are the output from the Noldus Observer
 
program up to version 5.0. After version 5.0 (e.g., 6.0, XT), ODF files need to be 
exported from the xml format that is now used. See the Observer XT User’s Manual 
for instructions.  
Each ODF file (see example below) is structured such that there is a header 
section with information about the coding configuration, what was coded, and 
when it was coded (red section below). The next section identifies the media that 
was coded (e.g., the video file), beginning with {media} and ending at {indvar}. 
Next are the Independent Variables designated for that project – this section is 
bounded by {indvar} at the top and {start} at the bottom (see blue section). These 
independent variables will be saved during the conversion process as Trajectory 
(aka Filter) Variables
 that uniquely identify each trajectory. The data to be 
converted into Trajectory Files
 is in next section bounded by {start} at the top and 
{end} at the bottom (see green section). Finally, there is the {notes} section.   
 
SPAFF10 GAP.cnf 
04-24-2004 
00:04:00.00 
{media} 
D:\par001.mpg 
{indvar} 
001 
D2 
{start} 
0.00 Child,0:neutral 
0.00 Mother,0:neutral 
0.96 Child,3:humor 
4.53 Mother,3:humor 
7.66 Mother,0:neutral 
14.50 Mother,4:interest 
18.16 Mother,0:neutral 
19.13 Mother,3:humor 
21.40 Child,4:interest 
21.60 Mother,4:interest 
22.36 Mother,3:humor 
23.16 Mother,0:neutral 
24.66 Mother,4:interest 
25.80 Child,0:neutral 
27.30 Mother,3:humor 
30.66 {end} 
{notes} 
The codes for an ODF file are recorded as Subject,Code,Modifier – comma 
separated mutually exclusive values that are part of the coding scheme. In the 
example above, no modifier was used. For the GridWare File Converter, each 
unique value that precedes the first comma (i.e., the Subject) will become a column 
heading. Thus, for the example above, there will be a Child column and a Mother 
column. These are the State Variables
 with each Trajectory File
. The values that 
come after the first comma will be used to create the values of the State Variables
 as 
specified by the Recode File
 
2.2 Recode File 
 
 
The Recode File specifies how each possible State Variable
 value should be 
converted from ODF
 format to TRJ
 format. Thus, if the coding scheme has 3 Subjects (e.g., 
Mom, Dad, Child) and 4 mutually exclusive and exhaustive codes for each (e.g., Hostile, 
Negative, Neutral, Positive), there are 12 unique states that must be recoded. Below is an 
example (tab‐delimited) Recode File that works on the above ODF
 file example: 
 
 
RECODE FILE
 
 
 
 
 
 
TRAJECTORY FILE (TRJ)
 
 
 
Mother,0:neutral Mother,5 
onset Child Mother 
Mother,1:affection 
Mother,9 
0.00 5 
Mother,2:excitement 
Mother,8 
0.96 7 
Mother,3:humor 
Mother,7 
4.53 7 
Mother,4:interest Mother,6 
7.66 7 
Mother,5:whine 
Mother,4 
14.50 7 
Mother,6:sad 
Mother,3 
18.16 7 
Mother,7:fear 
Mother,2 
19.13 7 
Mother,8:anger 
Mother,1 
21.40 6 
Mother,9:contempt Mother,0 
21.60 6 
Child,0:neutral 
Child,5 
22.36 6 
Child,1:affection Child,9 
23.16 6 
Child,2:excitement 
Child,8 
24.66 6 
Child,3:humor 
Child,7 
25.80 5 
Child,4:interest Child,6 
27.30 5 
Child,5:whine 
Child,4 
30.66  
Child,6:sad Child,3 
Child,7:fear 
Child,2 
Child,8:anger 
Child,1 
Child,9:contempt Child,0 
 
The Recode File must include a tab between the ODF Subject,Code combo and the 
Trajectory File StateVariable,StateValue combo. Note that the Recode File can also 
be used to decrease the number of code categories. For example, instead of the ODF
 
10 code system (codes 0 through 9), the user may want to only have 4 values per 
State Variable
: Externalizing (1: Contempt and Anger), Internalizing (2: Whine, 
Sad, and Fear), Neutral (3: Neutral), and Positive (4: Affection, Excitement, Humor, 
and Interest). In that case, the user could run the following Recode File to obtain 
the desired Trajectory File values. 
RECODE FILE
 
 
 
 
 
TRAJECTORY FILE (TRJ)
   
 
 
Mother,0:neutral Mother,3 
onset Child Mother 
Mother,1:affection 
Mother,4 
0.00 3 
Mother,2:excitement 
Mother,4 
0.96 4 
Mother,3:humor 
Mother,4 
4.53 4 
Mother,4:interest Mother,4 
7.66 4 
Mother,5:whine 
Mother,2 
14.50 4 
Mother,6:sad 
Mother,2 
18.16 4 
Mother,7:fear 
Mother,2 
19.13 4 
Mother,8:anger 
Mother,1 
21.40 4 
Mother,9:contempt Mother,1 
21.60 4 
Child,0:neutral 
Child,3 
22.36 4 
Child,1:affection Child,4 
23.16 4 
Child,2:excitement 
Child,4 
24.66 4 
Child,3:humor 
Child,4 
25.80 3 
Child,4:interest Child,4 
27.30 3 
Child,5:whine 
Child,2 
30.66  
Child,6:sad Child,2 
Child,7:fear 
Child,2 
Child,8:anger 
Child,1 
Child,9:contempt Child,1 
Note: The Recode File must be exhaustive. It must account 
for every possible code in the Observer coding scheme. 
Failure to do so will result in errors when attempting to run 
GridWare. Also, the Recode file must end with the file 
extension .rec in order to run.
Back to Table of contents
 
3. The GridWare File Converter 
 
The GridWare File Converter performs two general types of 
transformations. One is to create new trajectory files from Noldus Observer ODF
 
files, the other is to edit existing TRJ
 files into new TRJ
 files. In both cases, a 
GridWare File (*.GWF)
 is created that corresponds with the converted data.  
When the GridWare File Converter is first opened, the top of the window looks like 
this:  
 
The user then must choose one of four input types that correspond to the desired 
procedure. The first two input options (“Contents of a folder” and  “Recode file 
and data to be converted”) are used when converting ODF
 files into TRJ
 files (see 
section 3.1 Creating New Trajectory Files
). The second two options can be used 
when TRJ
 files are the input (“Trajectories.txt
 file” and “GWF
 file”) and the user 
wishes to modify these TRJ
 files (see section 3.2 Editing Existing Trajectory Files
). 
Once data have been loaded into the GridWare File Converter, the four large 
buttons in the Preview section will be enabled. Clicking on these will show a 
preview of the file selected (Recode
 file, TRJ
 files, Trajectories.txt
 file, or GWF
 file) 
in the Preview Window below.  
 
The GridWare File Converter after loading input data but before data have been 
converted. 
Documents you may be interested
Documents you may be interested