Document Actions
WRITEV5D
Appendix A Sec30.
WRITEV5D
WRITEV5D(V1,V2,V3,V4,V5,V6,V7,V8,FILENAME) Write up to 8 variables to a Vis5D-formatted file
|
Arguments: |
V1 |
|
|
V2 |
||
|
V3 |
Up to 8 variables to write to the file |
|
|
V4 |
||
|
V5 |
||
|
V6 |
||
|
V7 |
||
|
V8 |
||
|
FILENAME |
Name of the file to write: file type for Vis5d files is .v5d |
|
|
Result Axes: |
X |
Inherited from variables: all variables must have the same x and y axes |
|
Y |
Inherited from variables: all variables must have the same x and y axes |
|
|
Z |
Inherited from variables; the result grid will contain the union of all the levels that are present in the variables. |
|
|
T |
Inherited from variables: all variables must have the same time axis |
This function calls utility functions from the Vis5D distribution to write a Vis5D-formatted file containing Ferret variables. TheVis5D tool is a system for interactive visualization of large 5-D gridded data sets. It was developed by Bill Hibbard and others at the University of Wisconsin, and can be found at
http://www.ssec.wisc.edu/~billh/vis5d.html
There are limits in Vis5D on the size of the grid and the number of timesteps. The function will issue an error if these limits are exceeded.
To make it more convenient to call the writev5d function, to open Vis5D from Ferret, and to append to a Vis5D file, GO tools are available: vis5d_write.jnl, vis5d_start.jnl, and vis5d_append.jnl. These have the filename first in their argument lists, and do not require the user to specify all 9 arguments to the function.
Example:
Write 3 variables to a file, then append timesteps to some of the variables. There is a gap between the times first written to the file and the times written when we call vis5d_append; this will show up in the Vis5d tool as a gap in time. Last, start Vis5d and open the file.
Yes? SET REGION/I=55:180/J=30:60
yes? GO vis5d_write myfile.v5d sst[L=20:30], airt[L=20:30], fcn_1
yes? GO vis5d_append myfile.v5d sst[l=34,50], airt[l=34,50]
yes? GO vis5d_start myfile.v5d
See the demonstration ef_wv5d_demo.jnl for examples of this function.