1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
|
<!doctype html public "-//IETF//DTD HTML 2.0//EN">
<HTML>
<HEAD>
<TITLE>
CBFlib
</TITLE>
</HEAD>
<BODY BACKGROUND="html_graphics/cbflibbackground.jpg">
<a href="http://www.iucr.org/iucr-top/welcome.html">
<img alt="[IUCr Home Page]" src="html_graphics/iucrhome.jpg"></a>
<a href="http://www.iucr.org/iucr-top/cif/home.html">
<img alt="[CIF Home Page]" src="html_graphics/cifhome.jpg"></a>
<A HREF="doc/cbf_definition_rev.html"><IMG SRC="html_graphics/CBFbutton.jpg"
ALT="[CBF/imgCIF]"></A>
<A HREF="doc/CBFlib.html"><IMG SRC="html_graphics/cbflibbutton.jpg"
ALT="[CBFlib]"></A>
<hr>
<CENTER>
| <a href="http://www.iucr.org/iucr-top/welcome.html">IUCr Home Page</a>
| <a href="http://www.iucr.org/iucr-top/cif/home.html">CIF Home Page</a>
| <A HREF="doc/cbf_definition_rev.html">CBF/imgCIF</a>
| CBFlib
|<br />
| <A HREF = "doc/CBFlib_NOTICES.html">NOTICE</A>
| <a href=gpl.txt>doc/GPL</a>
| <a href=lgpl.txt>doc/LGPL</a>
| <a href="doc/cif_img_1.5.4.html">imgCIF dictionary</a>
|<br />
| <a href="http://arcib.dowling.edu/donation.shtml">Click Here to Make a Donation</a>
|<P>
<IMG SRC="html_graphics/cbflibbig.jpg" ALT="CBFlib">
</CENTER>
<font color="#0808A0">
<H2 ALIGN=CENTER>README</H2>
<H3 ALIGN=CENTER>
Information for CBFlib 0.7.9.1 release of 24 January 2008<BR>
</H3>
</font><font color="#000000">
<CENTER>
by<BR>
Paul J. Ellis<BR>
Stanford Synchrotron Radiation Laboratory<BR>
<P>
and<BR>
Herbert J. Bernstein<BR>
Bernstein + Sons<BR>
<script language="javascript" type="text/javascript">
<!--
var name = "yaya";
var domain = "bernstein-plus-sons";
var domext = "com";
document.write ("<a href=\"mailto:" + name + "@" + domain + "." domext + "\">" + name + " <b>at</b> " + domain + " <b>dot</b> "+ domext+"</a>");
// -->
</script>
<noscript>
yaya <b>at</b> bernstein-plus-sons <b>dot</b> com
</noscript>
<p>
© Copyright 2006, 2007, 2008 Herbert J. Bernstein
<P>
<hr>
<b>YOU MAY REDISTRIBUTE THE CBFLIB PACKAGE UNDER THE TERMS OF THE <a href=doc/gpl.txt>GPL</a>.
<P>
ALTERNATIVELY YOU MAY REDISTRIBUTE THE CBFLIB API UNDER THE TERMS
OF THE <a href=doc/lgpl.txt>LGPL<a/>.</b>
</CENTER>
<HR>
<H3 ALIGN=CENTER>
Before using this software, please read the <BR>
<A HREF = "doc/CBFlib_NOTICES.html"> <IMG SRC="html_graphics/noticeButton.jpg"
ALT="NOTICE"></A><BR>
for important disclaimers and the IUCr Policy
on the Use of the Crystallographic Information File (CIF) and other important
information.
</h3>
<P>
Work on imgCIF and CBFlib supported in part by the U. S. Department of Energy (DOE)
under grants ER63601-1021466-0009501 and ER64212-1027708-0011962, by the
U. S. National Science Foundation (NSF) under grants DBI-0610407, DBI-0315281 and
EF-0312612, the U. S. National Institutes of Health (NIH) under grants 1R15GM078077
from NIGMS and 1R13RR023192 from NCRR and funding from the International
Union for Crystallography (IUCr). The content is solely the responsibility of
the authors and does not necessarily represent the official views of
DOE, NSF, NIH, NIGMS, NCRR or IUCr.
<P>
<HR>
<P>
CBFLIB is a library of ANSI-C functions providing a simple mechanism for
accessing Crystallographic Binary Files (CBF files) and Image-supporting
CIF (imgCIF) files. The CBFLIB API is loosely based on the CIFPARSE API
for mmCIF files. Starting with this release, CBFLIB performs validation
checks on reading of a CBF. If a dictionary is provided, values will
be validated against dictionary ranges and enumerations. Tags
missing under parent-child relationships or category key requirements
will be reported. CBFlib provides functions to create, read, modify
and write CBF binary data files and imgCIF ASCII data files.
<P>
<H3>Installation</H3>
<P>
CBFLIB should be built on a disk with at least 350 megabytes of free
space, for a full installation with complete tests. <b>Read the
instructions below carefully, if space is a problem.</b>
<P>
<A HREF="../CBFlib_0.7.9.tar.gz">CBFlib_0.7.9.tar.gz</A> is a "gzipped"
tar of the code as it now stands.
<P>
In addition,
<A HREF="http://arcib.dowling.edu/software/CBFlib/downloads/version_0.7.9/CBFlib_0.7.9_Data_Files_Input.tar.gz">CBFlib_0.7.9_Data_Files_Input.tar.gz</a>
(13 MB) is a "gzipped" tar of the input data files needed to test the API,
<A HREF="http://arcib.dowling.edu/software/CBFlib/downloads/version_0.7.9/CBFlib_0.7.9_Data_Files_Output.tar.gz">CBFlib_0.7.9_Data_Files_Output.tar.gz</a>
(34 MB) is a "gzipped" tar of the output data files needed to test the API, and, if space is at a premium,
<A HREF="http://arcib.dowling.edu/software/CBFlib/downloads/version_0.7.9/CBFlib_0.7.9_Data_Files_Output_Sigs_Only.tar.gz">CBFlib_0.7.9_Data_Files_Output_Sigs_Only.tar.gz</a>
(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
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.
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
<p>
Uncompress CBFlib_0.7.9.tar.gz with gunzip and unpack it with tar:
<p>
<PRE>
gunzip CBFlib_0.7.9.tar.gz
tar xvf CBFLIB_0.7.9.tar
</PRE>
<p>
To run the test programs, you will also need
Paul Ellis's sample MAR345 image,
example.mar2300,
Chris Nielsen's sample ADSC Quantum 315 image,
mb_LP_1_001.img, and Eric Eikenberry's SLS sample Pilatus 6m image,
insulin_pilatus6m, as sample data. In addition there are
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
not download copies into the top level directory.
<P>
After unpacking the archives, the top-level directory should contain
a makefile:
<p>
<TABLE ALIGN=CENTER>
<TR><TD> Makefile<TD> Makefile for unix
</TABLE>
<p>
and the subdirectories:
<p>
<TABLE ALIGN=CENTER>
<TR><TD> src/<TD> CBFLIB source files
<TR><TD> include/<TD> CBFLIB header files
<TR><TD> <TD>
<TR><TD> bin/<TD> Executable example programs
<TR><TD> doc/<TD> Documentation
<TR><TD> examples/<TD> Example program source files
<TR><TD> html_images/<TD> JPEG images used in rendering the HTML files
<TR><TD> lib/<TD> Compiled CBFLIB (libcbf.a) and FCBLIB (libfcb.a) libraries
<TR><TD> m4/<TD> CBFLIB m4 macro files (used to build .f90 files)
<TR><TD> mswin/<TD> An MS Windows CodeWarrior project file
<TR><TD> pycbf/<TD> Jon Wright's Python bindings
</TABLE>
<p>
<p>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.
For instructions on compiling and testing the library, go to
the top-level directory and type:
<p>
<PRE>
make
</PRE>
<p>
Once you have a properly configure Makefile, compile and test the package
with
<p>
<PRE>
make tests
</PRE>
<p>
or, if space is at a premium, with
<PRE>
make tests_sigs_only
</PRE>
<P>
Please refer to the manual <a HREF="doc/CBFlib.html">doc/CBFlib.html</a>
for more detailed information.<HR>
<HR>
Updated 30 December 2007.
<script language="javascript" type="text/javascript">
<!--
var name = "yaya";
var domain = "bernstein-plus-sons";
var domext = "com";
document.write ("<a href=\"mailto:" + name + "@" + domain + "." domext + "\">" + name + " <b>at</b> " + domain + " <b>dot</b> "+ domext+"</a>");
// -->
</script>
<noscript>
yaya <b>at</b> bernstein-plus-sons <b>dot</b> com
</noscript>
</font>
</BODY>
</HTML>
|
