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 email@example.com, or to firstname.lastname@example.org) your hostname (xxx.yyy.edu or whatever) and hostid. The latter can be obtained on either Windows or Unix (Linux, MacOS) 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.
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.gifThis 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.
Another important command is mr_detect which not only detects the clusters, with support for lots of noise models, but also calculates and outputs parameters for all objects or `blobs' found. The objects or blobs can be at different resolution scales, or a combination of them.
To detect structures at levels 1 and 2, i.e. essentially stars, we use mr_detect -n 7 -L 2 ngc2997.fits im_stars.fits Options -n 7 -L 2 indicate, respectively, 7 scales for the analysis, and scales 1 and 2 for object detection. To detect larger-scale structures, we use mr_detect -n 7 -F 3 -L 6 -K ngc2997.fits im_gal.fits The option -K keeps objects close to the image boundaries which would otherwise (for safety) be ignored, and the -F 3 option implies scale 3 is the starting scale used for object detection. Extended structures were obtained by ngc2997 - im_stars (for example, in IDL, followed by writing of the images as GIFs).
-v Type_Visushould read
-V Type_Visu(not least because option -v is already used for Verbose).
directory area pub/updates
for other updates, categorized by operating system.
MR/1 Software homepage: http://www.multiresolution.com
Contact: email@example.com or firstname.lastname@example.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.
MR Software - Required for Demanding, Ambitious, Challenging Applications!