$ README file explaining the ftp files for Azara. $

	Azara, v2.8, copyright (C) 1993-2010 Wayne Boucher
	and Department of Biochemistry, University of Cambridge.

$<H1>$
README file explaining the ftp files for Azara.
$</H1>$
$<PRE>$
Date file created:  10 Oct 1994
Date last updated:  30 Mar 2010

WWW address:
	http://www.ccpn.ac.uk/azara

Download address:
	http://www.ccpn.ac.uk/download/azara

e-mail address (bugs, etc.):
	azara@bioc.cam.ac.uk

snail mail address (license, etc.):
	Azara
	c/o Dr. Wayne Boucher
	Department of Biochemistry
	Tennis Court Road
	Cambridge CB2 1QW
		England

Azara is a suite of programs to process and view NMR data.
See the LICENSE for the terms and conditions of use.

The problem of support still needs to be worked out, but
one statement definitely holds:  no LICENSE, no support.

$<PRE>$
Release 1.0-0:  10 Oct 1994
Release 1.0-1:  26 Nov 1994
Release 1.0-2:  04 Feb 1995
Release 1.0-3:  22 May 1995
Release 2.0-0:  23 Nov 1996
Release 2.5-0:  15 May 2001
Release 2.6-0:  15 Nov 2001
Release 2.7-0:  30 Oct 2002
Release 2.8-0:  07 Apr 2010
$</PRE>$

The download directory contains the following files:
$<PRE>$

README-2.8			this file
LICENSE				the license
azara-2.8-src.tgz		source code
azara-2.8-linux32.tgz		source code and 32-bit Linux executables
azara-2.8-linux64.tgz		source code and 64-bit Linux executables
azara-2.8-osx10.6.tgz		source code and OSX 10.6 executables
azara-2.0-scripts.tar.gz	sample script files
CHANGES-1.0-1			changes from release 1.0-0 to 1.0-1
CHANGES-1.0-2			changes from release 1.0-1 to 1.0-2
CHANGES-1.0-3			changes from release 1.0-2 to 1.0-3
CHANGES-2.0-0			changes from release 1.0-3 to 2.0-0
CHANGES-2.5-0			changes from release 2.0-0 to 2.5-0
CHANGES-2.6-0			changes from release 2.5-0 to 2.6-0
CHANGES-2.7-0			changes from release 2.6-0 to 2.7-0
CHANGES-2.8-0			changes from release 2.7-0 to 2.8-0

$</PRE>$
The Azara 'release' is considered to be one of the tar files,
azara-2.8*.tgz.

The executables are compiled for both Linux and OSX computers.
If you are using another operating system then you will certainly
need to re-compile the programs.  In the past the code has been
successfully compiled on IRIX and Sun computers, and the
non-graphical programs have been ported successfully to Windows.

See the file INSTALL in the release for more details.

The sample script files were put together by Bill Broadhurst
of the Department of Biochemistry, University of Cambridge.
The Ansig peak picking macros were written by Colin Hardman
of the Department of Biochemistry, University of Cambridge.
Many thanks to them for putting these files together, and for
allowing them to be placed with this release.

Finally, a quick guide to the programs currently available.
[Motif] means that the Motif and X libraries are needed to
compile the program, and an X server is needed to run it.

process:
	A general multi-dimensional NMR processing program.
	It can be used just to convert unblocked data to
	blocked data, for use in the other programs.

plot2:  [Motif]
	Allows contouring and viewing of (2-dimensional) planes
	from one or more data files, with hardcopy output also
	available.  Also allows (approximate) phasing of
	(1-dimensional) slices (rows or columns) of the planes.

plot1:  [Motif]
	Allows processing and viewing of 1-dimensional data,
	with 'real-time' control over arbitrary parameters.
	Hardcopy output is also available.

contours:
	Contours (two-dimensional) planes from multi-dimensional
	data.  The contours are output in a format suitable for
	use by Per Kraulis' program Ansig.

connect:
	Takes a shift file and a crosspeak file and matches
	the crosspeaks to one or more pairs of shifts.
	Creates output suitable for Xplor/CNS.

peak_find:
	Finds extrema in a spectrum, and optionally allows a
	simple parabolic fit of the extrema centers.

peak_fit :
	Fits extrema (magnitude, phase, center and linewidth) in
	a spectrum using process scripts.

combine:
	Combines two or more separate data sets, e.g. by
	adding them together.  Only a couple of combining
	functions are currently defined.

project:
	Projects multi-dimensional data onto chosen dimensions.
	It can also be used to permute the ordering of the
	dimensions of data.  In particular, any 2 dimensions
	of a multi-dimensional data file can be transposed.

extract:
	Extracts (hyper)planes from multi-dimensional data.
	Useful for testing 'process' on smaller data sets.

deflate:
	Compresses data by zeroing all data below a specified
	level (in absolute value), and then using 'run-length'
	encoding.  Can be used as input to Per Kraulis'
	program Ansig.

reflate:
	Uncompresses data compressed using 'deflate'.

unblock:
	Converts blocked data to unblocked (i.e., sequential)
	data.  This provides a possible route to importing
	data into other programs.

And there is a Python module, in the DataRows directory, providing
access to blocked data files a row at a time.
$</PRE>$