Display and Analysis software FUVIEW3 for IMAGE-FUV data Release 8.0.0 of November 29, 2006 Harald U. Frey Space Sciences Laboratory University of California Berkeley, CA 94720-7450, U.S.A. hfrey@ssl.berkeley.edu ### GENERAL ### The new FUVIEW3 software is based on the original FUVIEW released in 2000 and an updated FUVIEW2 of 2003. It is a widget-based software that runs under IDL on UNIX SUNOS Solaris platform. It allows the display of the original data from the three sub-instruments of IMAGE-FUV: - Wideband Imaging Camera (WIC) - Proton Aurora channel of Spectrographic Imager (SI-12) - Oxygen channel of Spectrographic Imager (SI-13) The new features of FUVIEW3 are the following: 1. The major change is an improved pointing calculation which corrects for the spin axis coning after the loss of RPI antennas. The new pointing will be calculated for data after the summer of 2002. Before that, the old way of calculations will be used. HOWEVER: The pointing calculation depends on valid data from the star tracker. During the so-called "Summer vacation" when the star tracker was not working, only interpolated spin axis data are used that are at times still inaccurate. The "Summer vacation" covers the following time periods: ; 2001 summer vacation, [2001,159,00,00] to [2001,233,02,00] ; 2002 summer vacation, [2002,141,22,00] to [2002,234,12,00] ; 2003 summer vacation, [2003,160,00,00] to [2003,228,00,00] ; 2004 summer vacation, [2004,162,19,30] to [2004,243,05,00] ; 2005 summer vacation, [2005,165,05,00] to [2005,237,21,30] 2. Older version allowed only the reading of a complete data file which generally covers 24 hours. The new version allows to read a specific time period, that now can extend across midnight. 3. The new version includes improved airglow subtraction. 4. Mapping of images into the southern hemisphere is included. 5. The new version allows input and plotting of ground locations like radar sites or satellite footprints. 6. The minimum geomagnetic latitude for the geomagnetically mapped image can be changed between 50 and 60 degrees. 7. A new keogram feature allows the creation of keograms along MLT with collapsed data in magnetic latitude. 8. Quantitative calibration through the whole mission. 9. Mapping to the southern hemisphere. 10. An improved HELP utility gives additional information about the software and its capabilities. ### INSTALLATION REQUIREMENTS ### The old FUVIEW used the UDF-IDL-DLM that was originally developed at Los Alamos National Laboratory. The new FUVIEW3 will not work with that DLM interface and requires the installation of the new UDF-IDL-DLM that was created by Chris Gurgiolo (chrisg@cybernet1.com). This software and installation guide can be obtained from http://image.msfc.nasa.gov/software.shtml The old FUVIEW used just the IMAGE-FUV data files and all the information in them to calculate pointing and mapping. The new FUVIEW3 requires the additional reading of spacecraft data (IMS2BYTE and IMS4BYTE) in order to better calculate the pointing. These data files need to be installed in addition to the FUV data. The source for all IMAGE data is ftp://nssdcftp.gsfc.nasa.gov/spacecraft_data/image/ The installation of these data can either be done using dBAsk, or the "Promote" feature of the UDF-software. FUVIEW3 has been developed under the UNIX operating system. The UDF software runs on all major platforms (UNIX, Linux, Windows, NT, and OSX) but FUVIEW3 has not been tested for these platforms. Interested groups who want to run the software on other platforms than UNIX should contact Harald Frey or Tom Immel (immel@ssl.berkeley.edu) for help and advise. Download the UNIX tar-gzip file fuview3.tar.gz through the FUV web-site http://sprg.ssl.berkeley.edu/image/wic_summary/fuview3/ where you can also find this README file. FUVIEW3 runs under IDL version 6.2 and higher. ### Data requirements ### Useful FUV data exist for the time period 2000-140 to 2005-352. At this time the new pointing calculation is only applied to FUV data after 2002-234. Satellite data before that date are not required do be stored on your local system. ### SETUP ### === Anybody who used the old FUVIEW === First you need to install the new UDF-IDL-DLM software according to the guidelines above. You just needs to copy, unzip, and un-tar the software package, preferably into a new directory. I specifically renamed the core program to FUVIEW3 in order to make sure that the old setup may not be used accidentally. You need to point to your new UDF software and your new directory with the FUVIEW3 IDL software. An example for my UNIX system here at SSL is the following: setenv UDF_HOME /home/udfadmin/SUN/uHome/uCore setenv UDFTOOL_HOME /home/udfadmin/SUN/uHome/uTools set path=($path /home/udfadmin/SUN/uHome/uTools/bin) setenv IDL_DLM_PATH "/home/udfadmin/SUN/uHome/uTools/UDFToIDL:" alias idl '$IDL_DIR/bin/idl -32' # remove comment if you want to enable promote feature #setenv UDFPROMOTE 3 setenv FUVIEW_HOME /disks/sprite/image/fuview3 Line number 4 in fuview.cfg has changed and needs to be updated in your personal .fuview directory. You should also check if your IDL_STARTUP.pro file points to the FUVIEW directory and need to change it to the new FUVIEW3. Start the IDL session in 32 bit mode, not in 64 bits. After these changes you should be all set up and hopefully able to enjoy the new features of FUVIEW3. === Anybody who never used the old FUVIEW === Additional information that was written for the original FUVIEW software can be found at http://sprg.ssl.berkeley.edu/~immel/extract_imageinfo.html First you need to install the UDF software according to the guidelines above. You also need to set up the data system. You needs to copy, unzip, and un-tar the software package, preferably into a new directory. You need to point to your new UDF software and your new directory with the FUVIEW3 IDL software. An example for my UNIX system here at SSL is the following: #### add to .cshrc file ##### setenv UDF_HOME /home/udfadmin/SUN/uHome/uCore setenv UDFTOOL_HOME /home/udfadmin/SUN/uHome/uTools set path=($path /home/udfadmin/SUN/uHome/uTools/bin) setenv UDF_DATA /disks/sprite/disk4/udf_data setenv IDL_DLM_PATH "/home/udfadmin/SUN/uHome/uTools/UDFToIDL:" alias idl '$IDL_DIR/bin/idl -32' # remove comment if you want to enable promote feature #setenv UDFPROMOTE 3 setenv FUV_HOME /disks/sprite/disk1/hfrey/idl/image/fuview setenv FUVIEW_HOME /disks/sprite/image/fuview3 ############################## You need to set up a .fuview directory in your home directory, copy the fuview.cfg file into it, and edit the path, output, and printer information according to your system. Add two lines to your idl_startup.pro file that will point to your IDL software equivalent to this: fuview_path=expand_path('/disks/sprite/image/fuview3') !path=!path+':'+fuview_path Start the IDL session in 32 bit mode, not in 64 bits, and issue the command: @fuview3 Now you should be ready and hopefully able to enjoy the new features of FUVIEW3. ### Examples #### This directory also contains a few examples that illustrate some new capabilities of FUVIEW3. - correction.gif illustrates how stars appear to move through a series of 16 individual images. The motion from right to left is caused by the motion of the spacecraft, the motion up and down is caused by the coning of the spacecraft spin axis. The middle panel illustrates which star locations were calculated with the old software. The right panel shows the positions as calculated by the new FUVIEW3 software. - s12_20000715140051.gif shows some footprints of a satellite plotted into the images - s12_keo_20000715_1400_1502_Y0120.gif is a keogram that was created between 1200 MLT and 1200 MLT across local midnight with the latitude range of 60-70 degrees collapsed