.:cplot:home

CPLOT

CPLOT is a software program that quickly plots data from flights of the University of North Dakota's Citation research aircraft. CPLOT is written in IDL which is a commercial software development package. Anyone can run the program by downloading the cplot.sav file and using the IDL virtual machine. No IDL license is needed to run CPLOT.

To Download

---

• Download the cplot.sav file.

1. Create a directory on your computer to save the "cplot.sav" file in, i.e. C:\Program Files\cplot.
2. Download cplot.sav to your computer, i.e. c:\Program Files\cplot.

• Download and install the IDL virtual machine.

1. The IDL virtual machine can be downloaded from http://www.ittvis.com/Downloads/ProductDownloads.aspx
   NOTE: The download file is very large.
2. Run the IDL installation program, i.e. idl64.exe
3. Choose to install IDL.
4. When asked, choose to install the "IDL Virtual Machine", you don't need the full "IDL" development package.

• Create a shortcut on the desktop to start IDL.

1. Right click on the desktop background
2. Select New/shortcut
3. Type in the following for the location (Assuming IDL6.4 was installed in the default location and the cplot.sav file was placed in c:\Program Files\cplot):
   c:\RSI\IDL64ubin\bin.x86\idlrt.exe -vm="c:\Program Files\cplot\cplot.sav"

• Update software for any scripts(The whole ADPAA package)

1. Change directory to /usr/local/ADPAA/src
2. Type this command into the terminal; svn update
3. Change directory to build
4. Type this command into the terminal; make

• How to change scripts

1. Make sure to update software before you change a script
2. After updating software, change your directory to /usr/local/ADPAA/src
3. Change your directory to scripts.
4. To get the syntax on any scripts you can type the script name and the word help

            Example:
            cd scripts
            convert2kml help
            Syntax convert2kml [start=n] [end=n] [format=format] [format_s=format_s] [fill=MVC's] [mvcfield=n] [newmvc=n] < input file > output file

How to Run cplot on Linux/UNIX

---

Two ways:

• Open a terminal:

1. Enter 'cplot' followed by the filename in which you wish to open. Note: Be in the directory of the file.

or

• Open a terminal:

1. Enter 'cplot', and hit enter.
2. Click on Browse on the graphical interface that shows up.
3. Enter the directory of the file that you want to bring up in cplot.
4. Double click on the directory and then click on the file that you want.
5. Click 'ok', 'open file'.

Walk Through

This section describes cplot and its various features.

To Make A Plot

1. Choose a unit for the x-axis of your plot.
2. Choose a unit for the y-axis of your plot.
3. Click on plot and then choose type of plot.

Adding additional lines to plot

1. Select the unit under the axis you wish to add.
2. Click on plot and then overlay.
3. Choose formatting and click ok.

To Change Background Color

1. Click edit and then settings.
2. Then move background slide bar under color palette. Note: 0 = Black and 225 = White.

To Change Foreground Color

1. Repeat Background process, but for the foreground slide bar.

To Edit Labels on Plot

1. Click edit and then text.
2. To edit the names of labels:

• Under Plot Titles, type edits into corresponding section (x-axis, y-axis, main).

1. To edit the font size:

• Under Plot Font Sizes, type desired size into corresponding boxes (overall, x-axis, y-axis).

To Change Values of x-axis and/or y-axis

1. Click edit and then axis.
2. You will be able to type you minimum and maximum values for each the x-axis and y- axis.

• You can also change the type, grideline, and style of each axis.

Additional eps output

1. Click on edit and then options.
2. On the bottom of the pop up window there will be an option to create eps file. Click on the box.
3. Replot the data that you want to be in the eps file.
4. To display the eps file before you save it you type this into your terminal:

• evince cplot_latest.eps

To Gather Statistic Information for Box Plots

• In terminal use the command:

  cplot stats outputstats time_min = time_max = r_para = X y_para = Y stats_file = <filename>.stats <Input file>

  i.e 'cplot stats outputstats time_min = 76854 time_max = 76989 y_para = 10 stats_file = filename.stats inputfile

• Where time_min and time_max indicate the start and end times
• Where r_para is used to indicate the use of a ratio of 2 variables
• Where y_para is the numerator value of the ratio, or simply the y parameter to be plotted

• To find parameter number use command 'listparas <filename>'
• To view stats file use the command 'vi <filename.stats>

  output file should display as below:

  StartTime EndTime Year Month Day ID Mean Std_Dev 5_percen 25_percen 50_percen 75_percen 95_percen

  76854.3900 76989.3500 2012.0000 7.0000 29.0000 10.0000 -0.1487 0.2362 -0.5050 -0.2900 -0.1700 0.0100 0.2700

Once the ***.stats_file is created, this file can be run in Cplot. If everything is right (17characters long before the .stats.*** file name) there will be a boxplots option in the plot menu.