RoiView Files

RoiView 
ver 0.75
September, 2010

This program reads ROI_PAC files (*.int, *.slc, *.unw, *.dem, *.hgt or *.cor file)
and other formats, convert them to an RGB image and allow to explor the data. 
  
tested with python 2.6; numpy 1.3.0; matplotlib 0.99.1; 

first created: 26 December, 2007 by Ran Novitsky Nof: ran.nof@gmail.com

##################
#    LICANSE     #
##################

This file is part of the RoiView software.

RoiView is distributed in the hope that it will be useful, but WITHOUT ANY 
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR 
A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with 
RoiView; if not, see <http://www.gnu.org/licenses/>.

##################
#     INSTALL    #
##################

SOURCE:
-------
Download the source code and untar it.
Since it's a python code there is no need to compile it
but you'll need to install python: http://www.python.org/download
(RoiView was tested with python 2.6 and 2.7)
Note! you might need to modify the first line in the roiview.py code:
#!/usr/bin/env python
to your python environment.
in addition some python modules are needed for running the code:
 # scipy, numpy, pylab modules: http://www.scipy.org
 # matplotlib module: http://matplotlib.sourceforge.net/index.html
 # pygtk gtk modules: http://www.pygtk.org
 # other modules might be needed depending on your python distribution.

LINUX BINARIES:
---------------
Download the binaries tar, untar it to your prefered directory (e.g. /usr/local/bin,
add the directory to your user path. you might need to modify the binary file to enable execution:

sudo chmod +x roiview

WINDOWS BINARIES:
-----------------
Download the msi file and run.

##################
#     RUN        #
##################
SOURCE:
-------
Use roiview.py to run the program.
BINARIES:
---------
Use roiview to run

##################
#     MANUAL     #
##################
See index.html in the <roiview>/DOC directory.

##################
#     BUGS       #
##################
1. A known issue is the high memory usage. That's part of the matplotlib module problems.
   for a low memory machines it is recommended to use -o option without -s 
   (this will produce the image with now viewing option) or reduce the file size.
2. ERROR: "Sorry, Can't creat image. Colorbar instance has no attribute '__getitem__'.
   Changes in matplotlib colorbar function cause this error. Fix:
   With the source package, go to the code where roiview.py is and run:
   sed -i "s/colorbar\[0\]/colorbar/g" *.py
   sed -i "s/colorbar\[1\]/colorbar\.ax/g" *.py
3. When using ROI_PAC output files: "Sorry, Can't create image"
   This is a known problem of the roi-pac headers. 
   The number of lines should be adjusted to the correct number of lines in the file.
   You can check it by using the following formula:
   [file_size_in_bytes] = width X length X 8
   Usually, the length should be decreased by 1.
please report bugs and other issues to:
ran.nof@gmail.com

##################
# TODO list:     #
##################
  most important - speed things up.
  write help html files
  add documentation
  link command line help to html files.
  add region selector and manipulator.
  add more control over fonts (type and size) and colors
  add data point selection/extraction
  add support for reading rgb flies
  add support for more than 2 layers
  add support for grd files (read/export)
  add kml option for images
  add support for exporting to different data types,bytorder and structures 
  add support for changing data spatial limits