Fits2mix

From UA Libraries Digital Services Planning and Documentation
Jump to: navigation, search

A version of the [fits2mix script] is provided open source under the [Creative Commons Attribution 3.0 Unported license]. This means that you are free:

  1. to share -- to copy, distribute and transmit the work
  2. to remix --to adapt the work
  3. Under the following conditions:
  4. attribution -- You must attribute the work in the manner specified by the author or licensor
  5. (but not in any way that suggests that they endorse you or your use of the work).

This script will run FITS on TIFF files provided, and then generate MIX files, using information provided from the results of the FITS script. It is written on Linux, and would require modifications to run on Windows.

If the TIFF is not well formed, is not valid, or is not actually a TIFF, this will be noted (with any other errors) in the error file (written to a local output directory), and the file will be copied into a repairMe directory (generated by the script. Additionally, the temporary fits/mix file will be copied to a "fitsTest" subdirectory there for reference, so you can see what the errors were. For these problem files, the final FITS and MIX files will not be generated.

Other errors noted by the FITS script will be included in the error file. Many are not serious. Documentation on most of the ones we have encountered can be found in Known_FITS_errors.

To use

Replace the .txt extension with .pl, and modify the first line to point to PERL on your system. Change permissions to 755 (for executables; example: "chmod 755 fits2mix.pl"). The script expects TIFF files in a "tiffs" sub-directory, and the installation of FITS on your system.

The script expects 2 arguments on the command line: the path to the fits.sh script and the name of the image producer (usage: fits2mix.pl fitsScript producer). For example:

  fits2mix.pl   /srv/scripts/preservation/fits-0.8.4/fits.sh  The University of Alabama Libraries

Example FITS and MIX Files

The following example FITS and MIX files were generated from some of our TIFFs.


FITS files:

MIX files:

Questions?

Contact Jody DeRidder.

Personal tools