![[IUCr Home Page]](html_graphics/iucrhome.jpg)
-
+![[CIF Home Page]](html_graphics/cifhome.jpg)
-
+
-
+
+|
-
+ |
+
-
+ |
-
+ |
+ |
@@ -35,7 +44,9 @@
README
-Information for CBFlib 0.7.9.1 release of 24 January 2008
+Information for CBFlib 0.9.2 release of 12 February 2011
+revised as the CBFlib 0.9.2.1 release of 20 June 2011
+revised as the CBFlib 0.9.2.2 release of 2 July 2011
-© Copyright 2006, 2007, 2008 Herbert J. Bernstein +© Copyright 2006, 2007, 2008, 2010, 2011 Herbert J. Bernstein
+CBFlib 0.9.2.2 is a minor revision to the CBFlib 0.9.2.1 release +in July 2011 to update doc/cif_img.dic to the 1.6.4 revision. +
+CBFlib 0.9.2.1 is a minor revision to the CBFlib 0.9.2 release +in June 2011 to upgrade the setup script for the pycbf Python +bindings to simplify using pycbf outside the context of +the CBFlib pycbf directory. +
+CBFlib 0.9.2 is the recommended release of CBFlib of February 2011. +The commulative changes in releases 0.9.1 and 0.9.2 since CBFlib 0.9.0 +are: +
+CBFlib 0.9.1 included a correction to CBFlib 0.9.0 to make axis +the cbf_simple routines apply axis rotations correctly for detectors and to +pick up corrections for byte offet compression incorporated into the upcoming +CBFlib 0.9.1 release. The earlier version had failed to apply the rotations +to the accumulated displacements. +Our thanks to Joerg Kaercher of Bruker-AXS for identifying the rotation +problem. +
+CBFlib 0.9.0 was a partial pre-release of CBFlib version 0.8 needed to support +changes in RasMol. This release was incomplete and used were advided to use it with caution, +but it has proven to be a reliable, stable release for 2 years. +There have been significant changes in the input/output logic and in validation. +For a ChangeLog consult the SVN of the CBFlib project on sourceforge.
CBFLIB is a library of ANSI-C functions providing a simple mechanism for accessing Crystallographic Binary Files (CBF files) and Image-supporting @@ -102,30 +151,34 @@ CBFLIB should be built on a disk with at least 350 megabytes of free space, for a full installation with complete tests. Read the instructions below carefully, if space is a problem. -
-CBFlib_0.7.9.tar.gz is a "gzipped" -tar of the code as it now stands. +
+A gizpped tarball of this release is available on sourceforge at +
+http://downloads.sf.net/cbflib/CBFlib-0.9.2.2.tar.gz +
In addition, -CBFlib_0.7.9_Data_Files_Input.tar.gz +http://downloads.sf.net/cbflib/CBFlib_0.9.2_Data_Files_Input.tar.gz (13 MB) is a "gzipped" tar of the input data files needed to test the API, -CBFlib_0.7.9_Data_Files_Output.tar.gz +http://downloads.sf.net/cbflib/CBFlib_0.9.2_Data_Files_Output.tar.gz (34 MB) is a "gzipped" tar of the output data files needed to test the API, and, if space is at a premium, -CBFlib_0.7.9_Data_Files_Output_Sigs_Only.tar.gz +http://downloads.sf.net/cbflib/CBFlib_0.9.2_Data_Files_Output_Sigs_Only.tar.gz (1KB) is a "gzipped" tar of only the MD5 signatures of the output data files needed to test the API. -Place the CBFlib_0.7.9.tar.gz file in the directory +Place the CBFlib_0.9.2.2.tar.gz file in the directory that is intended to contain up to 4 new directories, named -CBFlib_0.7.9 (the "top-level" directory), -CBFlib_0.7.9_Data_Files_Input and either CBFlib_0.7.9_Data_Files_Output or CBFlib_0.7.9_Data_Files_Output_Sigs_Only. +CBFlib_0.9.2.2 (the "top-level" directory), +CBFlib_0.9.2_Data_Files_Input and either CBFlib_0.9.2_Data_Files_Output or +CBFlib_0.9.2_Data_Files_Output_Sigs_Only. If you have wget on your machine, you only need to download the source tarball. If you do not have wget, you will need to download all the tarballs into the same directory
-Uncompress CBFlib_0.7.9.tar.gz with gunzip and unpack it with tar: +Uncompress CBFlib_0.9.2.tar.gz with gunzip and unpack it with tar:
- gunzip CBFlib_0.7.9.tar.gz - tar xvf CBFLIB_0.7.9.tar + gunzip CBFlib_0.9.2.tar.gz + tar xvf CBFLIB_0.9.2.tar
To run the test programs, you will also need @@ -137,7 +190,7 @@ is a PDB mmCIF file, 9ins.cif, and 3 special test files testflatin.cbf, testflatpackedin.cbf and testrealin.cbf. All these files will be -dowloaded and extracted by the Makefile from CBFlib_0.7.9_Data_Files_Input. Do +dowloaded and extracted by the Makefile from CBFlib_0.9.2_Data_Files_Input. Do not download copies into the top level directory.
After unpacking the archives, the top-level directory should contain @@ -163,11 +216,10 @@
-
and additional Makefiles for other systems. All the makefiles are created from -m4/Makefile.m4. The current set of Makefiles are Makefile_LINUX, Makefile_LINUX_gcc42, -Makefile_OSX, Makefile_OSX_gcc42, Makefile_AIX and Makefile_MINGW. Edit the -closest approximation to your system, and then copy that variant to Makefile. - +
+and additional Makefiles for other systems. All the makefiles are created from +m4/Makefile.m4. Edit the closest approximation to your system, and then copy that variant to Makefile. +
For instructions on compiling and testing the library, go to the top-level directory and type: @@ -187,14 +239,14 @@
make tests_sigs_only
-
+
Please refer to the manual doc/CBFlib.html for more detailed information.