A Quick Start to Using MR/1 Version 2.0

The Very Start

This document contains a short overview of how you can start producing results with MR/1. Along the way we will give hints and suggestions to get the most effective use from this package.

MR/1 Version 2.0 extends Version 1.0 substantially with more wavelet and multiscale transforms, various extra image processing tool commands, lossless compression, support tools for large images, commands for edge detection, and multifractal analysis functionality. A new package, MR/2, is available separately, with functionality for filtering, deconvolution, source detection and other operations based on multiscale entropy.

On the MR/1 Version 2.0 CD which also contains the codes for MR/2 Version 1.0, you will find the executables (for varying operating systems - Dec, HP, Linux, IBM, and Sun; and Windows/DOS). Here are the top directories which you will find on the CD:

COPYRIGHT           doc/                javadec.tgz         windows/
COPYRIGHT.windows   idl/                javamr1/
README              idlv5.tgz           javamr1.tgz
README.windows      javadec/            unix/
The documentation (directory doc) consists of the more than 300 page User Manual, divided for convenience into files vol1.ps, vol2.ps, ... , vol6.ps, and the 30 page brochure entitled "Multiresolution and its Applications: an Overview", doc_demo.ps.

The IDL directory contains various subdirectories, one of which (pro) is the suite of programs you will use to run MR/1 directly in IDL. Another subdirectory contains the public suite of programs including inter alia the readfits and writefits IDL programs. A further IDL directory contains help files for the MR/1 IDL programs.

The javadec directory contains a demonstration Java applet for selective decompression of a previously compressed image. The javamr1 directory contains the Java user interface.

The windows and unix directories each contain the license manager, and the executables, for (respectively) W95/W98/WNT and a range of Unix platforms. To activate your license, you will first need to tell us (preferably by email to fmurtagh@multiresolution.com, or to multires@hotmail.com or fmurtagh@acm.org) your hostname (xxx.yyy.edu or whatever) and hostid. The latter can be obtained on either Windows or Unix platforms by running the appropriate mrhost program, available in either the windows or unix directory.

Please also let us know your operating system, whether your license is to be valid indefinitely or is a limited time demo, whether your license is for all machines of the same operating system, whether multi-user, and finally whether MR/1 alone, or both MR/1 and MR/2, are wanted.

Two remarks on the license manager. Firstly, if your machine is not networked, then you will have to set the value of the environment variable CEA_LICENSE_HOST to localhost. Secondly, if there is any problem in running the license manager, cea_lm, let us know immediately (since optimization compilation options used caused a problem in the past on some systems) and we will explain what needs to be done.

When we return the license key to you, you can install your license manager.

First Steps

MR/1 takes its cue from the input data, in regard to data precision. That is why it is generally best to carry out processing on images in FITS format. MR/1 will take such input as 32-bit floating (4-byte real). This is of importance for noise modeling, for instance. FITS format is easily supported in IDL. To translate to GIF, with proper scaling, we have:

a = readfits('ngc2997.fits')
write_gif, 'ngc2997.gif', bytscl(a)

Independently of IDL, in MR/1 we can also translate to GIF, with rescaling, using

im_convert -b ngc2997.fits ngc2997.gif

This progam allows you also to convert in other directions, e.g. from GIF to FITS.

With IDL one can display images of course. Otherwise you can use xv or ImageMagick's display program under Unix, or Photoshop under Windows, to display GIF files. To directly display FITS files, one possibility is to use SAOimage, which is publicly available for a range of Unix platforms. Another FITS viewer program for MS Windows, Apple Mac and Unix platforms is available at http://www.cv.nrao.edu/~bcotton/fitsview.html.

Some FITS Images for Downloading

A few FITS images for downloading are as follows. Watch out - some are large.

A Range of Examples

Bugs - Corrections

This page is http://strule.cs.qub.ac.uk/~fmurtagh/multires/quick.html

Applications: http://strule.cs.qub.ac.uk/~fmurtagh/multires

MR/1 Software homepage: http://www.multiresolution.com

Contact: {info,sales,help,fmurtagh}@multiresolution.com or fmurtagh@acm.org

MR/1 Version 1.0 was available from about June 1998.
MR/1 Version 2.0 was available from July 1999, as was MR/2 Version 1.0.