SVIEW

Spectral VIEWer

        Please note that the currently supported version is SVIEW_L. Even though that program is part of the AABS package, it is also recommended for standalone operation. The notes below are intended to serve as additional documentation, but the executables now have legacy status.


        This program was originally designed to preview/modify/output broadband rotational spectra recorded with BWO based MMW spectrometers. It can, however, be applied to any type of spectrum and it contains some features not found in commercial spectral transformation programs. The principal options are:

  • input from the compact IFPAN MMW binary storage mode
  • input from two column ASCII, in which case the first line in the file is assumed to contain a descriptive comment, and the remaining lines should contain [frequency,intensity] pairs. The two values in each line should be separated by at least a space or a comma, and it is best if frequency increments are equal. If they are not then the program will interpolate its own equally spaced set of points by cubic splines
  • flexible scrolling/zooming along the frequency and the intensity coordinates
  • measurement of peak frequency, intensity and linewidth
  • automatic peakfinder
  • background subtraction using least squares smoothing
  • normal smoothing
  • output for the gle program which, in turn, can produce publication quality PostScript diagrams
  • output of processed spectrum into the IFPAN MMW binary file
  • easy reconfiguration to adapt to the preferred size/style of the graphics window
  • the program has a half-height option so that SVIEW and ASCP can be used to display predictions and spectra in the form of synchronised strips for easier assignment work - see this example     
 
  Current version
SVIEW.FOR The listing - this is intended for CVF6 compilation. The compilation options for Visual Studio are:

FORTRAN:   /check:all   /compile_only   /fpscomp:filesfromcmd   /libs:qwins    /nologo   /nopdbfile   /optimize:3   /traceback   /tune:pn1   /architecture:pn1   /static

LINK:   kernel32.lib   /nologo   /subsystem:windows   /pdb:none   /machine:IX86   /out:"Debug/SVIEW.exe"

SVIEW.EXE Standard executable for Win95/Pentium I upwards and for 100000 spectral points. Key properties of the display window, namely size and font may now be read from the file SVIEW.CFG (below). The colour depth of the display should be at least 8 bits (256 colours).

In Win95 and 98 it is most convenient to launch SVIEW from the command prompt (i.e. the window that pretends to be the old MS-DOS) preset to the directory containing the spectra.

In WinNT/2000 (and sometimes in W95/W98) it is better to use drag and drop operation of spectral file onto the program icon. For a lot of work on files in one catalogue it is also useful to navigate there with FileSelect, as NT/2000 (but not W95+), defaults to that directory on further reruns of SVIEW.

If the .CFG file has been tweaked to some nonstandard conditions, and a command prompt launch is preferred, then it is generally safer to launch from 'MS-DOS' in a window, rather than in full-screen mode.

SVIEWF.EXE

SVIEW6.EXE

SVIEW10.EXE

Executables for longer spectra - the F version is for 3M points, 6 and 10 are for 6M and 10M points respectively.

The need for longer versions has arisen from the use of SVIEW to view the FASSST spectra from Ohio State. Several ways for converting those spectra from their native IgorPro version into the SVIEW format have been developed by Ivan Medvedev. Here is an additional one, which is external to IgorPro. This is a stand-alone program: CIS.FOR (source) and CIS.EXE (executable), working on a saved IgorPro wave.

       

SVIEW.CFG Configuration file for SVIEW, which has to reside in the directory C:\ROT.

This allows setting of window size, of font type and of its style. The text is hard coded for 30x80 characters, so pixel sizes for the window have to be suitable multiples of this. If SVIEW.CFG is not provided then the program will default to a 800x540 pixel window. If settings in SVIEW.CFG cannot be set then the program will display 'Graphic1' instead of the usual header and character size will be noted to be incompatible with window size.

Only the first set of parameter declarations in SVIEW.CFG is used, the remaining sets are examples of other working declarations, and can be substituted /experimented on as required.

SVIEW.EXE can be placed and executed from any directory but the recommended installation procedure is:

  1. Copy SVIEW.EXE and SVIEW.CFG to directory C:\ROT
  2. Place shortcut to SVIEW on the desktop
  3. If command line operation is desired then add C:\ROT to the path
SVIEW_KEYS.PDF Summary of command keys for SVIEW. The pairs of cursor keys for scaling and scrolling operations have been selected on the basis of position on the QWERTY keyboard. The intended ergonomy of use is perturbed on some other (e.g. German, French) keyboards, in which case a possible remedy is to switch to the EN keyboard while using this program.

A byproduct of rapid use of these control keys is that the user can inadvertently press the Ctrl S key combination, which stops the program and it no longer responds. If this happens press Ctrl Q.

       

  Examples
CD2I2.031 Sample spectrum to play with (in IFPAN binary format)

snapshot1.gif - snapshot of SVIEW display of part of this spectrum

snapshot2.gif - snapshot of the same segment with baseline subtracted out using the smoothing algorithm

  Legacy versions
SV_M5.FOR The last version with MSF5 graphics - there turned out to be too many limitations and this version is no longer supported. Remember that ANSI.SYS is required for the intended appearance of the front screen.
SV_PS1.FOR The last version with MSPS1 graphics. No longer supported for the same reasons as above. Remember about ANSI.SYS and also that the use of optimization on compilation destroys the graphics.
 

Back to the table of programs

       

       

       

MODSPE

MODification of SPEctra

        This program is capable of miscellaneous operations on stored spectra. It supports all file formats, which have been used at IFPAN - without the frequency scale, with nonlinear frequency scale, and with linear frequency scale. Only the linear frequency scale spectra are currently used and the most useful options not available in SVIEW :

  • merging of spectra
  • chopping of spectra
  • reversal and various rescaling options for X and Y axes
  • modification of header information
  • output of spectra as two column ASCII
  • conversion of spectrum to sticks for display with ASCP
  • printout of long spectra on a single strip of paper (but only on old mosaic printers)

        MODSPE will not be modified further, although its most useful features have now been transferred to SVIEW_L.

 
MODSPE.FOR MODSPE1.FOR The listing - the program is for compilation with MSF5 and, owing to limitations of that compiler, has to be compiled as two modules, combined at the linking stage.

ANSI.SYS is required for the intended appearance of the text screens - this is a set of commands to generate fancy looking text in the old MS-DOS, and they are still available for the MS-DOS window in current Windows. To activate this feature place the line DEVICE=%path%\ANSI.SYS in your CONFIG.SYS or the CONFIG.NT file, where %path% is the appropriate path. Be aware that the ANSI.SYS commands were one of the earliest features of the early DOS exploited by some viruses to do their dirty work - this is now hopefully only of historical interest.

MODSPE.EXE Executable compiled with MSF5, launched from the MS-DOS command prompt. Use the CD2I2.031 spectrum as an example.
 

Back to the table of programs

       

       

       

SLIST

Sorted LISTIng for spectra in IFPAN binary format

        The program produces a listing of MMW spectral files sorted according to frequency. It is first necessary to produce a file with the (old style) listing of the contents of the current directory by using, say:

        dir specnam.*>A         for DOS/Win95+

        dir specnam.*/-N>A        for NT/W2000

        The directory listing file A is then declared as input file for SLIST, which will inspect all spectral files in turn and write a frequency sorted listing of their contents to file LIST. With current version it should no longer be necessary to clean the contents of the directory listing file, but if the program crashes then the offending directory entry can be removed by hand.

 
SLIST.FOR The listing. The program is useful but is not used often enough to warrant modification to fully automatic operation.
SLIST.EXE Executable from MSF5. It should be run from the command prompt (i.e. the MS-DOS window) first set to the directory containing the spectra of interest, and requires ANSI.SYS.
LIST Specimen output file produced by SLIST
 

Back to the table of programs

       

       

       

FILMAN

FILe MANager for FTMW spectral files

        This program manages archives of spectral files recorded on the IFPAN FTMW spectrometer. Archives are in a simplified format consisting of binary coded spectra stuck end to end. The principal options are:

  • creation of a new archive and placement of all spectral files in the current directory in this archive
  • addition of spectral files in the current directory to one of the archives already in existence in this directory
  • extraction of all spectral files from a selected archive to the current directory
  • listing of files in a selected archive, this option also stamps old archives with frequency limits of spectra in the archive
 
FM.FOR The listing - this only has text screen operations and is intended to be launched from the MS-DOS window (i.e. the command prompt) first set to the direcory containing the files of interest
FM.EXE The currently favoured CVF6 compilation - should run on all versions of Windows, but no longer on a computer started-up in MS-DOS only mode
 

 Back to the table of programs

       

       

       

VIEWM

VIEWer for Miscellaneous FTMW spectra

        This program views spectra in an archive created with FM. The principal options are:

  • selection from among the available archives or display of all unarchived spectra found in the current directory
  • initial summary screen of interferogram intensities as a function of frequency
  • scrollable main summary screen of the appearance of nine neighbouring interferograms at a time
  • display of each individual interferogram/its FFT with options for tailoring the FFT conditions, scrolling, peak measurement and ASCII dumps of data for PostScript plots with gle
 
  Current version
V6.FOR Listing of the current version, which has been extensively rewritten for compilation with CVF6
V6.EXE The executable from compilation with CVF6.5, for 800x600 pixel graphics and
  1. up to 500 spectral files
  2. up to 850 points in each interferogram
  Legacy versions
V32.FOR The listing of the last version prior to CVF6 - no longer supported.
V32.EXE Standard version of the above (MSPS1, VGA graphics), limits:
  1. 500 spectral files
  2. 850 points in each interferogram
V324.EXE MSPS4 version, dimensioning as for V32
VIEWM.FOR First part of listing for MSF5 compilation
VIEWM1.FOR Second part of listing for MSF5 compilation, compile separately, then link.
VIEWM.EXE Small version for operation in low DOS memory (MSF5, VGA graphics) with decreased limits of
  1. 70 spectral files
  2. 400 points in each interferogram
 

 Back to the table of programs

       

       

       

VIEWF

VIEWer for FTMW spectral Files in the current directory

        This program views spectral files in the current directory - mainly for use on freshly recorded spectra prior to archiving. No longer needed, unless for very tiny computers, since the same capabilities are now built into VIEWM.

 
VIEWF.FOR The listing - uses Microsoft graphics and is set for simplest compilation: MSF5 and execution in lower memory.
VIEWF.EXE MSF5 executable for VGA graphics only.
 

Back to the table of programs

       

       

       

VKIEL

Viewer for KIEL FTMW spectral files in the current directory

        This program views FTMW files in the current directory that have been recorded in one of the two standards encountered in Kiel:

  • MWFTSBI 1.0 of the X/P band waveguide spectrometer
  • FTMW2.x of the K-band waveguide spectrometer

        The program reads all interferograms in the selected directory, provides an overview of their coverage, and allows easy access to each interferogram. The available processing options are:

  • FFT with zero-filling up to 64k points using the spctrm routine, which gives better resolution and less distortion in the frequency spectrum than realft - see comparison1 and comparison2
  • Amplitude and power spectra
  • Easy scrollability and measurement of the frequency-domain spectrum
  • Optimisation of the FFT by several filtering options in the time-domain, and user selection of points subjected to the FFT - see the effects on the right hand side of comparison1
  • gle output for PostScript diagrams
  • Flexible combination of interferograms into a single synthetic spectrum with user configurable options. The spectrum can then be inspected/processed further with SVIEW. The interferograms can be the result of a scan, such as that made with MWFTSBI but this is not mandatory.
 
VKIEL.FOR The listing, intended for CVF6 compilation.
VKIEL.EXE The executable for Win32 systems and any Pentium processor. Compiled to read up to 1000 FTMW files, each up to 4096 points long.

Program startup, do any one of:

  1. Call the program from the command line set to the directory containing the data, assuming the PATH leads to the directory containing VKIEL.EXE
  2. Launch the program from an icon on the desktop
  3. Launch the program from any file manager

Only method 1/ assures that the program will operate directly on the directory of choice. In methods 2/ and 3/ the starting directory depends on the operating system and previous usage. It might be necessary to navigate to the directory with spectra using the SelectFile window obtained by pressing the ESC key while in the title screen.

VKIEL.CFG Optional configuration file for VKIEL, which has to reside in the directory C:\FFT. If this file is not used then the program defaults to window size of 800x540 pixels.

The use of VKIEL.CFG and istallation of VKIEL are analogous to those described for SVIEW.CFG, with the difference that the directory is to be C:\FFT instead of C:\ROT.

 

Back to the table of programs