Solar Radio Data Analysis Help
Overview

The Radio Data Analysis software is an IDL widget program that allows users to display, analyze and edit spectrogram data. It is possible to either work on single files or on multiple files fetched from an online repository.

Reports of problems and questions should be sent to andre.csillaghy@fhnw.ch

Getting Started
Quick Start
  • Configure the setup file under:
  • Start sswidl and type rappview
  • To open a file:
    • Click File->Open File.
    • Choose a file and click open.
  • To open a time interval from a specific instrument:
    • Click File->Select data from archive.
    • Choose an instrument and some location(s).
    • Note: If you want to display data from the repository, you have to set an environemen variable FHNW_DATA_ARCHIVE to a folder which you want the program to use it as cache. If you dont set it the current working directory will be used.
  • To edit the spectrogram use the functions from the "Edit" menu.
  • To save the spectrogram click File->Save...
GUI Basics

The GUI has 4 main menus.

  • File: This menu can be used to open, save and print files as well as edit the preferences. Check the topic "File Handling" for more information.
  • Edit: This menu holds all functions to do operations on spectrograms. Check the topic "Edit Spectrograms" for more information.
  • Plot_Control: This menu is created by the used plotting tool plotman. Some buttons have been removed but the function of the remaining buttons are the same. Please check the Plotman Help for more information.
  • Window_Control: This menu is created by the used plotting tool plotman. Some buttons have been removed but the function of the remaining buttons are the same. Please check the Plotman Help for more information.
File Handling

The menu "File" can be used to do everything that has to do with file handling. It has the following structure:

  • Open File: With this function one can open a fits file by choosing it from the file system. The program can als open gziped fits files.
  • Select data from archive: There, a new window will open where one can choose a time intervall, instruments and locations from where the data should be fetched. The environment variable FHNW_INSTR has to point to SSW/radio/fhnw to make this function work. The way it works is:
    • Check if the requested files exist in the local cache. Where this cache is is specified by the environment variable FHNW_DATA_ARCHIVE. If this environment variable does not exits the current working directory will be taken.
    • Check if the files are still up to date.
    • Update files if necessary.
    • Open spectrograms from local archive.
  • Save File (Fits): Save current spectrogram as fits file.
  • Save File (Ps): Save current spectrogram as ps file.
  • Print: Print current spectrogram.
  • Undo: Undo last operation on active panel.
  • Redo: Redo last operation on active panel.
  • Set Plot Preferences: Set options for all new opened files such as color. This is a plotman function please check Plotman Help for further information.
  • Reset Widgets: This function can be used to reset if an error occured and even the exit function does not work any more.
  • Exit: Exit the program.
Edit Spectrograms

The Solar Radio Data Analysis tool currently provides the following functions to edit a spectrogram: (Note: All functions which require a click on the spectrogram can also be turned of using the menu, a right-click or by just starting another function.)

  • Background subtraction...
    • Automatic constant background subtraction: Subtracts automatically a constant background from the image.
    • Manual constant background subtraction: Lets you choose a region with two clicks on the image. Then subtracts the background defined by this region. (Turn this function of with a right-click.)
    • Gliding background subtraction: Displays a form where you can insert the bin width for a gliding background subtraction and then does it.
  • Edit spectrogram...
    • Eliminate automatically wrong channel(s): Eliminates automatically wrong channels from the spectrogram.
    • Eliminate manually wrong channel(s): Click on a channel to delete it. (Disable this function with a right-click.)
    • Interpolate region/point: Draw a region or click on a point. This region/point will then be interpolated. Press 'x' to change the direction of the interpolation. (Disable this function with a right-click.)
    • Set constant value to a region/point: Draw a region or click on a point. Then enter a value to set this region/point to. (Disable this function with a right-click or by pressing cancel on the form.)
    • Set minimal value: Set all values of the spectrogram which are smaller than this value to it.
    • Set maximal value: Set all values of the spectrogram which are bigger than this value to it.
  • Mathematical functions...
    • Exponentiation: Exponentiate the spectrogram.
    • Logarithmization: Logarithmise the spectrogram.
    • Arithmetics: Apply an operation of the form a*x^b+c to the spectrogram x.
    • Integration: Integrate the spectrogram.