History of Changes for LIGOtools Package: Fr

Version v4r22

Version v4r22a

• No changes in the Fr code itself.
• Modified Makefile so that FrIO.h ends up in $LIGOTOOLS/include. It was missing in version v4r22, preventing the user from being able to compile a program.
• Discovered that the ROOT-enabled shared-object library cannot be used except within ROOT. Therefore, I changed things so that the ROOT-enabled shared object is now called libFrameROOT.so. There is still a file called libFrame.so, which is now the ordinary shared-object library which can be linked to by a user program.
• Fixed the logic in the Makefile which checks whether the Matlab mex compiler is present. This was causing make to abort on systems where mex was not present.

Version v4r30

Version v4r31

• New version of the Frame Library (with fairly minor changes) from Benoit.
  • Fixed bug which affected static data.
  • Added some optional arguments to ROOT macro 'FrVP'.
• New utility 'FrSplit' from Greg Mendell.
• New Matlab MEX-file 'mkframe' from Sam Finn.
• Now can get help about frextract and frgetvect from within Matlab, by typing 'help frextract' or 'help frgetvect'.

Version v4r31a

• Still uses frame library v4r31, but with an "unofficial" modification from Benoit to allow the input tag to work with any number of input files. (Previously, it only worked with one input file.)
• New 'FrameDataDump' utility from Chris Hawkins.
• FrSplit modified by PSS to allow output files to be compressed. Previously, output files were always uncompressed; now, the default is to keep the same compression as the input, but this can be overridden with a command-line option. Also, output filenames now use same prefix as input; previously, it was hard-coded to always be "H-".
• Fixed up the Makefile to build properly on a system where the LIGOtools 'root' package is missing. Also some modifications to better control what is echoed to the screen while building.
• Modified FrLogon.C to give the full explicit path to the libFrameROOT.so shared-object library. This should help avoid problems/confusion related to LD_LIBRARY_PATH.

Version v4r31b

• Fixed a bug that occurred when starting up the LIGOtools version of root. (Tried to load the libFrameROOT.so shared object using an incorrect absolute path.)
• New version of FrameDataDump from Chris Hawkins. You can now omit the -N parameter, in which case the whole file will be processed.

Version v4r40

• New version of the frame library from Benoit. Includes:
  • New utility FrCheck

Version v4r41

New version of the frame library from Benoit.

Version v4r41mex (Linux only)

I am now able to compile Matlab MEX-files for Linux, so this is a re-release for Linux which includes the frextract, frgetvect, and mkframe MEX-files. On Solaris, these MEX-files are already included in version v4r41.

Version v4r41n

In version v4r41/v4r41mex, the ROOT-loadable shared object library was not built successfully due to a bug in the Cint interpreter that is used during the build process. I have fixed that for this new release of the Fr package, which now includes a ROOT-loadable shared object library built using ROOT version 3.02.07. Otherwise, there have been no changes.

Version v4r52

New version of the frame library from Benoit. This version fixes the problem with frame files created on a little-endian (e.g. Linux) machine having the wrong byte-ordering indication, which caused them to be unreadable by LDAS.

Version v6r00

New major version of the frame library from Benoit. This version now writes frames in the recently-ratified version 6 format (which used to be called the version 5 format). It also is able to read "version 5" frames currently being written by LDAS, but only sequentially, not using the table of contents.

Version v4r53mod

A step back from version-6 frames until other software can be brought up to date. This special version of the frame library is based on the last version-4 release, with modifications so that it can read LDAS version-5 frames, with the same restriction as v6r00: it can only read them sequentially, not using the table of contents. It always writes version-4 frames, which all other software can read.

To support reading resampled data from LDAS RDS frames into Matlab, the frextract MEX-file has been modified so that it will find either raw ADC data or processed (e.g. resampled) data matching the channel name specified by the user.

Version v6r02

Now that LDAS writes out all frames files using version 6 of the frame format, we return to the v6* series.

As had been done for v4r53mod, Benoit has modified frextract so that it will now find either raw ADC data or processed (e.g. resampled) data matching the channel name specified by the user.

Version v6r06

Latest version from Benoit.

Now built with the "-static-libgcc" flag, so it should run even on machines which do not have gcc 3.x installed. (WRONG!)

Version v6r08

Latest version from Benoit. Among other things, fixes a bug in the conversion of the detector geometry values when reading from version-4 frame files.

The binary distribution files are now built using gcc 2.25. This avoids missing-shared-object-library problems encountered by some people when the binary builds were done using gcc 3.x.

New utilities FrGeomDump, FrChannels, FrFileRanges.

Version v6r11

Latest version from Benoit.

frextract and frgetvect have been modified to be able to read complex vectors (single- or double-precision) as well as 8-byte integer vectors (signed or unsigned).

The Solaris binary version was built on fortress using gcc 2.95.2.

The Linux binary version was built on m27 (which is now running Red Hat 9) using gcc 2.96, by prepending /home/pshawhan/gcc296redirect to my PATH.

Version v6r12

Latest version from Benoit, with some bug fixes. The copies of frextract and frgetvect in the official distribution now are able to read complex values into Matlab.

Note that some function names have changed! See the end of the html documentation for details.

Version v6r15

Latest version of the core distribution from Benoit. Among other things, there is a new header file, FrFilter.h.

Important organizational change: the LIGOtools 'Fr' package now includes ONLY the core distribution. All extra utilities related to frame reading have been moved into a new 'FrContrib' package.

Clearer warning message if unable to build the mex-files.

New mechanism for construction the distribution files from the CVS workspace.

Version v6r19

Uses latest version of frame library. Release prepared by Shourov Chatterji.

Release compatibility notes:

• The Solaris version was built for Solaris 8 and Matlab R13. A few simple tests indicate that they also work on Solaris 9 and Matlab R14.
• The Linux version was built for Fedora Core 3 and Matlab R13. A few simple tests indicate that they also work for Red Hat 9 and Matlab R14. However, any error raised by frgetvect cause Matlab R14 to abort.
• No Darwin binary version is included in this release.

Version v6r24

Uses latest version of frame library. Release prepared by Shourov Chatterji. Included patch for frgetvect mex function to produce warnings instead of errors. This avoids a segfault causing the Matlab session to terminate.

Release compatibility notes:

• The Solaris version was built for Solaris 8 and Matlab r13.
• The Linux version was built for 32 bit Fedora Core 4 and Matlab r13, but also includes mex files for 64 bit Fedora Core 4 and Matlab r2007a.
• No Darwin binary version is included in this release.
• Binary packages are also being provided for a variety of combinations of machine architecture and Matlab version. These must be downloaded manually and then installed using ligotools_install.

Version v8r04

Uses latest version of frame library. Also added a new script, 'make_myfrgetvect', to make it easy for users to build their own copies of the MEX-file.

Version v8r08

Uses latest version of frame library.