Debian Codegraph @

doc/cif_img_1.5.3_8Jul07.html

raw
1 <HTML>
2 <HEAD>
3 <TITLE>cif_img.dic v1.5_DRAFT</TITLE>
4 </HEAD>
5 <body bgcolor="#FAFAFF" text="#0808A0"
6 BACKGROUND="../html_graphics/cbflibbackground.jpg">
7 <font color="#0808A0">
8 <H1>
9 # <a href="http://www.iucr.org/iucr-top/welcome.html">
10 <img alt="[IUCr Home Page]" src="../html_graphics/iucrhome.jpg" ALIGN=MIDDLE></a>
11 <a href="http://www.iucr.org/iucr-top/cif/home.html">
12 <img alt="[CIF Home Page]" src="../html_graphics/cifhome.jpg" ALIGN=MIDDLE></a>
13 <a href="cbf_definition_rev.html"><IMG SRC="../html_graphics/CBFbutton.jpg"
14 ALT="[CBF/imgCIF]" ALIGN=MIDDLE></a>
15 <a href="CBFlib.html"><IMG SRC="../html_graphics/cbflibbutton.jpg"
16 ALT="[CBFlib]" ALIGN=MIDDLE></a> #
17 </H1>
18 <H1 ALIGN=CENTER>
19 # <IMG SRC="../html_graphics/CBFbig.jpg" ALIGN=MIDDLE ALT="imgCIF/CBF"> #
20 </H1>
21 <H1 ALIGN=CENTER># Extensions Dictionary #</H1>
22 </font><font color="#000000">
23
24 <PRE>
25 ##############################################################################
26 # #
27 # Image CIF Dictionary (imgCIF) #
28 # and Crystallographic Binary File Dictionary (CBF) #
29 # Extending the Macromolecular CIF Dictionary (mmCIF) #
30 # #
31 # Version 1.5.3 #
32 # of 2007-07-08 #
33 # ################################################################### #
34 # # *** WARNING *** THIS IS A DRAFT FOR DISCUSSSION *** WARNING *** # #
35 # # SUBJECT TO CHANGE WITHOUT NOTICE # #
36 # # SEND COMMENTS TO [email protected] CITING THE VERSION # #
37 # ################################################################### #
38 # This draft edited by H. J. Bernstein #
39 # #
40 # by Andrew P. Hammersley, Herbert J. Bernstein and John D. Westbrook #
41 # #
42 # This dictionary was adapted from format discussed at the imgCIF Workshop, #
43 # held at BNL Oct 1997 and the Crystallographic Binary File Format Draft #
44 # Proposal by Andrew Hammersley. The first DDL 2.1 Version was created by #
45 # John Westbrook. This version was drafted by Herbert J. Bernstein and #
46 # incorporates comments by I. David Brown, John Westbrook, Brian McMahon, #
47 # Bob Sweet, Paul Ellis, Harry Powell, Wilfred Li, Gotzon Madariaga, #
48 # Frances C. Bernstein, Chris Nielsen, Nicola Ashcroft and others. #
49 ##############################################################################
50
51 data_cif_img.dic
52
53 _dictionary.title cif_img.dic
54 _dictionary.version 1.5.3
55 _dictionary.datablock_id cif_img.dic
56
57 ##############################################################################
58 # CONTENTS
59 #
60 # <a href="#CATEGORY_GROUP_LIST">CATEGORY_GROUP_LIST</a>
61 # <a href="#SUB_CATEGORY">SUB_CATEGORY</a>
62 #
63 # category <a href="#ARRAY_DATA">ARRAY_DATA</a>
64 #
65 # <a href="#_array_data.array_id" >_array_data.array_id</a>
66 # <a href="#_array_data.binary_id" >_array_data.binary_id</a>
67 # <a href="#_array_data.data" >_array_data.data</a>
68 # <a href="#_array_data.header_contents" >_array_data.header_contents</a>
69 # <a href="#_array_data.header_convention" >_array_data.header_convention</a>
70 #
71 # category <a href="#ARRAY_ELEMENT_SIZE">ARRAY_ELEMENT_SIZE</a>
72 #
73 # <a href="#_array_element_size.array_id" >_array_element_size.array_id</a>
74 # <a href="#_array_element_size.index" >_array_element_size.index</a>
75 # <a href="#_array_element_size.size" >_array_element_size.size</a>
76 #
77 # category <a href="#ARRAY_INTENSITIES">ARRAY_INTENSITIES</a>
78 #
79 # <a href="#_array_intensities.array_id" >_array_intensities.array_id</a>
80 # <a href="#_array_intensities.binary_id" >_array_intensities.binary_id</a>
81 # <a href="#_array_intensities.gain" >_array_intensities.gain</a>
82 # <a href="#_array_intensities.gain_esd" >_array_intensities.gain_esd</a>
83 # <a href="#_array_intensities.linearity" >_array_intensities.linearity</a>
84 # <a href="#_array_intensities.offset" >_array_intensities.offset</a>
85 # <a href="#_array_intensities.scaling" >_array_intensities.scaling</a>
86 # <a href="#_array_intensities.overload" >_array_intensities.overload</a>
87 # <a href="#_array_intensities.undefined_value" >_array_intensities.undefined_value</a>
88 # <a href="#_array_intensities.pixel_fast_bin_size" >_array_intensities.pixel_fast_bin_size</a>
89 # <a href="#_array_intensities.pixel_slow_bin_size" >_array_intensities.pixel_slow_bin_size</a>
90 # <a href="#_array_intensities.pixel_binning_method" >_array_intensities.pixel_binning_method</a>
91 #
92 # category <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a>
93 #
94 # <a href="#_array_structure.byte_order" >_array_structure.byte_order</a>
95 # <a href="#_array_structure.compression_type" >_array_structure.compression_type</a>
96 # <a href="#_array_structure.compression_type_flag" >_array_structure.compression_type_flag</a>
97 # <a href="#_array_structure.encoding_type" >_array_structure.encoding_type</a>
98 # <a href="#_array_structure.id" >_array_structure.id</a>
99 #
100 # category <a href="#ARRAY_STRUCTURE_LIST">ARRAY_STRUCTURE_LIST</a>
101 #
102 # <a href="#_array_structure_list.axis_set_id" >_array_structure_list.axis_set_id</a>
103 # <a href="#_array_structure_list.array_id" >_array_structure_list.array_id</a>
104 # <a href="#_array_structure_list.dimension" >_array_structure_list.dimension</a>
105 # <a href="#_array_structure_list.direction" >_array_structure_list.direction</a>
106 # <a href="#_array_structure_list.index" >_array_structure_list.index</a>
107 # <a href="#_array_structure_list.precedence" >_array_structure_list.precedence</a>
108 #
109 # category <a href="#ARRAY_STRUCTURE_LIST_AXIS">ARRAY_STRUCTURE_LIST_AXIS</a>
110 #
111 # <a href="#_array_structure_list_axis.axis_id" >_array_structure_list_axis.axis_id</a>
112 # <a href="#_array_structure_list_axis.axis_set_id" >_array_structure_list_axis.axis_set_id</a>
113 # <a href="#_array_structure_list_axis.angle" >_array_structure_list_axis.angle</a>
114 # <a href="#_array_structure_list_axis.angle_increment" >_array_structure_list_axis.angle_increment</a>
115 # <a href="#_array_structure_list_axis.displacement" >_array_structure_list_axis.displacement</a>
116 # <a href="#_array_structure_list_axis.fract_displacement" >_array_structure_list_axis.fract_displacement</a>
117 # <a href="#_array_structure_list_axis.displacement_increment" >_array_structure_list_axis.displacement_increment</a>
118 # <a href="#_array_structure_list_axis.fract_displacement_increment" >_array_structure_list_axis.fract_displacement_increment</a>
119 # <a href="#_array_structure_list_axis.angular_pitch" >_array_structure_list_axis.angular_pitch</a>
120 # <a href="#_array_structure_list_axis.radial_pitch" >_array_structure_list_axis.radial_pitch</a>
121 # <a href="#_array_structure_list_axis.reference_angle" >_array_structure_list_axis.reference_angle</a>
122 # <a href="#_array_structure_list_axis.reference_displacement" >_array_structure_list_axis.reference_displacement</a>
123 #
124 # category <a href="#AXIS">AXIS</a>
125 #
126 # <a href="#_axis.depends_on" >_axis.depends_on</a>
127 # <a href="#_axis.equipment" >_axis.equipment</a>
128 # <a href="#_axis.id" >_axis.id</a></a>
129 # <a href="#_axis.offset[1]" >_axis.offset[1]</a>
130 # <a href="#_axis.offset[2]" >_axis.offset[2]</a>
131 # <a href="#_axis.offset[3]" >_axis.offset[3]</a>
132 # <a href="#_axis.type" >_axis.type</a>
133 # <a href="#_axis.system" >_axis.system</a>
134 # <a href="#_axis.vector[1]" >_axis.vector[1]</a>
135 # <a href="#_axis.vector[2]" >_axis.vector[2]</a>
136 # <a href="#_axis.vector[3]" >_axis.vector[3]</a>
137 #
138 # category <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a>
139 #
140 # <a href="#_diffrn_data_frame.array_id" >_diffrn_data_frame.array_id</a>
141 # <a href="#_diffrn_data_frame.binary_id" >_diffrn_data_frame.binary_id</a>
142 # <a href="#_diffrn_data_frame.center_fast" >_diffrn_data_frame.center_fast</a>
143 # <a href="#_diffrn_data_frame.center_slow" >_diffrn_data_frame.center_slow</a>
144 # <a href="#_diffrn_data_frame.center_units" >_diffrn_data_frame.center_units</a>
145 # <a href="#_diffrn_data_frame.detector_element_id" >_diffrn_data_frame.detector_element_id</a>
146 # <a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a>
147 # <a href="#_diffrn_data_frame.details">_diffrn_data_frame.details</a>
148 #
149 # category <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a>
150 #
151 # <a href="#_diffrn_detector.details" >_diffrn_detector.details</a>
152 # <a href="#_diffrn_detector.detector" >_diffrn_detector.detector</a>
153 # <a href="#_diffrn_detector.diffrn_id" >_diffrn_detector.diffrn_id</a>
154 # <a href="#_diffrn_detector.dtime" >_diffrn_detector.dtime</a>
155 # <a href="#_diffrn_detector.id" >_diffrn_detector.id</a>
156 # <a href="#_diffrn_detector.number_of_axes" >_diffrn_detector.number_of_axes</a>
157 # <a href="#_diffrn_detector.type" >_diffrn_detector.type</a>
158 #
159 # category <a href="#DIFFRN_DETECTOR_AXIS">DIFFRN_DETECTOR_AXIS</a>
160 #
161 # <a href="#_diffrn_detector_axis.axis_id" >_diffrn_detector_axis.axis_id</a>
162 # <a href="#_diffrn_detector_axis.detector_id" >_diffrn_detector_axis.detector_id</a>
163 #
164 # category <a href="#DIFFRN_DETECTOR_ELEMENT">DIFFRN_DETECTOR_ELEMENT</a>
165 #
166 # <a href="#_diffrn_detector_element.id" >_diffrn_detector_element.id</a>
167 # <a href="#_diffrn_detector_element.detector_id" >_diffrn_detector_element.detector_id</a>
168 # <a href="#_diffrn_detector_element.reference_center_fast" >_diffrn_detector_element.reference_center_fast</a>
169 # <a href="#_diffrn_detector_element.reference_center_slow" >_diffrn_detector_element.reference_center_slow</a>
170 # <a href="#_diffrn_detector_element.reference_center_units" >_diffrn_detector_element.reference_center_units</a>
171 #
172 # category <a href="#DIFFRN_MEASUREMENT">DIFFRN_MEASUREMENT</a>
173 #
174 # <a href="#_diffrn_measurement.diffrn_id" >_diffrn_measurement.diffrn_id</a>
175 # <a href="#_diffrn_measurement.details" >_diffrn_measurement.details</a>
176 # <a href="#_diffrn_measurement.device" >_diffrn_measurement.device</a>
177 # <a href="#_diffrn_measurement.device_details" >_diffrn_measurement.device_details</a>
178 # <a href="#_diffrn_measurement.device_type" >_diffrn_measurement.device_type</a>
179 # <a href="#_diffrn_measurement.id" >_diffrn_measurement.id</a>
180 # <a href="#_diffrn_measurement.method" >_diffrn_measurement.method</a>
181 # <a href="#_diffrn_measurement.number_of_axes" >_diffrn_measurement.number_of_axes</a>
182 # <a href="#_diffrn_measurement.sample_detector_distance" >_diffrn_measurement.sample_detector_distance</a>
183 # <a href="#_diffrn_measurement.sample_detector_voffset" >_diffrn_measurement.sample_detector_voffset</a>
184 # <a href="#_diffrn_measurement.specimen_support" >_diffrn_measurement.specimen_support</a>
185 #
186 # category <a href="#DIFFRN_MEASUREMENT_AXIS">DIFFRN_MEASUREMENT_AXIS</a>
187 #
188 # <a href="#_diffrn_measurement_axis.id" >_diffrn_measurement_axis.axis_id</a>
189 # <a href="#_diffrn_measurement_axis.measurement_device" >_diffrn_measurement_axis.measurement_device</a>
190 # <a href="#_diffrn_measurement_axis.measurement_id" >_diffrn_measurement_axis.measurement_id</a>
191 #
192 # category <a href="#DIFFRN_RADIATION">DIFFRN_RADIATION</a>
193 #
194 # <a href="#_diffrn_radiation.collimation">_diffrn_radiation.collimation</a>
195 # <a href="#_diffrn_radiation.diffrn_id">_diffrn_radiation.diffrn_id</a>
196 # <a href="#_diffrn_radiation.div_x_source" >_diffrn_radiation.div_x_source</a>
197 # <a href="#_diffrn_radiation.div_y_source" >_diffrn_radiation.div_y_source</a>
198 # <a href="#_diffrn_radiation.div_x_y_source" >_diffrn_radiation.div_x_y_source</a>
199 # <a href="#_diffrn_radiation.filter_edge">_diffrn_radiation.filter_edge</a>'
200 # <a href="#_diffrn_radiation.inhomogeneity">_diffrn_radiation.inhomogeneity</a>
201 # <a href="#_diffrn_radiation.monochromator">_diffrn_radiation.monochromator</a>
202 # <a href="#_diffrn_radiation.polarisn_norm">_diffrn_radiation.polarisn_norm</a>
203 # <a href="#_diffrn_radiation.polarisn_ratio">_diffrn_radiation.polarisn_ratio</a>
204 # <a href="#_diffrn_radiation.polarizn_source_norm" >_diffrn_radiation.polarizn_source_norm</a>
205 # <a href="#_diffrn_radiation.polarizn_source_ratio" >_diffrn_radiation.polarizn_source_ratio</a>
206 # <a href="#_diffrn_radiation.probe">_diffrn_radiation.probe</a>
207 # <a href="#_diffrn_radiation.type">_diffrn_radiation.type</a>
208 # <a href="#_diffrn_radiation.xray_symbol">_diffrn_radiation.xray_symbol</a>
209 # <a href="#_diffrn_radiation.wavelength_id">_diffrn_radiation.wavelength_id</a>
210 #
211 # category <a href="#DIFFRN_REFLN">DIFFRN_REFLN</a>
212 #
213 # <a href="#_diffrn_refln.frame_id" >_diffrn_refln.frame_id</a>
214 #
215 # category <a href="#DIFFRN_SCAN">DIFFRN_SCAN</a>
216 #
217 # <a href="#_diffrn_scan.id" >_diffrn_scan.id</a>
218 # <a href="#_diffrn_scan.date_end" >_diffrn_scan.date_end</a>
219 # <a href="#_diffrn_scan.date_start" >_diffrn_scan.date_start</a>
220 # <a href="#_diffrn_scan.integration_time" >_diffrn_scan.integration_time</a>
221 # <a href="#_diffrn_scan.frame_id_start" >_diffrn_scan.frame_id_start</a>
222 # <a href="#_diffrn_scan.frame_id_end" >_diffrn_scan.frame_id_end</a>
223 # <a href="#_diffrn_scan.frames" >_diffrn_scan.frames</a>
224 #
225 # category <a href="#DIFFRN_SCAN_AXIS">DIFFRN_SCAN_AXIS</a>
226 #
227 # <a href="#_diffrn_scan_axis.axis_id" >_diffrn_scan_axis.axis_id</a>
228 # <a href="#_diffrn_scan_axis.angle_start" >_diffrn_scan_axis.angle_start</a>
229 # <a href="#_diffrn_scan_axis.angle_range" >_diffrn_scan_axis.angle_range</a>
230 # <a href="#_diffrn_scan_axis.angle_increment" >_diffrn_scan_axis.angle_increment</a>
231 # <a href="#_diffrn_scan_axis.angle_rstrt_incr" >_diffrn_scan_axis.angle_rstrt_incr</a>
232 # <a href="#_diffrn_scan_axis.displacement_start" >_diffrn_scan_axis.displacement_start</a>
233 # <a href="#_diffrn_scan_axis.displacement_range" >_diffrn_scan_axis.displacement_range</a>
234 # <a href="#_diffrn_scan_axis.displacement_increment" >_diffrn_scan_axis.displacement_increment</a>
235 # <a href="#_diffrn_scan_axis.displacement_rstrt_incr" >_diffrn_scan_axis.displacement_rstrt_incr</a>
236 # <a href="#_diffrn_scan_axis.reference_angle" >_diffrn_scan_axis.reference_angle</a>
237 # <a href="#_diffrn_scan_axis.reference_displacement" >_diffrn_scan_axis.reference_displacement</a>
238 # <a href="#_diffrn_scan_axis.scan_id" >_diffrn_scan_axis.scan_id</a>
239 #
240 # category <a href="#DIFFRN_SCAN_FRAME">DIFFRN_SCAN_FRAME</a>
241 #
242 # <a href="#_diffrn_scan_frame.date" >_diffrn_scan_frame.date</a>
243 # <a href="#_diffrn_scan_frame.frame_id" >_diffrn_scan_frame.frame_id</a>
244 # <a href="#_diffrn_scan_frame.frame_number" >_diffrn_scan_frame.frame_number</a>
245 # <a href="#_diffrn_scan_frame.integration_time" >_diffrn_scan_frame.integration_time</a>
246 # <a href="#_diffrn_scan_frame.scan_id" >_diffrn_scan_frame.scan_id</a>
247 #
248 # category <a href="#DIFFRN_SCAN_FRAME_AXIS">DIFFRN_SCAN_FRAME_AXIS</a>
249 #
250 # <a href="#_diffrn_scan_frame_axis.axis_id" >_diffrn_scan_frame_axis.axis_id</a>
251 # <a href="#_diffrn_scan_frame_axis.angle" >_diffrn_scan_frame_axis.angle</a>
252 # <a href="#_diffrn_scan_frame_axis.angle_increment" >_diffrn_scan_frame_axis.angle_increment</a>
253 # <a href="#_diffrn_scan_frame_axis.angle_rstrt_incr" >_diffrn_scan_frame_axis.angle_rstrt_incr</a>
254 # <a href="#_diffrn_scan_frame_axis.displacement" >_diffrn_scan_frame_axis.displacement</a>
255 # <a href="#_diffrn_scan_frame_axis.displacement_increment" >_diffrn_scan_frame_axis.displacement_increment</a>
256 # <a href="#_diffrn_scan_frame_axis.displacement_rstrt_incr" >_diffrn_scan_frame_axis.displacement_rstrt_incr</a>
257 # <a href="#_diffrn_scan_frame_axis.reference_angle" >_diffrn_scan_frame_axis.reference_angle</a>
258 # <a href="#_diffrn_scan_frame_axis.reference_displacement" >_diffrn_scan_frame_axis.reference_displacement</a>
259 # <a href="#_diffrn_scan_frame_axis.frame_id" >_diffrn_scan_frame_axis.frame_id</a>
260 #
261 # categor <a href="#MAP">MAP</a>
262 #
263 # <a href="#_map.details" >_map.details</a>
264 # <a href="#_map.diffrn_id" >_map.diffrn_id</a>
265 # <a href="#_map.entry_id" >_map.entry_id</a>
266 # <a name="#_map.id" >_map.id</a>
267 #
268 # categor <a href="#MAP_SEGMENT">MAP_SEGMENT</a>
269 #
270 # <a href="#_map_segment.array_id" >_map_segment.array_id</a>
271 # <a href="#_map_segment.binary_id" >_map_segment.binary_id</a>
272 # <a href="#_map_segment.mask_array_id" >_map_segment.mask_array_id</a>
273 # <a href="#_map_segment.mask_binary_id" >_map_segment.mask_binary_id</a>
274 # <a href="#_map_segment.id" >_map_segment.id</a>
275 # <a href="#_map_segment.map_id" >_map_segment.map_id</a>
276 # <a href="#_map_segment.details" >_map_segment.details</a>
277 #
278 # ***DEPRECATED*** data items
279 #
280 # <a href="#_diffrn_detector_axis.id" >_diffrn_detector_axis.id</a>
281 # <a href="#_diffrn_detector_element.center[1]" >_diffrn_detector_element.center[1]</a>
282 # <a href="#_diffrn_detector_element.center[2]" >_diffrn_detector_element.center[2]</a>
283 # <a href="#_diffrn_measurement_axis.id" >_diffrn_measurement_axis.id</a>
284 #
285 # ***DEPRECATED*** category <a href="#DIFFRN_FRAME_DATA">DIFFRN_FRAME_DATA</a>
286 #
287 # <a href="#_diffrn_frame_data.array_id" >_diffrn_frame_data.array_id</a>
288 # <a href="#_diffrn_frame_data.binary_id" >_diffrn_frame_data.binary_id</a>
289 # <a href="#_diffrn_frame_data.detector_element_id" >_diffrn_frame_data.detector_element_id</a>
290 # <a href="#_diffrn_frame_data.id" >_diffrn_frame_data.id</a>
291 # <a href="#_diffrn_frame_data.details">_diffrn_frame_data.details</a>
292 #
293 #
294 # <a href="#ITEM_TYPE_LIST">ITEM_TYPE_LIST</a>
295 # <a href="#ITEM_UNITS_LIST">ITEM_UNITS_LIST</a>
296 # <a href="#DICTIONARY_HISTORY">DICTIONARY_HISTORY</a>
297 #
298 ##############################################################################
299
300
301 #########################
302 ## <a name="CATEGORY_GROUP_LIST">CATEGORY_GROUP_LIST</a> ##
303 #########################
304
305 loop_
306 _category_group_list.id
307 _category_group_list.parent_id
308 _category_group_list.description
309 'inclusive_group' .
310 ; Categories that belong to the dictionary extension.
311 ;
312 'array_data_group'
313 'inclusive_group'
314 ; Categories that describe array data.
315 ;
316 'axis_group'
317 'inclusive_group'
318 ; Categories that describe axes.
319 ;
320 'diffrn_group'
321 'inclusive_group'
322 ; Categories that describe details of the diffraction experiment.
323 ;
324
325
326 ##################
327 ## <a name="SUB_CATEGORY">SUB_CATEGORY</a> ##
328 ##################
329
330 loop_
331 _sub_category.id
332 _sub_category.description
333 'matrix'
334 ; The collection of elements of a matrix.
335 ;
336 'vector'
337 ; The collection of elements of a vector.
338 ;
339
340
341
342
343 ##############
344 # <a name="ARRAY_DATA">ARRAY_DATA</a> #
345 ##############
346
347
348 save_ARRAY_DATA
349 _category.description
350 ; Data items in the <a href="#ARRAY_DATA">ARRAY_DATA</a> category are the containers for
351 the array data items described in the category <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a>.
352
353 It is recognized that the data in this category needs to be used in
354 two distinct ways. During a data collection the lack of ancillary
355 data and timing constraints in processing data may dictate the
356 need to make a 'miniCBF' nothing more than an essential minimum
357 of information to record the results of the data collection. In that
358 case it is proper to use the <a href="#ARRAY_DATA">ARRAY_DATA</a> category as a
359 container for just a single image and a compacted, beam-line
360 dependent list of data collection parameter values. In such
361 a case, only the tags '<a href="#_array_data.header_convention">_array_data.header_convention</a>',
362 '<a href="#_array_data.header_contents">_array_data.header_contents</a>' and '<a href="#_array_data.data">_array_data.data</a>' need be
363 populated.
364
365 For full processing and archiving, most of the tags in this
366 dictionary will need to be populated.
367
368 ;
369 _category.id array_data
370 _category.mandatory_code no
371 loop_
372 _category_key.name '<a href="#_array_data.array_id" >_array_data.array_id</a>'
373 '<a href="#_array_data.binary_id" >_array_data.binary_id</a>'
374 loop_
375 _category_group.id 'inclusive_group'
376 'array_data_group'
377 loop_
378 _category_examples.detail
379 _category_examples.case
380 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
381 ;
382 Example 1 -
383
384 This example shows two binary data blocks. The first one
385 was compressed by the CBF_CANONICAL compression algorithm and is
386 presented as hexadecimal data. The first character 'H' on the
387 data lines means hexadecimal. It could have been 'O' for octal
388 or 'D' for decimal. The second character on the line shows
389 the number of bytes in each word (in this case '4'), which then
390 requires eight hexadecimal digits per word. The third character
391 gives the order of octets within a word, in this case '&lt;'
392 for the ordering 4321 (i.e. 'big-endian'). Alternatively, the
393 character '&gt;' could have been used for the ordering 1234
394 (i.e. 'little-endian'). The block has a 'message digest'
395 to check the integrity of the data.
396
397 The second block is similar, but uses CBF_PACKED compression
398 and BASE64 encoding. Note that the size and the digest are
399 different.
400 ;
401 ;
402
403 loop_
404 <a href="#_array_data.array_id" >_array_data.array_id</a>
405 <a href="#_array_data.binary_id" >_array_data.binary_id</a>
406 <a href="#_array_data.data" >_array_data.data</a>
407 image_1 1
408 ;
409 --CIF-BINARY-FORMAT-SECTION--
410 Content-Type: application/octet-stream;
411 conversions=&quot;<b>X</b>-CBF_CANONICAL&quot;
412 Content-Transfer-Encoding: <b>X</b>-BASE16
413 X-Binary-Size: 3927126
414 X-Binary-ID: 1
415 Content-MD5: u2sTJEovAHkmkDjPi+gWsg==
416
417 # Hexadecimal encoding, byte 0, byte order ...21
418 #
419 H4&lt; 0050B810 00000000 00000000 00000000 000F423F 00000000 00000000 ...
420 ....
421 --CIF-BINARY-FORMAT-SECTION----
422 ;
423 image_2 2
424 ;
425 --CIF-BINARY-FORMAT-SECTION--
426 Content-Type: application/octet-stream;
427 conversions=&quot;X-CBF-PACKED&quot;
428 Content-Transfer-Encoding: BASE64
429 X-Binary-Size: 3745758
430 X-Binary-ID: 2
431 Content-MD5: 1zsJjWPfol2GYl2V+QSXrw==
432
433 ELhQAAAAAAAA...
434 ...
435 --CIF-BINARY-FORMAT-SECTION----
436 ;
437 ;
438 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
439 ;
440 Example 2 -
441
442 This example shows a single image in a miniCBF, provided by
443 E. Eikenberry. The entire CBF consists of one data block
444 containing one category and three tags. The CBFlib
445 program convert_miniCBF and a suitable template file
446 can be used to convert this miniCBF to a full imgCIF
447 file.
448 ;
449 ;
450 ###CBF: VERSION 1.5
451 # CBF file written by CBFlib v0.7.8
452
453 data_insulin_pilatus6m
454
455 <a href="#_array_data.header_convention">_array_data.header_convention</a> SLS_1.0
456 <a href="#_array_data.header_contents">_array_data.header_contents</a>
457 ;
458 # Detector: PILATUS 6M SN: 60-0001
459 # 2007/Jun/17 15:12:36.928
460 # Pixel_size 172e-6 m x 172e-6 m
461 # Silicon sensor, thickness 0.000320 m
462 # Exposure_time 0.995000 s
463 # Exposure_period 1.000000 s
464 # Tau = 194.0e-09 s
465 # Count_cutoff 1048575 counts
466 # Threshold_setting 5000 eV
467 # Wavelength 1.2398 A
468 # Energy_range (0, 0) eV
469 # Detector_distance 0.15500 m
470 # Detector_Voffset -0.01003 m
471 # Beam_xy (1231.00, 1277.00) pixels
472 # Flux 22487563295 ph/s
473 # Filter_transmission 0.0008
474 # Start_angle 13.0000 deg.
475 # Angle_increment 1.0000 deg.
476 # Detector_2theta 0.0000 deg.
477 # Polarization 0.990
478 # Alpha 0.0000 deg.
479 # Kappa 0.0000 deg.
480 # Phi 0.0000 deg.
481 # Chi 0.0000 deg.
482 # Oscillation_axis X, CW
483 # N_oscillations 1
484 ;
485
486 <a href="#_array_data.data">_array_data.data</a>
487 ;
488 --CIF-BINARY-FORMAT-SECTION--
489 Content-Type: application/octet-stream;
490 conversions="x-CBF_BYTE_OFFSET"
491 Content-Transfer-Encoding: BINARY
492 X-Binary-Size: 6247567
493 X-Binary-ID: 1
494 X-Binary-Element-Type: "signed 32-bit integer"
495 X-Binary-Element-Byte-Order: LITTLE_ENDIAN
496 Content-MD5: 8wO6i2+899lf5iO8QPdgrw==
497 X-Binary-Number-of-Elements: 6224001
498 X-Binary-Size-Fastest-Dimension: 2463
499 X-Binary-Size-Second-Dimension: 2527
500 X-Binary-Size-Padding: 4095
501
502 ...
503
504 --CIF-BINARY-FORMAT-SECTION----
505 ;
506 ;
507 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
508
509 save_
510
511
512 save_<a name="_array_data.array_id" >_array_data.array_id</a>
513 _item_description.description
514 ; This item is a pointer to <a href="#_array_structure.id" >_array_structure.id</a> in the
515 <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a> category.
516
517 If not given, it defaults to 1.
518 ;
519 _item.name '<a href="#_array_data.array_id" >_array_data.array_id</a>'
520 _item.category_id array_data
521 _item.mandatory_code implicit
522 _item_type.code code
523 save_
524
525
526 save_<a name="_array_data.binary_id" >_array_data.binary_id</a>
527 _item_description.description
528 ; This item is an integer identifier which, along with
529 <a href="#_array_data.array_id" >_array_data.array_id</a>, should uniquely identify the
530 particular block of array data.
531
532 If <a href="#_array_data.binary_id" >_array_data.binary_id</a> is not explicitly given,
533 it defaults to 1.
534
535 The value of <a href="#_array_data.binary_id" >_array_data.binary_id</a> distinguishes
536 among multiple sets of data with the same array
537 structure.
538
539 If the MIME header of the data array specifies a
540 value for X-Binary-ID, the value of <a href="#_array_data.binary_id" >_array_data.binary_id</a>
541 should be equal to the value given for X-Binary-ID.
542 ;
543 loop_
544 _item.name
545 _item.category_id
546 _item.mandatory_code
547 '<a href="#_array_data.binary_id" >_array_data.binary_id</a>' array_data
548 implicit
549 '<a href="#_diffrn_data_frame.binary_id" >_diffrn_data_frame.binary_id</a>' diffrn_data_frame
550 implicit
551 '<a href="#_array_intensities.binary_id" >_array_intensities.binary_id</a>' array_intensities
552 implicit
553 loop_
554 _item_linked.child_name
555 _item_linked.parent_name
556 '<a href="#_diffrn_data_frame.binary_id" >_diffrn_data_frame.binary_id</a>' '<a href="#_array_data.binary_id" >_array_data.binary_id</a>'
557 '<a href="#_array_intensities.binary_id" >_array_intensities.binary_id</a>' '<a href="#_array_data.binary_id" >_array_data.binary_id</a>'
558
559 _item_default.value 1
560 _item_type.code int
561 loop_
562 _item_range.maximum
563 _item_range.minimum
564 1 1
565 . 1
566 save_
567
568
569 save_<a name="_array_data.data" >_array_data.data</a>
570 _item_description.description
571 ; The value of <a href="#_array_data.data" >_array_data.data</a> contains the array data
572 encapsulated in a STAR string.
573
574 The representation used is a variant on the
575 Multipurpose Internet Mail Extensions (MIME) specified
576 in RFC 2045-2049 by N. Freed et al. The boundary
577 delimiter used in writing an imgCIF or CBF is
578 '\n--CIF-BINARY-FORMAT-SECTION--' (including the
579 required initial '\n--').
580
581 The Content-Type may be any of the discrete types permitted
582 in RFC 2045; 'application/octet-stream' is recommended
583 for diffraction images in the ARRAY_DATA category.
584 Note: When appropriate in other categories, e.g. for
585 photographs of crystals, more precise types, such as
586 'image/jpeg', 'image/tiff', 'image/png', etc. should be used.
587
588 If an octet stream was compressed, the compression should
589 be specified by the parameter
590 'conversions=&quot;X-CBF_PACKED&quot;'
591 or the parameter
592 'conversions=&quot;X-CBF_CANONICAL&quot;'
593 or the parameter
594 'conversions=&quot;X-CBF_BYTE_OFFSET&quot;'
595
596 If the parameter
597 'conversions=&quot;X-CBF_PACKED&quot;'
598 is given it may be further modified with the parameters
599 '&quot;uncorrelated_sections&quot;'
600 or
601 '&quot;flat&quot;'
602
603 If the '&quot;uncorrelated_sections&quot;' parameter is
604 given, each section will be compressed without using
605 the prior section for averaging.
606
607 If the '&quot;flat&quot;' parameter is given, each the
608 image will be treated as one long row.
609
610 The Content-Transfer-Encoding may be 'BASE64',
611 'Quoted-Printable', 'X-BASE8', 'X-BASE10',
612 'X-BASE16' or 'X-BASE32K', for an imgCIF or 'BINARY'
613 for a CBF. The octal, decimal and hexadecimal transfer
614 encodings are provided for convenience in debugging and
615 are not recommended for archiving and data interchange.
616
617 In a CIF, one of the parameters 'charset=us-ascii',
618 'charset=utf-8' or 'charset=utf-16' may be used on the
619 Content-Transfer-Encoding to specify the character set
620 used for the external presentation of the encoded data.
621 If no charset parameter is given, the character set of
622 the enclosing CIF is assumed. In any case, if a BOM
623 flag is detected (FE FF for big-endian UTF-16, FF FE for
624 little-endian UTF-16 or EF BB BF for UTF-8) is detected,
625 the indicated charset will be assumed until the end of the
626 encoded data or the detection of a different BOM. The
627 charset of the Content-Transfer-Encoding is not the character
628 set of the encoded data, only the character set of the
629 presentation of the encoded data and should be respecified
630 for each distinct STAR string.
631
632 In an imgCIF file, the encoded binary data begins after
633 the empty line terminating the header. In an imgCIF file,
634 the encoded binary data ends with the terminating boundary
635 delimiter '\n--CIF-BINARY-FORMAT-SECTION----'
636 in the currently effective charset or with the '\n; '
637 that terminates the STAR string.
638
639 In a CBF, the raw binary data begins after an empty line
640 terminating the header and after the sequence:
641
642 Octet Hex Decimal Purpose
643 0 0C 12 (ctrl-L) Page break
644 1 1A 26 (ctrl-Z) Stop listings in MS-DOS
645 2 04 04 (Ctrl-D) Stop listings in UNIX
646 3 D5 213 Binary section begins
647
648 None of these octets are included in the calculation of
649 the message size or in the calculation of the
650 message digest.
651
652 The X-Binary-Size header specifies the size of the
653 equivalent binary data in octets. If compression was
654 used, this size is the size after compression, including
655 any book-keeping fields. An adjustment is made for
656 the deprecated binary formats in which eight bytes of binary
657 header are used for the compression type. In this case,
658 the eight bytes used for the compression type are subtracted
659 from the size, so that the same size will be reported
660 if the compression type is supplied in the MIME header.
661 Use of the MIME header is the recommended way to
662 supply the compression type. In general, no portion of
663 the binary header is included in the calculation of the size.
664
665 The X-Binary-Element-Type header specifies the type of
666 binary data in the octets, using the same descriptive
667 phrases as in <a href="#_array_structure.encoding_type">_array_structure.encoding_type</a>. The default
668 value is 'unsigned 32-bit integer'.
669
670 An MD5 message digest may, optionally, be used. The 'RSA Data
671 Security, Inc. MD5 Message-Digest Algorithm' should be used.
672 No portion of the header is included in the calculation of the
673 message digest.
674
675 If the Transfer Encoding is 'X-BASE8', 'X-BASE10' or
676 'X-BASE16', the data are presented as octal, decimal or
677 hexadecimal data organized into lines or words. Each word
678 is created by composing octets of data in fixed groups of
679 2, 3, 4, 6 or 8 octets, either in the order ...4321 ('big-
680 endian') or 1234... ('little-endian'). If there are fewer
681 than the specified number of octets to fill the last word,
682 then the missing octets are presented as '==' for each
683 missing octet. Exactly two equal signs are used for each
684 missing octet even for octal and decimal encoding.
685 The format of lines is:
686
687 rnd xxxxxx xxxxxx xxxxxx
688
689 where r is 'H', 'O' or 'D' for hexadecimal, octal or
690 decimal, n is the number of octets per word and d is '&lt;'
691 or '&gt;' for the '...4321' and '1234...' octet orderings,
692 respectively. The '==' padding for the last word should
693 be on the appropriate side to correspond to the missing
694 octets, e.g.
695
696 H4&lt; FFFFFFFF FFFFFFFF 07FFFFFF ====0000
697
698 or
699
700 H3&gt; FF0700 00====
701
702 For these hexadecimal, octal and decimal formats only,
703 comments beginning with '#' are permitted to improve
704 readability.
705
706 BASE64 encoding follows MIME conventions. Octets are
707 in groups of three: c1, c2, c3. The resulting 24 bits
708 are broken into four six-bit quantities, starting with
709 the high-order six bits (c1 &gt;&gt; 2) of the first octet, then
710 the low-order two bits of the first octet followed by the
711 high-order four bits of the second octet [(c1 & 3)&lt;&lt;4 | (c2&gt;&gt;4)],
712 then the bottom four bits of the second octet followed by the
713 high-order two bits of the last octet [(c2 & 15)&lt;&lt;2 | (c3&gt;&gt;6)],
714 then the bottom six bits of the last octet (c3 & 63). Each
715 of these four quantities is translated into an ASCII character
716 using the mapping:
717
718 1 2 3 4 5 6
719 0123456789012345678901234567890123456789012345678901234567890123
720 | | | | | | |
721 ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/
722
723 With short groups of octets padded on the right with one '='
724 if c3 is missing, and with '==' if both c2 and c3 are missing.
725
726 X-BASE32K encoding is similar to BASE64 encoding, except that
727 sets of 15 octets are encoded as sets of 8 16-bit unicode
728 characters, by breaking the 120 bits into 8 15-bit quantities.
729 256 is added to each 15 bit quantity to bring it into a
730 printable uncode range. When encoding, zero padding is used
731 to fill out the last 15 bit quantity. If 8 or more bits of
732 padding are used, a single equals sign (hexadecimal 003D) is
733 appended. Embedded whitespace and newlines are introduced
734 to produce lines of no more than 80 characters each. On
735 decoding, all printable ascii characters and ascii whitespace
736 characters are ignored except for any trailing equals signs.
737 The number of trailing equals signs indicated the number of
738 trailing octets to be trimmed from the end of the decoded data.
739 (see Georgi Darakev, Vassil Litchev, Kostadin Z. Mitev, Herbert
740 J. Bernstein, 'Efficient Support of Binary Data in the XML
741 Implementation of the NeXus File Format',absract W0165,
742 ACA Summer Meeting, Honolulu, HI, July 2006).
743
744 QUOTED-PRINTABLE encoding also follows MIME conventions, copying
745 octets without translation if their ASCII values are 32...38,
746 42, 48...57, 59, 60, 62, 64...126 and the octet is not a ';'
747 in column 1. All other characters are translated to =nn, where
748 nn is the hexadecimal encoding of the octet. All lines are
749 'wrapped' with a terminating '=' (i.e. the MIME conventions
750 for an implicit line terminator are never used).
751
752 The &quot;X-Binary-Element-Byte-Order&quot; can specify either
753 '&quot;BIG_ENDIAN&quot;' or '&quot;LITTLE_ENDIAN&quot;' byte order of the imaage
754 data. Only LITTLE_ENDIAN is recommended. Processors
755 may treat BIG_ENDIAN as a warning of data that can
756 only be processed by special software.
757
758 The &quot;X-Binary-Number-of-Elements&quot; specifies the number of
759 elements (not the number of octets) in the decompressed, decoded
760 image.
761
762 The optional &quot;X-Binary-Size-Fastest-Dimension&quot; specifies the
763 number of elements (not the number of octets) in one row of the
764 fastest changing dimension of the binary data array. This
765 information must be in the MIME header for proper operation of
766 some of the decompression algorithms.
767
768 The optional &quot;X-Binary-Size-Second-Dimension&quot; specifies the
769 number of elements (not the number of octets) in one column of
770 the second-fastest changing dimension of the binary data array.
771 This information must be in the MIME header for proper operation
772 of some of the decompression algorithms.
773
774 The optional &quot;X-Binary-Size-Third-Dimension&quot; specifies the number
775 of sections for the third-fastest changing dimension of the
776 binary data array.
777
778 The optional &quot;X-Binary-Size-Padding&quot; specifies the size in
779 octets of an optional padding after the binary array data and
780 before the closing flags for a binary section.
781 ;
782 _item.name '<a href="#_array_data.data" >_array_data.data</a>'
783 _item.category_id array_data
784 _item.mandatory_code yes
785 _item_type.code binary
786 save_
787
788
789 save_<a name="_array_data.header_contents" >_array_data.header_contents</a>
790 _item_description.description
791 ; This item is an text field for use in minimal CBF files to carry
792 essential header information to be kept with image data
793 in _array_data.data when the tags that normally carry the
794 structured metadata for the image have not been populated.
795
796 Normally this data item should not appear when the full set
797 of tags have been populated and _diffrn_data_frame.details
798 appears.
799 ;
800 _item.name '<a href="#_array_data.header_contents" >_array_data.header_contents</a>'
801 _item.category_id <a href="#ARRAY_DATA">array_data</a>
802 _item.mandatory_code no
803 _item_type.code text
804 save_
805
806
807
808 save_<a name="_array_data.header_convention" >_array_data.header_convention</a>
809 _item_description.description
810 ; This item is an identifier for the convention followed in
811 constructing the contents of <a href="#_array_data.header_contents" >_array_data.header_contents</a>
812
813 The permitted values are of the of an image creator identifier
814 followed by an underscore and a version string. To avoid
815 confusion about conventions, all creator identifiers
816 should be registered with the IUCr and the conventions
817 for all identifiers and versions should be posted on
818 the MEDSBIO.org web site.
819 ;
820 _item.name '<a href="#_array_data.header_convention" >_array_data.header_convention</a>'
821 _item.category_id <a href="#ARRAY_DATA">array_data</a>
822 _item.mandatory_code no
823 _item_type.code code
824 save_
825
826
827
828
829 ######################
830 # <a name="ARRAY_ELEMENT_SIZE">ARRAY_ELEMENT_SIZE</a> #
831 ######################
832
833
834 save_ARRAY_ELEMENT_SIZE
835 _category.description
836 ; Data items in the <a href="#ARRAY_ELEMENT_SIZE">ARRAY_ELEMENT_SIZE</a> category record the physical
837 size of array elements along each array dimension.
838 ;
839 _category.id array_element_size
840 _category.mandatory_code no
841 loop_
842 _category_key.name '<a href="#_array_element_size.array_id" >_array_element_size.array_id</a>'
843 '<a href="#_array_element_size.index" >_array_element_size.index</a>'
844 loop_
845 _category_group.id 'inclusive_group'
846 'array_data_group'
847 loop_
848 _category_examples.detail
849 _category_examples.case
850 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
851 ; Example 1 - A regular 2D array with a uniform element dimension
852 of 1220 nanometres.
853 ;
854 ;
855 loop_
856 <a href="#_array_element_size.array_id" >_array_element_size.array_id</a>
857 <a href="#_array_element_size.index" >_array_element_size.index</a>
858 <a href="#_array_element_size.size" >_array_element_size.size</a>
859 image_1 1 1.22e-6
860 image_1 2 1.22e-6
861 ;
862 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
863 save_
864
865
866 save_<a name="_array_element_size.array_id" >_array_element_size.array_id</a>
867 _item_description.description
868 ; This item is a pointer to <a href="#_array_structure.id" >_array_structure.id</a> in the
869 <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a> category.
870 ;
871 _item.name '<a href="#_array_element_size.array_id" >_array_element_size.array_id</a>'
872 _item.category_id array_element_size
873 _item.mandatory_code implicit
874 _item_type.code code
875 save_
876
877
878 save_<a name="_array_element_size.index" >_array_element_size.index</a>
879 _item_description.description
880 ; This item is a pointer to <a href="#_array_structure_list.index" >_array_structure_list.index</a> in
881 the ARRAY_STRUCTURE_LIST category.
882 ;
883 _item.name '<a href="#_array_element_size.index" >_array_element_size.index</a>'
884 _item.category_id array_element_size
885 _item.mandatory_code yes
886 _item_type.code code
887 save_
888
889
890 save_<a name="_array_element_size.size" >_array_element_size.size</a>
891 _item_description.description
892 ; The size in metres of an image element in this
893 dimension. This supposes that the elements are arranged
894 on a regular grid.
895 ;
896 _item.name '<a href="#_array_element_size.size" >_array_element_size.size</a>'
897 _item.category_id array_element_size
898 _item.mandatory_code yes
899 _item_type.code float
900 _item_units.code 'metres'
901 loop_
902 _item_range.maximum
903 _item_range.minimum
904 . 0.0
905 save_
906
907
908 #####################
909 # <a name="ARRAY_INTENSITIES">ARRAY_INTENSITIES</a> #
910 #####################
911
912
913 save_ARRAY_INTENSITIES
914 _category.description
915 ; Data items in the <a href="#ARRAY_INTENSITIES">ARRAY_INTENSITIES</a> category record the
916 information required to recover the intensity data from
917 the set of data values stored in the <a href="#ARRAY_DATA">ARRAY_DATA</a> category.
918
919 The detector may have a complex relationship
920 between the raw intensity values and the number of
921 incident photons. In most cases, the number stored
922 in the final array will have a simple linear relationship
923 to the actual number of incident photons, given by
924 <a href="#_array_intensities.gain">_array_intensities.gain</a>. If raw, uncorrected values
925 are presented (e.g. for calibration experiments), the
926 value of <a href="#_array_intensities.linearity">_array_intensities.linearity</a> will be 'raw'
927 and <a href="#_array_intensities.gain">_array_intensities.gain</a> will not be used.
928
929 ;
930 _category.id array_intensities
931 _category.mandatory_code no
932 loop_
933 _category_key.name '<a href="#_array_intensities.array_id" >_array_intensities.array_id</a>'
934 '<a href="#_array_intensities.binary_id" >_array_intensities.binary_id</a>'
935 loop_
936 _category_group.id 'inclusive_group'
937 'array_data_group'
938 loop_
939 _category_examples.detail
940 _category_examples.case
941 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
942 ;
943 Example 1
944 ;
945 ;
946 loop_
947 <a href="#_array_intensities.array_id" >_array_intensities.array_id</a>
948 <a href="#_array_intensities.linearity" >_array_intensities.linearity</a>
949 <a href="#_array_intensities.gain" >_array_intensities.gain</a>
950 <a href="#_array_intensities.overload" >_array_intensities.overload</a>
951 <a href="#_array_intensities.undefined_value" >_array_intensities.undefined_value</a>
952 <a href="#_array_intensities.pixel_fast_bin_size" >_array_intensities.pixel_fast_bin_size</a>
953 <a href="#_array_intensities.pixel_slow_bin_size" >_array_intensities.pixel_slow_bin_size</a>
954 <a href="#_array_intensities.pixel_binning_method" >_array_intensities.pixel_binning_method</a>
955 image_1 linear 1.2 655535 0 2 2 hardware
956 ;
957 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
958 save_
959
960
961 save_<a name="_array_intensities.array_id" >_array_intensities.array_id</a>
962 _item_description.description
963 ; This item is a pointer to <a href="#_array_structure.id" >_array_structure.id</a> in the
964 <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a> category.
965 ;
966 _item.name '<a href="#_array_intensities.array_id" >_array_intensities.array_id</a>'
967 _item.category_id array_intensities
968 _item.mandatory_code implicit
969 _item_type.code code
970 save_
971
972
973 save_<a name="_array_intensities.binary_id" >_array_intensities.binary_id</a>
974 _item_description.description
975 ; This item is a pointer to <a href="#_array_data.binary_id" >_array_data.binary_id</a> in the
976 <a href="#ARRAY_DATA">ARRAY_DATA</a> category.
977 ;
978 _item.name '<a href="#_array_intensities.binary_id" >_array_intensities.binary_id</a>'
979 _item.category_id array_intensities
980 _item.mandatory_code implicit
981 _item_type.code int
982 save_
983
984
985 save_<a name="_array_intensities.gain" >_array_intensities.gain</a>
986 _item_description.description
987 ; Detector 'gain'. The factor by which linearized
988 intensity count values should be divided to produce
989 true photon counts.
990 ;
991 _item.name '<a href="#_array_intensities.gain" >_array_intensities.gain</a>'
992 _item.category_id array_intensities
993 _item.mandatory_code yes
994 _item_type.code float
995 loop_
996 _item_range.maximum
997 _item_range.minimum
998 . 0.0
999 _item_units.code 'counts_per_photon'
1000 loop_
1001 _item_related.related_name
1002 _item_related.function_code '<a href="#_array_intensities.gain_esd" >_array_intensities.gain_esd</a>'
1003 'associated_value'
1004 save_
1005
1006
1007 save_<a name="_array_intensities.gain_esd" >_array_intensities.gain_esd</a>
1008 _item_description.description
1009 ; The estimated standard deviation in detector 'gain'.
1010 ;
1011 _item.name '<a href="#_array_intensities.gain_esd" >_array_intensities.gain_esd</a>'
1012 _item.category_id array_intensities
1013 _item.mandatory_code yes
1014 _item_type.code float
1015 loop_
1016 _item_range.maximum
1017 _item_range.minimum
1018 . 0.0
1019
1020 _item_units.code 'counts_per_photon'
1021 loop_
1022 _item_related.related_name
1023 _item_related.function_code '<a href="#_array_intensities.gain" >_array_intensities.gain</a>'
1024 'associated_esd'
1025 save_
1026
1027
1028 save_<a name="_array_intensities.linearity" >_array_intensities.linearity</a>
1029 _item_description.description
1030 ; The intensity linearity scaling method used to convert
1031 from the raw intensity to the stored element value:
1032
1033 'linear' is linear.
1034
1035 'offset' means that the value defined by
1036 <a href="#_array_intensities.offset" >_array_intensities.offset</a> should be added to each
1037 element value.
1038
1039 'scaling' means that the value defined by
1040 <a href="#_array_intensities.scaling">_array_intensities.scaling</a> should be multiplied with each
1041 element value.
1042
1043 'scaling_offset' is the combination of the two previous cases,
1044 with the scale factor applied before the offset value.
1045
1046 'sqrt_scaled' means that the square root of raw
1047 intensities multiplied by <a href="#_array_intensities.scaling">_array_intensities.scaling</a> is
1048 calculated and stored, perhaps rounded to the nearest
1049 integer. Thus, linearization involves dividing the stored
1050 values by <a href="#_array_intensities.scaling">_array_intensities.scaling</a> and squaring the
1051 result.
1052
1053 'logarithmic_scaled' means that the logarithm base 10 of
1054 raw intensities multiplied by <a href="#_array_intensities.scaling">_array_intensities.scaling</a>
1055 is calculated and stored, perhaps rounded to the nearest
1056 integer. Thus, linearization involves dividing the stored
1057 values by <a href="#_array_intensities.scaling">_array_intensities.scaling</a> and calculating 10
1058 to the power of this number.
1059
1060 'raw' means that the data are a set of raw values straight
1061 from the detector.
1062 ;
1063
1064 _item.name '<a href="#_array_intensities.linearity" >_array_intensities.linearity</a>'
1065 _item.category_id array_intensities
1066 _item.mandatory_code yes
1067 _item_type.code code
1068 loop_
1069 _item_enumeration.value
1070 _item_enumeration.detail
1071 'linear' .
1072 'offset'
1073 ; The value defined by <a href="#_array_intensities.offset" >_array_intensities.offset</a> should
1074 be added to each element value.
1075 ;
1076 'scaling'
1077 ; The value defined by <a href="#_array_intensities.scaling">_array_intensities.scaling</a> should be
1078 multiplied with each element value.
1079 ;
1080 'scaling_offset'
1081 ; The combination of the scaling and offset
1082 with the scale factor applied before the offset value.
1083 ;
1084 'sqrt_scaled'
1085 ; The square root of raw intensities multiplied by
1086 <a href="#_array_intensities.scaling">_array_intensities.scaling</a> is calculated and stored,
1087 perhaps rounded to the nearest integer. Thus,
1088 linearization involves dividing the stored
1089 values by <a href="#_array_intensities.scaling">_array_intensities.scaling</a> and squaring the
1090 result.
1091 ;
1092 'logarithmic_scaled'
1093 ; The logarithm base 10 of raw intensities multiplied by
1094 <a href="#_array_intensities.scaling">_array_intensities.scaling</a> is calculated and stored,
1095 perhaps rounded to the nearest integer. Thus,
1096 linearization involves dividing the stored values by
1097 <a href="#_array_intensities.scaling">_array_intensities.scaling</a> and calculating 10 to the
1098 power of this number.
1099 ;
1100 'raw'
1101 ; The array consists of raw values to which no corrections have
1102 been applied. While the handling of the data is similar to
1103 that given for 'linear' data with no offset, the meaning of
1104 the data differs in that the number of incident photons is
1105 not necessarily linearly related to the number of counts
1106 reported. This value is intended for use either in
1107 calibration experiments or to allow for handling more
1108 complex data-fitting algorithms than are allowed for by
1109 this data item.
1110 ;
1111
1112 save_
1113
1114
1115 save_<a name="_array_intensities.offset" >_array_intensities.offset</a>
1116 _item_description.description
1117 ; Offset value to add to array element values in the manner
1118 described by the item <a href="#_array_intensities.linearity" >_array_intensities.linearity</a>.
1119 ;
1120 _item.name '<a href="#_array_intensities.offset" >_array_intensities.offset</a>'
1121 _item.category_id array_intensities
1122 _item.mandatory_code no
1123 _item_type.code float
1124 save_
1125
1126
1127 save_<a name="_array_intensities.overload" >_array_intensities.overload</a>
1128 _item_description.description
1129 ; The saturation intensity level for this data array.
1130 ;
1131 _item.name '<a href="#_array_intensities.overload" >_array_intensities.overload</a>'
1132 _item.category_id array_intensities
1133 _item.mandatory_code no
1134 _item_type.code float
1135 _item_units.code 'counts'
1136 save_
1137
1138
1139 save_<a name="_array_intensities.pixel_fast_bin_size" >_array_intensities.pixel_fast_bin_size</a>
1140 _item_description.description
1141 ; The value of <a href=#_array_intensities.pixel_fast_bin_size" >_array_intensities.pixel_fast_bin_size</a> specifies
1142 the number of pixels that compose one element in the direction
1143 of the most rapidly varying array dimension.
1144
1145 Typical values are 1, 2, 4 or 8. When there is 1 pixel per
1146 array element in both directions, the value given for
1147 <a href="#_array_intensities.pixel_binning_method" >_array_intensities.pixel_binning_method</a> normally should be
1148 'none'.
1149
1150 It is specified as a float to allow for binning algorithms that
1151 create array elements that are not integer multiples of the
1152 detector pixel size.
1153 ;
1154 _item.name '<a href="#_array_intensities.pixel_fast_bin_size" >_array_intensities.pixel_fast_bin_size</a>'
1155 _item.category_id array_intensities
1156 _item.mandatory_code implicit
1157 _item_type.code float
1158 _item_default.value 1.
1159 loop_
1160 _item_range.maximum
1161 _item_range.minimum
1162 . 0.0
1163 _item_units.code 'pixels_per_element'
1164 save_
1165
1166
1167 save_<a name="_array_intensities.pixel_slow_bin_size" >_array_intensities.pixel_slow_bin_size</a>
1168 _item_description.description
1169 ; The value of <a href=#_array_intensities.pixel_slow_bin_size" >_array_intensities.pixel_slow_bin_size</a> specifies
1170 the number of pixels that compose one element in the direction
1171 of the second most rapidly varying array dimension.
1172
1173 Typical values are 1, 2, 4 or 8. When there is 1 pixel per
1174 array element in both directions, the value given for
1175 <a href="#_array_intensities.pixel_binning_method" >_array_intensities.pixel_binning_method</a> normally should be
1176 'none'.
1177
1178 It is specified as a float to allow for binning algorithms that
1179 create array elements that are not integer multiples of the
1180 detector pixel size.
1181 ;
1182 _item.name '<a href="#_array_intensities.pixel_slow_bin_size" >_array_intensities.pixel_slow_bin_size</a>'
1183 _item.category_id array_intensities
1184 _item.mandatory_code implicit
1185 _item_type.code float
1186 _item_default.value 1.
1187 loop_
1188 _item_range.maximum
1189 _item_range.minimum
1190 . 0.0
1191 _item_units.code 'pixels_per_element'
1192 save_
1193
1194
1195 save_<a name="_array_intensities.pixel_binning_method" >_array_intensities.pixel_binning_method</a>
1196 _item_description.description
1197 ; The value of <a href="#_array_intensities.pixel_binning_method">_array_intensities.pixel_binning_method</a> specifies
1198 the method used to derive array elements from multiple pixels.
1199 ;
1200 _item.name '<a href="#_array_intensities.pixel_binning_method" >_array_intensities.pixel_binning_method</a>'
1201 _item.category_id array_intensities
1202 _item.mandatory_code implicit
1203 _item_type.code code
1204 loop_
1205 _item_enumeration.value
1206 _item_enumeration.detail
1207 'hardware'
1208 ; The element intensities were derived from the raw data of one
1209 or more pixels by used of hardware in the detector, e.g. by use
1210 of shift registers in a CCD to combine pixels into super-pixels.
1211 ;
1212 'software'
1213 ; The element intensities were derived from the raw data of more
1214 than one pixel by use of software.
1215 ;
1216 'combined'
1217 ; The element intensities were derived from the raw data of more
1218 than one pixel by use of both hardware and software, as when
1219 hardware binning is used in one direction and software in the
1220 other.
1221 ;
1222 'none'
1223 ; In the both directions, the data has not been binned. The
1224 number of pixels is equal to the number of elements.
1225
1226 When the value of <a href="#_array_intensities.pixel_binning_method" >_array_intensities.pixel_binning_method</a> is
1227 'none' the values of <a href="#_array_intensities.pixel_fast_bin_size" >_array_intensities.pixel_fast_bin_size</a>
1228 and <a href="#_array_intensities.pixel_slow_bin_size" >_array_intensities.pixel_slow_bin_size</a> both must be 1.
1229 ;
1230 'unspecified'
1231 ; The method used to derive element intensities is not specified.
1232 ;
1233 _item_default.value 'unspecified'
1234 save_
1235
1236 save_<a name="_array_intensities.scaling" >_array_intensities.scaling</a>
1237 _item_description.description
1238 ; Multiplicative scaling value to be applied to array data
1239 in the manner described by item
1240 <a href="#_array_intensities.linearity" >_array_intensities.linearity</a>.
1241 ;
1242 _item.name '<a href="#_array_intensities.scaling" >_array_intensities.scaling</a>'
1243 _item.category_id array_intensities
1244 _item.mandatory_code no
1245 _item_type.code float
1246 save_
1247
1248
1249
1250 save_<a name="_array_intensities.undefined_value" >_array_intensities.undefined_value</a>
1251 _item_description.description
1252 ; A value to be substituted for undefined values in
1253 the data array.
1254 ;
1255 _item.name '<a href="#_array_intensities.undefined_value" >_array_intensities.undefined_value</a>'
1256 _item.category_id array_intensities
1257 _item.mandatory_code no
1258 _item_type.code float
1259 save_
1260
1261
1262 ###################
1263 # <a name="ARRAY_STRUCTURE">ARRAY_STRUCTURE</a> #
1264 ###################
1265
1266
1267 save_ARRAY_STRUCTURE
1268 _category.description
1269 ; Data items in the <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a> category record the organization and
1270 encoding of array data that may be stored in the <a href="#ARRAY_DATA">ARRAY_DATA</a> category.
1271 ;
1272 _category.id array_structure
1273 _category.mandatory_code no
1274 _category_key.name '<a href="#_array_structure.id" >_array_structure.id</a>'
1275 loop_
1276 _category_group.id 'inclusive_group'
1277 'array_data_group'
1278 loop_
1279 _category_examples.detail
1280 _category_examples.case
1281 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1282 ; Example 1 -
1283 ;
1284 ;
1285 loop_
1286 _array_structure.id
1287 _array_structure.encoding_type
1288 _array_structure.compression_type
1289 _array_structure.byte_order
1290 image_1 "unsigned 16-bit integer" none little_endian
1291 ;
1292 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1293 save_
1294
1295
1296 save_<a name="_array_structure.byte_order" >_array_structure.byte_order</a>
1297 _item_description.description
1298 ; The order of bytes for integer values which require more
1299 than 1 byte.
1300
1301 (IBM-PC's and compatibles and DEC VAXs use low-byte-first
1302 ordered integers, whereas Hewlett Packard 700
1303 series, Sun-4 and Silicon Graphics use high-byte-first
1304 ordered integers. DEC Alphas can produce/use either
1305 depending on a compiler switch.)
1306 ;
1307
1308 _item.name '<a href="#_array_structure.byte_order" >_array_structure.byte_order</a>'
1309 _item.category_id array_structure
1310 _item.mandatory_code yes
1311 _item_type.code ucode
1312 loop_
1313 _item_enumeration.value
1314 _item_enumeration.detail
1315 'big_endian'
1316 ; The first byte in the byte stream of the bytes which make up an
1317 integer value is the most significant byte of an integer.
1318 ;
1319 'little_endian'
1320 ; The last byte in the byte stream of the bytes which make up an
1321 integer value is the most significant byte of an integer.
1322 ;
1323 save_
1324
1325
1326 save_<a name="_array_structure.compression_type" >_array_structure.compression_type</a>
1327 _item_description.description
1328 ; Type of data-compression method used to compress the array
1329 data.
1330 ;
1331 _item.name '<a href="#_array_structure.compression_type" >_array_structure.compression_type</a>'
1332 _item.category_id array_structure
1333 _item.mandatory_code no
1334 _item_type.code ucode
1335 _item_default.value 'none'
1336 loop_
1337 _item_enumeration.value
1338 _item_enumeration.detail
1339 'byte_offset'
1340 ; Using the 'byte_offset' compression scheme as per A. Hammersley
1341 and the CBFlib manual, section 3.3.3
1342 ;
1343 'canonical'
1344 ; Using the 'canonical' compression scheme (International Tables
1345 for Crystallography Volume G, Section 5.6.3.1) and CBFlib
1346 manual section 3.3.1
1347 ;
1348 'none'
1349 ; Data are stored in normal format as defined by
1350 <a href="#_array_structure.encoding_type" >_array_structure.encoding_type</a> and
1351 <a href="#_array_structure.byte_order" >_array_structure.byte_order</a>.
1352 ;
1353 'packed'
1354 ; Using the 'packed' compression scheme, a CCP4-style packing
1355 as per J. P. Abrahams pack_c.c and CBFlib manual, section 3.3.2.
1356 ;
1357 'packed_v2'
1358 ; Using the 'packed' compression scheme, version 2, as per
1359 J. P. Abrahams pack_c.c and CBFlib manual, section 3.3.2.
1360 ;
1361 save_
1362
1363 save_<a name="_array_structure.compression_type_flag" >_array_structure.compression_type_flag</a>
1364 _item_description.description
1365 ; Flags modifying the type of data-compression method used to
1366 compress the arraydata.
1367 ;
1368 _item.name '<a href="#_array_structure.compression_type_flag" >_array_structure.compression_type_flag</a>'
1369 _item.category_id array_structure
1370 _item.mandatory_code no
1371 _item_type.code ucode
1372 loop_
1373 _item_enumeration.value
1374 _item_enumeration.detail
1375 'uncorrelated_sections'
1376 ; When applying packed or packed_v2 compression on an array with
1377 uncorrelated sections, do not average in points from the prior
1378 section.
1379 ;
1380 'flat'
1381 ; When applying packed or packed_v2 compression on an array with
1382 treat the entire image as a single line set the maximum number
1383 of bits for an offset to 65 bits.
1384
1385 The flag is included for compatibility with software prior to
1386 CBFlib_0.7.7, and should not be used for new data sets.
1387
1388 ;
1389
1390 save_
1391
1392 save_<a name="_array_structure.encoding_type" >_array_structure.encoding_type</a>
1393 _item_description.description
1394 ; Data encoding of a single element of array data.
1395
1396 The type 'unsigned 1-bit integer' is used for
1397 packed Booleans arrays for masks. Each element
1398 of the array corresponds to a single bit
1399 packed in unsigned 8-bit data.
1400
1401 In several cases, the IEEE format is referenced.
1402 See IEEE Standard 754-1985 (IEEE, 1985).
1403
1404 Ref: IEEE (1985). IEEE Standard for Binary Floating-Point
1405 Arithmetic. ANSI/IEEE Std 754-1985. New York: Institute of
1406 Electrical and Electronics Engineers.
1407 ;
1408
1409 _item.name '<a href="#_array_structure.encoding_type" >_array_structure.encoding_type</a>'
1410 _item.category_id array_structure
1411 _item.mandatory_code yes
1412 _item_type.code uline
1413 loop_
1414 _item_enumeration.value
1415 'unsigned 1-bit integer'
1416 'unsigned 8-bit integer'
1417 'signed 8-bit integer'
1418 'unsigned 16-bit integer'
1419 'signed 16-bit integer'
1420 'unsigned 32-bit integer'
1421 'signed 32-bit integer'
1422 'signed 32-bit real IEEE'
1423 'signed 64-bit real IEEE'
1424 'signed 32-bit complex IEEE'
1425 save_
1426
1427
1428 save_<a name="_array_structure.id" >_array_structure.id</a>
1429 _item_description.description
1430 ; The value of <a href="#_array_structure.id" >_array_structure.id</a> must uniquely identify
1431 each item of array data.
1432
1433 This item has been made implicit and given a default value of 1
1434 as a convenience in writing miniCBF files. Normally an
1435 explicit name with useful content should be used.
1436 ;
1437 loop_
1438 _item.name
1439 _item.category_id
1440 _item.mandatory_code
1441 '<a href="#_array_structure.id" >_array_structure.id</a>' array_structure implicit
1442 '<a href="#_array_data.array_id" >_array_data.array_id</a>' array_data implicit
1443 '<a href="#_array_structure_list.array_id" >_array_structure_list.array_id</a>' array_structure_list implicit
1444 '<a href="#_array_intensities.array_id" >_array_intensities.array_id</a>' array_intensities implicit
1445 '<a href="#_diffrn_data_frame.array_id" >_diffrn_data_frame.array_id</a>' diffrn_data_frame implicit
1446
1447
1448 _item_default.value 1
1449 _item_type.code code
1450 loop_
1451 _item_linked.child_name
1452 _item_linked.parent_name
1453 '<a href="#_array_data.array_id" >_array_data.array_id</a>' '<a href="#_array_structure.id" >_array_structure.id</a>'
1454 '<a href="#_array_structure_list.array_id" >_array_structure_list.array_id</a>' '<a href="#_array_structure.id" >_array_structure.id</a>'
1455 '<a href="#_array_intensities.array_id" >_array_intensities.array_id</a>' '<a href="#_array_structure.id" >_array_structure.id</a>'
1456 '<a href="#_diffrn_data_frame.array_id" >_diffrn_data_frame.array_id</a>' '<a href="#_array_structure.id" >_array_structure.id</a>'
1457
1458 save_
1459
1460
1461 ########################
1462 # <a name="ARRAY_STRUCTURE_LIST">ARRAY_STRUCTURE_LIST</a> #
1463 ########################
1464
1465
1466 save_ARRAY_STRUCTURE_LIST
1467 _category.description
1468 ; Data items in the <a href="#ARRAY_STRUCTURE_LIST">ARRAY_STRUCTURE_LIST</a> category record the size
1469 and organization of each array dimension.
1470
1471 The relationship to physical axes may be given.
1472 ;
1473 _category.id array_structure_list
1474 _category.mandatory_code no
1475 loop_
1476 _category_key.name '<a href="#_array_structure_list.array_id" >_array_structure_list.array_id</a>'
1477 '<a href="#_array_structure_list.index" >_array_structure_list.index</a>'
1478 loop_
1479 _category_group.id 'inclusive_group'
1480 'array_data_group'
1481 loop_
1482 _category_examples.detail
1483 _category_examples.case
1484 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1485 ; Example 1 - An image array of 1300 x 1200 elements. The raster
1486 order of the image is left to right (increasing) in the
1487 first dimension and bottom to top (decreasing) in
1488 the second dimension.
1489 ;
1490 ;
1491 loop_
1492 <a href="#_array_structure_list.array_id" >_array_structure_list.array_id</a>
1493 <a href="#_array_structure_list.index" >_array_structure_list.index</a>
1494 <a href="#_array_structure_list.dimension" >_array_structure_list.dimension</a>
1495 <a href="#_array_structure_list.precedence" >_array_structure_list.precedence</a>
1496 <a href="#_array_structure_list.direction" >_array_structure_list.direction</a>
1497 <a href="#_array_structure_list.axis_id" >_array_structure_list.axis_set_id</a>
1498 image_1 1 1300 1 increasing ELEMENT_X
1499 image_1 2 1200 2 decreasing ELEMENY_Y
1500 ;
1501 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1502 save_
1503
1504
1505 save_<a name="_array_structure_list.array_id" >_array_structure_list.array_id</a>
1506 _item_description.description
1507 ; This item is a pointer to <a href="#_array_structure.id" >_array_structure.id</a> in the
1508 <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a> category.
1509 ;
1510 _item.name '<a href="#_array_structure_list.array_id" >_array_structure_list.array_id</a>'
1511 _item.category_id array_structure_list
1512 _item.mandatory_code implicit
1513 _item_type.code code
1514 save_
1515
1516
1517 save_<a name="_array_structure_list.axis_set_id" >_array_structure_list.axis_set_id</a>
1518 _item_description.description
1519 ; This is a descriptor for the physical axis or set of axes
1520 corresponding to an array index.
1521
1522 This data item is related to the axes of the detector
1523 itself given in <a href="#DIFFRN_DETECTOR_AXIS">DIFFRN_DETECTOR_AXIS</a>, but usually differs
1524 in that the axes in this category are the axes of the
1525 coordinate system of reported data points, while the axes in
1526 <a href="#DIFFRN_DETECTOR_AXIS">DIFFRN_DETECTOR_AXIS</a> are the physical axes
1527 of the detector describing the 'poise' of the detector as an
1528 overall physical object.
1529
1530 If there is only one axis in the set, the identifier of
1531 that axis should be used as the identifier of the set.
1532 ;
1533 loop_
1534 _item.name
1535 _item.category_id
1536 _item.mandatory_code
1537 '<a href="#_array_structure_list.axis_set_id" >_array_structure_list.axis_set_id</a>'
1538 array_structure_list yes
1539 '<a href="#_array_structure_list_axis.axis_set_id" >_array_structure_list_axis.axis_set_id</a>'
1540 array_structure_list_axis implicit
1541 _item_type.code code
1542 loop_
1543 _item_linked.child_name
1544 _item_linked.parent_name
1545 '<a href="#_array_structure_list_axis.axis_set_id" >_array_structure_list_axis.axis_set_id</a>'
1546 '<a href="#_array_structure_list.axis_set_id" >_array_structure_list.axis_set_id</a>'
1547
1548
1549 save_
1550
1551
1552 save_<a name="_array_structure_list.dimension" >_array_structure_list.dimension</a>
1553 _item_description.description
1554 ; The number of elements stored in the array structure in this
1555 dimension.
1556 ;
1557 _item.name '<a href="#_array_structure_list.dimension" >_array_structure_list.dimension</a>'
1558 _item.category_id array_structure_list
1559 _item.mandatory_code yes
1560 _item_type.code int
1561 loop_
1562 _item_range.maximum
1563 _item_range.minimum
1564 1 1
1565 . 1
1566 save_
1567
1568
1569 save_<a name="_array_structure_list.direction" >_array_structure_list.direction</a>
1570 _item_description.description
1571 ; Identifies the direction in which this array index changes.
1572 ;
1573 _item.name '<a href="#_array_structure_list.direction" >_array_structure_list.direction</a>'
1574 _item.category_id array_structure_list
1575 _item.mandatory_code yes
1576 _item_type.code code
1577 loop_
1578 _item_enumeration.value
1579 _item_enumeration.detail
1580
1581 'increasing'
1582 ; Indicates the index changes from 1 to the maximum dimension.
1583 ;
1584 'decreasing'
1585 ; Indicates the index changes from the maximum dimension to 1.
1586 ;
1587 save_
1588
1589
1590 save_<a name="_array_structure_list.index" >_array_structure_list.index</a>
1591 _item_description.description
1592 ; Identifies the one-based index of the row or column in the
1593 array structure.
1594 ;
1595 loop_
1596 _item.name
1597 _item.category_id
1598 _item.mandatory_code
1599 '<a href="#_array_structure_list.index" >_array_structure_list.index</a>' array_structure_list yes
1600 '<a href="#_array_structure_list.precedence" >_array_structure_list.precedence</a>' array_structure_list yes
1601 '<a href="#_array_element_size.index" >_array_element_size.index</a>' array_element_size yes
1602
1603 _item_type.code int
1604
1605 loop_
1606 _item_linked.child_name
1607 _item_linked.parent_name
1608 '<a href="#_array_element_size.index" >_array_element_size.index</a>' '<a href="#_array_structure_list.index" >_array_structure_list.index</a>'
1609 loop_
1610 _item_range.maximum
1611 _item_range.minimum
1612 1 1
1613 . 1
1614 save_
1615
1616
1617 save_<a name="_array_structure_list.precedence" >_array_structure_list.precedence</a>
1618 _item_description.description
1619 ; Identifies the rank order in which this array index changes
1620 with respect to other array indices. The precedence of 1
1621 indicates the index which changes fastest.
1622 ;
1623 _item.name '<a href="#_array_structure_list.precedence" >_array_structure_list.precedence</a>'
1624 _item.category_id array_structure_list
1625 _item.mandatory_code yes
1626 _item_type.code int
1627 loop_
1628 _item_range.maximum
1629 _item_range.minimum
1630 1 1
1631 . 1
1632 save_
1633
1634
1635 #############################
1636 # <a name="ARRAY_STRUCTURE_LIST_AXIS">ARRAY_STRUCTURE_LIST_AXIS</a> #
1637 #############################
1638
1639 save_ARRAY_STRUCTURE_LIST_AXIS
1640 _category.description
1641 ; Data items in the <a href="#ARRAY_STRUCTURE_LIST_AXIS">ARRAY_STRUCTURE_LIST_AXIS</a> category describe
1642 the physical settings of sets of axes for the centres of pixels that
1643 correspond to data points described in the
1644 <a href="#ARRAY_STRUCTURE_LIST">ARRAY_STRUCTURE_LIST</a> category.
1645
1646 In the simplest cases, the physical increments of a single axis correspond
1647 to the increments of a single array index. More complex organizations,
1648 e.g. spiral scans, may require coupled motions along multiple axes.
1649
1650 Note that a spiral scan uses two coupled axes: one for the angular
1651 direction and one for the radial direction. This differs from a
1652 cylindrical scan for which the two axes are not coupled into one set.
1653 ;
1654 _category.id array_structure_list_axis
1655 _category.mandatory_code no
1656 loop_
1657 _category_key.name
1658 '<a href="#_array_structure_list_axis.axis_set_id" >_array_structure_list_axis.axis_set_id</a>'
1659 '<a href="#_array_structure_list_axis.axis_id" >_array_structure_list_axis.axis_id</a>'
1660 loop_
1661 _category_group.id 'inclusive_group'
1662 'array_data_group'
1663 save_
1664
1665
1666 save_<a name="_array_structure_list_axis.axis_id" >_array_structure_list_axis.axis_id</a>
1667 _item_description.description
1668 ; The value of this data item is the identifier of one of
1669 the axes in the set of axes for which settings are being
1670 specified.
1671
1672 Multiple axes may be specified for the same value of
1673 <a href="#_array_structure_list_axis.axis_set_id" >_array_structure_list_axis.axis_set_id</a>.
1674
1675 This item is a pointer to <a href="#_axis.id" >_axis.id</a> in the
1676 <a href="#AXIS">AXIS</a> category.
1677 ;
1678 _item.name '<a href="#_array_structure_list_axis.axis_id" >_array_structure_list_axis.axis_id</a>'
1679 _item.category_id array_structure_list_axis
1680 _item.mandatory_code yes
1681 _item_type.code code
1682 save_
1683
1684
1685 save_<a name="_array_structure_list_axis.axis_set_id" >_array_structure_list_axis.axis_set_id</a>
1686 _item_description.description
1687 ; The value of this data item is the identifier of the
1688 set of axes for which axis settings are being specified.
1689
1690 Multiple axes may be specified for the same value of
1691 <a href="#_array_structure_list_axis.axis_set_id" >_array_structure_list_axis.axis_set_id</a>.
1692
1693 This item is a pointer to
1694 <a href="#_array_structure_list.axis_set_id" >_array_structure_list.axis_set_id</a>
1695 in the <a href="#ARRAY_STRUCTURE_LIST">ARRAY_STRUCTURE_LIST</a> category.
1696
1697 If this item is not specified, it defaults to the corresponding
1698 axis identifier.
1699 ;
1700 _item.name '<a href="#_array_structure_list_axis.axis_set_id" >_array_structure_list_axis.axis_set_id</a>'
1701 _item.category_id array_structure_list_axis
1702 _item.mandatory_code implicit
1703 _item_type.code code
1704 save_
1705
1706
1707 save_<a name="_array_structure_list_axis.angle" >_array_structure_list_axis.angle</a>
1708 _item_description.description
1709 ; The setting of the specified axis in degrees for the first
1710 data point of the array index with the corresponding value
1711 of <a href="#_array_structure_list.axis_set_id">_array_structure_list.axis_set_id</a>. If the index is
1712 specified as 'increasing', this will be the centre of the
1713 pixel with index value 1. If the index is specified as
1714 'decreasing', this will be the centre of the pixel with
1715 maximum index value.
1716 ;
1717 _item.name '<a href="#_array_structure_list_axis.angle" >_array_structure_list_axis.angle</a>'
1718 _item.category_id array_structure_list_axis
1719 _item.mandatory_code no
1720 _item_default.value 0.0
1721 _item_type.code float
1722 _item_units.code 'degrees'
1723 save_
1724
1725
1726 save_<a name="_array_structure_list_axis.angle_increment">_array_structure_list_axis.angle_increment</a>
1727 _item_description.description
1728 ; The pixel-centre-to-pixel-centre increment in the angular
1729 setting of the specified axis in degrees. This is not
1730 meaningful in the case of 'constant velocity' spiral scans
1731 and should not be specified for this case.
1732
1733 See <a href="#_array_structure_list_axis.angular_pitch">_array_structure_list_axis.angular_pitch</a>.
1734
1735 ;
1736 _item.name '<a href="#_array_structure_list_axis.angle_increment">_array_structure_list_axis.angle_increment</a>'
1737 _item.category_id array_structure_list_axis
1738 _item.mandatory_code no
1739 _item_default.value 0.0
1740 _item_type.code float
1741 _item_units.code 'degrees'
1742 save_
1743
1744
1745 save_<a name="_array_structure_list_axis.displacement" >_array_structure_list_axis.displacement</a>
1746 _item_description.description
1747 ; The setting of the specified axis in millimetres for the first
1748 data point of the array index with the corresponding value
1749 of <a href="#_array_structure_list.axis_set_id">_array_structure_list.axis_set_id</a>. If the index is
1750 specified as 'increasing', this will be the centre of the
1751 pixel with index value 1. If the index is specified as
1752 'decreasing', this will be the centre of the pixel with
1753 maximum index value.
1754 ;
1755 _item.name '<a href="#_array_structure_list_axis.displacement" >_array_structure_list_axis.displacement</a>'
1756 _item.category_id array_structure_list_axis
1757 _item.mandatory_code no
1758 _item_default.value 0.0
1759 _item_type.code float
1760 _item_units.code 'millimetres'
1761 save_
1762
1763 save_<a name="_array_structure_list_axis.fract_displacement" >_array_structure_list_axis.fract_displacement</a>
1764 _item_description.description
1765 ; The setting of the specified axis as a decimal fraction of
1766 the axis unit vector for the first data point of the array
1767 index with the corresponding value of
1768 <a href="#_array_structure_list.axis_set_id">_array_structure_list.axis_set_id</a>.
1769 If the index is specified as 'increasing', this will be the
1770 centre of the pixel with index value 1. If the index is
1771 specified as 'decreasing', this will be the centre of the
1772 pixel with maximum index value.
1773 ;
1774 _item.name '<a href="#_array_structure_list_axis.fract_displacement" >_array_structure_list_axis.fract_displacement</a>'
1775 _item.category_id array_structure_list_axis
1776 _item.mandatory_code no
1777 _item_default.value 0.0
1778 _item_type.code float
1779 save_
1780
1781 save_<a name="_array_structure_list_axis.displacement_increment">_array_structure_list_axis.displacement_increment</a>
1782 _item_description.description
1783 ; The pixel-centre-to-pixel-centre increment for the displacement
1784 setting of the specified axis in millimetres.
1785 ;
1786 _item.name
1787 '<a href="#_array_structure_list_axis.displacement_increment">_array_structure_list_axis.displacement_increment</a>'
1788 _item.category_id array_structure_list_axis
1789 _item.mandatory_code no
1790 _item_default.value 0.0
1791 _item_type.code float
1792 _item_units.code 'millimetres'
1793 save_
1794
1795 save_<a name="_array_structure_list_axis.fract_displacement_increment">_array_structure_list_axis.fract_displacement_increment</a>
1796 _item_description.description
1797 ; The pixel-centre-to-pixel-centre increment for the displacement
1798 setting of the specified axis as a decimal fraction of the
1799 axis unit vector.
1800 ;
1801 _item.name
1802 '<a href="#_array_structure_list_axis.fract_displacement_increment">_array_structure_list_axis.fract_displacement_increment</a>'
1803 _item.category_id array_structure_list_axis
1804 _item.mandatory_code no
1805 _item_default.value 0.0
1806 _item_type.code float
1807 _item_units.code 'millimetres'
1808 save_
1809
1810
1811 save_<a name="_array_structure_list_axis.angular_pitch">_array_structure_list_axis.angular_pitch</a>
1812 _item_description.description
1813 ; The pixel-centre-to-pixel-centre distance for a one-step
1814 change in the setting of the specified axis in millimetres.
1815
1816 This is meaningful only for 'constant velocity' spiral scans
1817 or for uncoupled angular scans at a constant radius
1818 (cylindrical scans) and should not be specified for cases
1819 in which the angle between pixels (rather than the distance
1820 between pixels) is uniform.
1821
1822 See <a href="#_array_structure_list_axis.angle_increment">_array_structure_list_axis.angle_increment</a>.
1823 ;
1824 _item.name '<a href="#_array_structure_list_axis.angular_pitch">_array_structure_list_axis.angular_pitch</a>'
1825 _item.category_id array_structure_list_axis
1826 _item.mandatory_code no
1827 _item_default.value 0.0
1828 _item_type.code float
1829 _item_units.code 'millimetres'
1830 save_
1831
1832
1833 save_<a name="_array_structure_list_axis.radial_pitch">_array_structure_list_axis.radial_pitch</a>
1834 _item_description.description
1835 ; The radial distance from one 'cylinder' of pixels to the
1836 next in millimetres. If the scan is a 'constant velocity'
1837 scan with differing angular displacements between pixels,
1838 the value of this item may differ significantly from the
1839 value of <a href="#_array_structure_list_axis.displacement_increment">_array_structure_list_axis.displacement_increment</a>.
1840 ;
1841 _item.name '<a href="#_array_structure_list_axis.radial_pitch">_array_structure_list_axis.radial_pitch</a>'
1842 _item.category_id array_structure_list_axis
1843 _item.mandatory_code no
1844 _item_default.value 0.0
1845 _item_type.code float
1846 _item_units.code 'millimetres'
1847 save_
1848
1849
1850 save_<a name="_array_structure_list_axis.reference_angle">_array_structure_list_axis.reference_angle</a>
1851 _item_description.description
1852 ; The value of _array_structure_list_axis.reference_angle
1853 specifies the setting of the angle of this axis used for
1854 determining a reference beam center and a reference detector
1855 distance. It is normally expected to be identical to the
1856 value of _array_structure_list.angle.
1857
1858 ;
1859 _item.name '<a href="#_array_structure_list_axis.reference_angle">_array_structure_list_axis.reference_angle</a>'
1860 _item.category_id array_structure_list_axis
1861 _item.mandatory_code implicit
1862 _item_type.code float
1863 _item_units.code 'degrees'
1864 save_
1865
1866
1867 save_<a name="_array_structure_list_axis.reference_displacement">_array_structure_list_axis.reference_displacement</a>
1868 _item_description.description
1869 ; The value of _array_structure_list_axis.reference_displacement
1870 specifies the setting of the displacement of this axis used
1871 for determining a reference beam center and a reference detector
1872 distance. It is normally expected to be identical to the value
1873 of _array_structure_list.displacement.
1874
1875 ;
1876 _item.name '<a href="#_array_structure_list_axis.reference_displacement">_array_structure_list_axis.reference_displacement</a>'
1877 _item.category_id array_structure_list_axis
1878 _item.mandatory_code implicit
1879 _item_type.code float
1880 _item_units.code 'millimetres'
1881 save_
1882
1883
1884
1885
1886 ########
1887 # <a name="AXIS">AXIS</a> #
1888 ########
1889
1890 save_AXIS
1891 _category.description
1892 ; Data items in the <a href="#AXIS">AXIS</a> category record the information required
1893 to describe the various goniometer, detector, source and other
1894 axes needed to specify a data collection or the axes defining the
1895 coordinate system of an image.
1896
1897 The location of each axis is specified by two vectors: the axis
1898 itself, given by a unit vector in the direction of the axis, and
1899 an offset to the base of the unit vector.
1900
1901 The vectors defining an axis are referenced to an appropriate
1902 coordinate system. The axis vector, itself, is a dimensionless
1903 unit vector. Where meaningful, the offset vector is given in
1904 millimetres. In coordinate systems not measured in metres,
1905 the offset is not specified and is taken as zero.
1906
1907 The available coordinate systems are:
1908
1909 The imgCIF standard laboratory coordinate system
1910 The direct lattice (fractional atomic coordinates)
1911 The orthogonal Cartesian coordinate system (real space)
1912 The reciprocal lattice
1913 An abstract orthogonal Cartesian coordinate frame
1914
1915 For consistency in this discussion, we call the three coordinate
1916 system axes <b>X</b>, <b>Y</b> and <b>Z</b>. This is appropriate for the imgCIF
1917 standard laboratory coordinate system, and last two Cartesian
1918 coordinate systems, but for the direct lattice, <b>X</b> corresponds
1919 to <b>a</b>, <b>Y</b> to <b>b</b> and <b>Z</b> to <b>c</b>, while for the reciprocal lattice,
1920 <b><b>X</b></b> corresponds to <b>a*</b>, <b>Y</b> to <b>b*</b> and <b>Z</b> to <b>c*</b>.
1921
1922 For purposes of visualization, all the coordinate systems are
1923 taken as right-handed, i.e., using the convention that the extended
1924 thumb of a right hand could point along the first (<b>X</b>) axis, the
1925 straightened pointer finger could point along the second (<b>Y</b>) axis
1926 and the middle finger folded inward could point along the third (<b>Z</b>)
1927 axis.
1928
1929 <b>THE IMGCIF STANDARD LABORATORY COORDINATE SYSTEM</b>
1930
1931 The imgCIF standard laboratory coordinate system is a right-handed
1932 orthogonal coordinate similar to the MOSFLM coordinate system,
1933 but imgCIF puts Z along the X-ray beam, rather than putting X along the
1934 X-ray beam as in MOSFLM.
1935
1936 The vectors for the imgCIF standard laboratory coordinate system
1937 form a right-handed Cartesian coordinate system with its origin
1938 in the sample or specimen. The origin of the axis system should,
1939 if possible, be defined in terms of mechanically stable axes to be
1940 be both in the sample and in the beam. If the sample goniometer or other
1941 sample positioner has two axes the intersection of which defines a
1942 unique point at which the sample should be mounted to be bathed
1943 by the beam, that will be the origin of the axis system. If no such
1944 point is defined, then the midpoint of the line of intersection
1945 between the sample and the center of the beam will define the origin.
1946 For this definition the sample positioning system will be set at
1947 its initial reference position for the experiment.
1948
1949
1950 | <b>Y</b> (to complete right-handed system)
1951 |
1952 |
1953 |
1954 |
1955 |
1956 |________________<b><b>X</b></b>
1957 / principal goniometer axis
1958 /
1959 /
1960 /
1961 /
1962 /<b>Z</b> (to source)
1963
1964
1965
1966
1967 Axis 1 (<b>X</b>): The <b>X</b>-axis is aligned to the mechanical axis pointing from
1968 the sample or specimen along the principal axis of the goniometer or
1969 sample positioning system if the sample positioning system has an axis that
1970 intersects the origin and which form an angle of more than 22.5 degrees
1971 with the beam axis.
1972
1973 Axis 2 (<b>Y</b>): The <b>Y</b>-axis completes an orthogonal right-handed system
1974 defined by the <b><b>X</b></b>-axis and the <b>Z</b>-axis (see below).
1975
1976 Axis 3 (<b>Z</b>): The <b>Z</b>-axis is derived from the source axis which goes from
1977 the sample to the source. The <b>Z</b>-axis is the component of the source axis
1978 in the direction of the source orthogonal to the <b>X</b>-axis in the plane
1979 defined by the <b>X</b>-axis and the source axis.
1980
1981 If the conditions for the <b>X</b>-axis can be met, the coordinate system
1982 will be based on the goniometer or other sample positioning system
1983 and the beam and not on the orientation of the detector, gravity etc.
1984 The vectors necessary to specify all other axes are given by sets of
1985 three components in the order (<b>X</b>, <b>Y</b>, <b>Z</b>).
1986 If the axis involved is a rotation axis, it is right-handed, i.e. as
1987 one views the object to be rotated from the origin (the tail) of the
1988 unit vector, the rotation is clockwise. If a translation axis is
1989 specified, the direction of the unit vector specifies the sense of
1990 positive translation.
1991
1992 Note: This choice of coordinate system is similar to but significantly
1993 different from the choice in MOSFLM (Leslie & Powell, 2004). In MOSFLM,
1994 <b>X</b> is along the X-ray beam (the CBF/imgCIF <b>Z</b> axis) and <b>Z</b> is along the
1995 rotation axis.
1996
1997 In some experimental techniques, there is no goniometer or the principal
1998 axis of the goniometer is at a small acute angle with respect to
1999 the source axis. In such cases, other reference axes are needed
2000 to define a useful coordinate system. The order of priority in
2001 defining directions in such cases is to use the detector, then
2002 gravity, then north.
2003
2004
2005 If the <b>X</b>-axis cannot be defined as above, then the
2006 direction (not the origin) of the X-axis should be parallel to the axis
2007 of the primary detector element corresponding to the most rapidly
2008 varying dimension of that detector element's data array, with its
2009 positive sense corresponding to increasing values of the index for
2010 that dimension. If the detector is such that such a direction cannot
2011 be defined (as with a point detector) or that direction forms an
2012 angle of less than 22.5 degrees with respect to the source axis, then
2013 the <b>X</b>-axis should be chosen so that if the <b>Y</b>-axis is chosen
2014 in the direction of gravity, and the <b>Z</b>-axis is chosen to be along
2015 the source axis, a right-handed orthogonal coordinate system is chosen.
2016 In the case of a vertical source axis, as a last resort, the
2017 <b>X</b>-axis should be chosen to point North.
2018
2019 All rotations are given in degrees and all translations are given in mm.
2020
2021 Axes may be dependent on one another. The <b>X</b>-axis is the only goniometer
2022 axis the direction of which is strictly connected to the hardware. All
2023 other axes are specified by the positions they would assume when the
2024 axes upon which they depend are at their zero points.
2025
2026 When specifying detector axes, the axis is given to the beam centre.
2027 The location of the beam centre on the detector should be given in the
2028 <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a> category in distortion-corrected millimetres from
2029 the (0,0) corner of the detector.
2030
2031 It should be noted that many different origins arise in the definition
2032 of an experiment. In particular, as noted above, it is necessary to
2033 specify the location of the beam centre on the detector in terms
2034 of the origin of the detector, which is, of course, not coincident
2035 with the centre of the sample.
2036
2037 The unit cell, reciprocal cell and crystallographic orthogonal
2038 Cartesian coordinate system are defined by the CELL and the matrices
2039 in the ATOM_SITES category.
2040
2041 <b>THE DIRECT LATTICE (FRACTIONAL COORDINATES)</b>
2042
2043 The direct lattice coordinate system is a system of fractional
2044 coordinates aligned to the crystal, rather than to the laboratory.
2045 This is a natural coordinate system for maps and atomic coordinates.
2046 It is the simplest coordinate system in which to apply symmetry.
2047 The axes are determined by the cell edges, and are not necessarily
2048 othogonal. This coordinate system is not uniquely defined and
2049 depends on the cell parameters in the CELL category and the
2050 settings chosen to index the crystal.
2051
2052 Molecules in a crystal studied by X-ray diffracraction are organized
2053 into a repeating regular array of unit cells. Each unit cell is defined
2054 by three vectors, <b>a</b>, <b>b</b> and <b>c</b>. To quote from Drenth,
2055
2056
2057 "The choice of the unit cell is not unique and therefore, guidelines
2058 have been established for selecting the standard basis vectors and
2059 the origin. They are based on symmetry and metric considerations:
2060
2061 "(1) The axial system should be right handed.
2062 (2) The basis vectors should coincide as much as possible with
2063 directions of highest symmetry."
2064 (3) The cell taken should be the smallest one that satisfies
2065 condition (2)
2066 (4) Of all the lattice vectors, none is shorter than <b>a</b>.
2067 (5) Of those not directed along <b>a</b>, none is shorter than <b>b</b>.
2068 (6) Of those not lying in the <b>ab</b> plane, none is shorter than c.
2069 (7) The three angles between the basis vectors <b>a</b>, <b>b</b> and <b>c</b> are
2070 either all acute (&lt;90&deg;) or all obtuse (&ge;90&deg;)."
2071
2072 These rules do not produce a unique result that is stable under
2073 the assumption of experimental errors, and the the resulting cell
2074 may not be primitive.
2075
2076 In this coordinate system, the vector (.5, .5, .5) is in the middle
2077 of the given unit cell.
2078
2079 Grid coordinates are an important variation on fractional coordinates
2080 used when working with maps. In imgCIF, the conversion from
2081 fractional to grid coordinates is implicit in the array indexing
2082 specified by _array_structure_list.dimension. Note that this
2083 implicit grid-coordinate scheme is 1-based, not zero-based, i.e.
2084 the origin of the cell for axes along the cell edges with no
2085 specified _array_structure_list_axis.displacement will have
2086 grid coordinates of (1,1,1), i.e. array indices of (1,1,1).
2087
2088 <b>THE ORTHOGONAL CARTESIAN COORDINATE SYSTEM (REAL SPACE)</b>
2089
2090 The orthogonal Cartesian coordinate system is a transformation of
2091 the direct lattice to the actual physical coordinates of atoms in
2092 space. It is similar to the laboratory coordinate system, but
2093 is anchored to and moves with the crystal, rather than being
2094 schored to the laboratory. The transformation from fractional
2095 to orthogonal cartesian coordinates is given by the
2096 _atom_sites.Cartn_transf_matrix[i][j] and
2097 _atom_sites.Cartn_transf_vector[i]
2098 tags. A common choice for the matrix of the transformation is
2099 given in the 1992 PDB format document
2100
2101 | a b cos(&gamma;) c cos(&beta;) |
2102 | 0 b sin(&gamma;) c (cos(&alpha;) - cos(&beta;)cos(&gamma;))/sin(&gamma;) |
2103 | 0 0 V/(a b sin(&gamma;)) |
2104
2105 This is a convenient coordinate system in which to do fitting
2106 of models to maps and in which to understand the chemistry of
2107 a molecule.
2108
2109 <b>THE RECIPROCAL LATTICE</b>
2110
2111 The reciprocal lattice coordinate system is used for diffraction
2112 intensitities. It is based on the reciprocal cell, the dual of the cell,
2113 in which reciprocal cell edges are derived from direct cell faces:
2114
2115 a* = bc sin(&alpha;)/V b* = ac sin(&beta;)/V c* = ab sin(&gamma;)/V
2116 cos(&alpha;*) = (cos(&beta;) cos(&gamma;) - cos(&alpha;))/(sin(&beta;) sin(&gamma;))
2117 cos(&beta;*) = (cos(&gamma;) cos(&gamma;) - cos(&beta;) )/(sin(&alpha;) sin(&gamma;))
2118 cos(&gamma;*) = (cos(&alpha;) cos(&beta;) - cos(&gamma;))/(sin(&alpha;) sin(&beta;))
2119 V = abc &radic;(1 - cos(&alpha;)<sup>2</sup> - cos(&beta;)<sup>2</sup> - cos(&gamma;)<sup>2</sup>
2120 + 2 cos(&alpha;) cos(&beta;) cos(&gamma;) )
2121
2122 In this form the dimensions of the reciprocal lattice are in reciprocal
2123 &Aring;ngstroms (&A<sup>-1</sup>). A dimensionless form can be obtained by
2124 multiplying by the wavelength. Reflections are commonly indexed against
2125 this coordinate system as (h, k, l) triples.
2126
2127
2128 References:
2129
2130 Drenth, J., "Introduction to basic crystallography." chapter
2131 2.1 in Rossmann, M. G. and Arnold, E. "Crystallography of
2132 biological macromolecules", Volume F of the IUCr's "International
2133 tables for crystallography", Kluwer, Dordrecht 2001, pp 44 -- 63
2134
2135 Leslie, A. G. W. and Powell, H. (2004). MOSFLM v6.11.
2136 MRC Laboratory of Molecular Biology, Hills Road, Cambridge, England.
2137 http://www.CCP4.ac.uk/dist/<b>X</b>-windows/Mosflm/.
2138
2139 Stout, G. H. and Jensen, L. H., "X-ray structure determination",
2140 2nd ed., Wiley, New York, 1989, 453 pp.
2141
2142 __, "PROTEIN DATA BANK ATOMIC COORDINATE AND BIBLIOGRAPHIC ENTRY
2143 FORMAT DESCRIPTION," Brookhaven National Laboratory, February 1992.
2144 ;
2145 _category.id axis
2146 _category.mandatory_code no
2147 loop_
2148 _category_key.name '<a href="#_axis.id" >_axis.id</a>'
2149 '_axis.equipment'
2150 loop_
2151 _category_group.id 'inclusive_group'
2152 'axis_group'
2153 'diffrn_group'
2154 loop_
2155 _category_examples.detail
2156 _category_examples.case
2157 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
2158 ; Example 1 -
2159
2160 This example shows the axis specification of the axes of a kappa-
2161 geometry goniometer [see Stout, G. H. & Jensen, L. H. (1989). X-ray
2162 structure determination. A practical
2163 guide, 2nd ed. p. 134. New York: Wiley Interscience].
2164
2165 There are three axes specified, and no offsets. The outermost axis,
2166 omega, is pointed along the <b>X</b> axis. The next innermost axis, kappa,
2167 is at a 50 degree angle to the <b>X</b> axis, pointed away from the source.
2168 The innermost axis, phi, aligns with the <b>X</b> axis when omega and
2169 phi are at their zero points. If T-omega, T-kappa and T-phi
2170 are the transformation matrices derived from the axis settings,
2171 the complete transformation would be:
2172 <b>X</b>' = (T-omega) (T-kappa) (T-phi) <b>X</b>
2173 ;
2174 ;
2175 loop_
2176 <a href="#_axis.id" >_axis.id</a>
2177 <a href="#_axis.type" >_axis.type</a>
2178 <a href="#_axis.equipment" >_axis.equipment</a>
2179 <a href="#_axis.depends_on" >_axis.depends_on</a>
2180 <a href="#_axis.vector[1]" >_axis.vector[1]</a> <a href="#_axis.vector[2]" >_axis.vector[2]</a> <a href="#_axis.vector[3]" >_axis.vector[3]</a>
2181 omega rotation goniometer . 1 0 0
2182 kappa rotation goniometer omega -.64279 0 -.76604
2183 phi rotation goniometer kappa 1 0 0
2184 ;
2185 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
2186 ; Example 2 -
2187
2188 This example shows the axis specification of the axes of a
2189 detector, source and gravity. The order has been changed as a
2190 reminder that the ordering of presentation of tokens is not
2191 significant. The centre of rotation of the detector has been taken
2192 to be 68 millimetres in the direction away from the source.
2193 ;
2194 ;
2195 loop_
2196 <a href="#_axis.id" >_axis.id</a>
2197 <a href="#_axis.type" >_axis.type</a>
2198 <a href="#_axis.equipment" >_axis.equipment</a>
2199 <a href="#_axis.depends_on" >_axis.depends_on</a>
2200 <a href="#_axis.vector[1]" >_axis.vector[1]</a> <a href="#_axis.vector[2]" >_axis.vector[2]</a> <a href="#_axis.vector[3]" >_axis.vector[3]</a>
2201 <a href="#_axis.offset[1]">_axis.offset[1]</a> <a href="#_axis.offset[2]">_axis.offset[2]</a> <a href="#_axis.offset[3]">_axis.offset[3]</a>
2202 source . source . 0 0 1 . . .
2203 gravity . gravity . 0 -1 0 . . .
2204 tranz translation detector rotz 0 0 1 0 0 -68
2205 twotheta rotation detector . 1 0 0 . . .
2206 roty rotation detector twotheta 0 1 0 0 0 -68
2207 rotz rotation detector roty 0 0 1 0 0 -68
2208 ;
2209 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
2210 ; Example 3 -
2211
2212 This example show the axis specification of the axes for a map,
2213 using fractional coordinates. Each cell edge has been divided
2214 into a grid of 50 divisions in the ARRAY_STRUCTURE_LIST_AXIS
2215 category. The map is using only the first octant of the grid
2216 in the ARRAY_STRUCTURE_LIST category.
2217
2218 The fastest changing axis is the gris along A, then along B,
2219 and the slowest is along C.
2220
2221 The map sampling is being done in the middle of each grid
2222 division
2223
2224 ;
2225 ;
2226 loop_
2227 <a href="#_axis.id" >_axis.id</a>
2228 <a href="#_axis.system">_axis.system</a>
2229 <a href="#_axis.vector[1]" >_axis.vector[1]</a> <a href="#_axis.vector[2]" >_axis.vector[2]</a> <a href="#_axis.vector[3]" >_axis.vector[3]</a>
2230 CELL_A_AXIS fractional 1 0 0
2231 CELL_B_AXIS fractional 0 1 0
2232 CELL_C_AXIS fractional 0 0 1
2233
2234 loop_
2235 _array_structure_list.array_id
2236 _array_structure_list.index
2237 _array_structure_list.dimension
2238 _array_structure_list.precedence
2239 _array_structure_list.direction
2240 _array_structure_list.axis_id
2241 MAP 1 25 1 increasing CELL_A_AXIS
2242 MAP 1 25 2 increasing CELL_B_AXIS
2243 MAP 1 25 3 increasing CELL_C_AXIS
2244
2245 loop_
2246 _array_structure_list_axis.axis_id
2247 _array_structure_list_axis.fract_displacement
2248 _array_structure_list_axis.fract_displacement_increment
2249 CELL_A_AXIS 0.01 0.02
2250 CELL_B_AXIS 0.01 0.02
2251 CELL_C_AXIS 0.01 0.02
2252
2253
2254
2255 ;
2256 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
2257 ; Example 4 -
2258
2259 This example show the axis specification of the axes for a map,
2260 this time as orthogonal Angstroms, using the same coordinate system
2261 as for the atomic coordinates. The map is sampling every 1.5
2262 Angstroms (1.5e-7 millimeters) in a map segment 37.5 Angstroms on
2263 a side.
2264
2265 ;
2266 ;
2267 loop_
2268 <a href="#_axis.id" >_axis.id</a>
2269 <a href="#_axis.system">_axis.system</a>
2270 <a href="#_axis.vector[1]" >_axis.vector[1]</a> <a href="#_axis.vector[2]" >_axis.vector[2]</a> <a href="#_axis.vector[3]" >_axis.vector[3]</a>
2271 X orthogonal 1 0 0
2272 Y orthogonal 0 1 0
2273 Z orthogonal 0 0 1
2274
2275 loop_
2276 _array_structure_list.array_id
2277 _array_structure_list.index
2278 _array_structure_list.dimension
2279 _array_structure_list.precedence
2280 _array_structure_list.direction
2281 _array_structure_list.axis_id
2282 MAP 1 25 1 increasing X
2283 MAP 2 25 2 increasing Y
2284 MAP 3 25 3 increasing Z
2285
2286 loop_
2287 _array_structure_list_axis.axis_id
2288 _array_structure_list_axis.displacement
2289 _array_structure_list_axis.displacement_increment
2290 X 7.5e-8 1.5e-7
2291 Y 7.5e-8 1.5e-7
2292 Z 7.5e-8 1.5e-7
2293
2294
2295 ;
2296 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
2297 save_
2298
2299
2300 save_<a name="_axis.depends_on" >_axis.depends_on</a>
2301 _item_description.description
2302 ; The value of <a href="#_axis.depends_on" >_axis.depends_on</a> specifies the next outermost
2303 axis upon which this axis depends.
2304
2305 This item is a pointer to <a href="#_axis.id">_axis.id</a> in the same category.
2306 ;
2307 _item.name '<a href="#_axis.depends_on">_axis.depends_on</a>'
2308 _item.category_id axis
2309 _item.mandatory_code no
2310
2311 save_
2312
2313
2314 save_<a name="_axis.equipment" >_axis.equipment</a>
2315 _item_description.description
2316 ; The value of <a href="#_axis.equipment" >_axis.equipment</a> specifies the type of
2317 equipment using the axis: 'goniometer', 'detector',
2318 'gravity', 'source' or 'general'.
2319 ;
2320 _item.name '<a href="#_axis.equipment">_axis.equipment</a>'
2321 _item.category_id axis
2322 _item.mandatory_code no
2323 _item_type.code ucode
2324 _item_default.value general
2325 loop_
2326 _item_enumeration.value
2327 _item_enumeration.detail goniometer
2328 'equipment used to orient or position samples'
2329 detector
2330 'equipment used to detect reflections'
2331 general
2332 'equipment used for general purposes'
2333 gravity
2334 'axis specifying the downward direction'
2335 source
2336 'axis specifying the direction sample to source'
2337
2338 save_
2339
2340
2341 save_<a name="_axis.offset[1]" >_axis.offset[1]</a>
2342 _item_description.description
2343 ; The [1] element of the three-element vector used to specify
2344 the offset to the base of a rotation or translation axis.
2345
2346 The vector is specified in millimetres.
2347 ;
2348 _item.name '<a href="#_axis.offset[1]">_axis.offset[1]</a>'
2349 _item.category_id axis
2350 _item.mandatory_code no
2351 _item_default.value 0.0
2352 _item_sub_category.id vector
2353 _item_type.code float
2354 _item_units.code millimetres
2355 save_
2356
2357
2358 save_<a name="_axis.offset[2]" >_axis.offset[2]</a>
2359 _item_description.description
2360 ; The [2] element of the three-element vector used to specify
2361 the offset to the base of a rotation or translation axis.
2362
2363 The vector is specified in millimetres.
2364 ;
2365 _item.name '<a href="#_axis.offset[2]">_axis.offset[2]</a>'
2366 _item.category_id axis
2367 _item.mandatory_code no
2368 _item_default.value 0.0
2369 _item_sub_category.id vector
2370 _item_type.code float
2371 _item_units.code millimetres
2372 save_
2373
2374
2375 save_<a name="_axis.offset[3]" >_axis.offset[3]</a>
2376 _item_description.description
2377 ; The [3] element of the three-element vector used to specify
2378 the offset to the base of a rotation or translation axis.
2379
2380 The vector is specified in millimetres.
2381 ;
2382 _item.name '<a href="#_axis.offset[3]">_axis.offset[3]</a>'
2383 _item.category_id axis
2384 _item.mandatory_code no
2385 _item_default.value 0.0
2386 _item_sub_category.id vector
2387 _item_type.code float
2388 _item_units.code millimetres
2389 save_
2390
2391
2392 save_<a name="_axis.id" >_axis.id</a></a>
2393 _item_description.description
2394 ; The value of <a href="#_axis.id" >_axis.id</a> must uniquely identify
2395 each axis relevant to the experiment. Note that multiple
2396 pieces of equipment may share the same axis (e.g. a twotheta
2397 arm), so the category key for <a href="#AXIS">AXIS</a> also includes the
2398 equipment.
2399 ;
2400 loop_
2401 _item.name
2402 _item.category_id
2403 _item.mandatory_code
2404 '<a href="#_axis.id" >_axis.id</a>' axis yes
2405 '<a href="#_array_structure_list_axis.axis_id" >_array_structure_list_axis.axis_id</a>'
2406 array_structure_list_axis
2407 yes
2408 '<a href="#_diffrn_detector_axis.axis_id" >_diffrn_detector_axis.axis_id</a>' diffrn_detector_axis yes
2409 '<a href="#_diffrn_measurement_axis.axis_id" >_diffrn_measurement_axis.axis_id</a>' diffrn_measurement_axis yes
2410 '<a href="#_diffrn_scan_axis.axis_id" >_diffrn_scan_axis.axis_id</a>' diffrn_scan_axis yes
2411 '<a href="#_diffrn_scan_frame_axis.axis_id" >_diffrn_scan_frame_axis.axis_id</a>' diffrn_scan_frame_axis yes
2412
2413 _item_type.code code
2414 loop_
2415 _item_linked.child_name
2416 _item_linked.parent_name
2417 '<a href="#_axis.depends_on" >_axis.depends_on</a>' '<a href="#_axis.id" >_axis.id</a>'
2418 '<a href="#_array_structure_list_axis.axis_id" >_array_structure_list_axis.axis_id</a>' '<a href="#_axis.id" >_axis.id</a>'
2419 '<a href="#_diffrn_detector_axis.axis_id" >_diffrn_detector_axis.axis_id</a>' '<a href="#_axis.id" >_axis.id</a>'
2420 '<a href="#_diffrn_measurement_axis.axis_id" >_diffrn_measurement_axis.axis_id</a>' '<a href="#_axis.id" >_axis.id</a>'
2421 '<a href="#_diffrn_scan_axis.axis_id" >_diffrn_scan_axis.axis_id</a>' '<a href="#_axis.id" >_axis.id</a>'
2422 '<a href="#_diffrn_scan_frame_axis.axis_id" >_diffrn_scan_frame_axis.axis_id</a>' '<a href="#_axis.id" >_axis.id</a>'
2423
2424 save_
2425
2426 save_<a name="_axis.system" >_axis.system</a>
2427 _item_description.description
2428 ; The value of <a href="#_axis.system" >_axis.system</a> specifies the coordinate
2429 system used to define the axis: 'laboratory', 'direct', 'orthogonal',
2430 'reciprocal' or 'abstract'.
2431 ;
2432 _item.name '<a href="#_axis.system">_axis.system</a>'
2433 _item.category_id axis
2434 _item.mandatory_code no
2435 _item_type.code ucode
2436 _item_default.value laboratory
2437 loop_
2438 _item_enumeration.value
2439 _item_enumeration.detail
2440
2441 laboratory
2442 ; the axis is referenced to the imgCIF standard laboratory Cartesian
2443 coordinate system
2444 ;
2445
2446 direct
2447 ; the axis is referenced to the direct lattice
2448 ;
2449
2450 orthogonal
2451 ; the axis is referenced to the cell Cartesian orthogonal coordinates
2452 ;
2453
2454 reciprocal
2455 ; the axis is referenced to the reciprocal lattice
2456 ;
2457
2458 abstract
2459 ; the axis is referenced to abstract Cartesian cooridinate system
2460 ;
2461
2462 save_
2463
2464
2465 save_<a name="_axis.type" >_axis.type</a>
2466 _item_description.description
2467 ; The value of <a href="#_axis.type" >_axis.type</a> specifies the type of
2468 axis: 'rotation' or 'translation' (or 'general' when
2469 the type is not relevant, as for gravity).
2470 ;
2471 _item.name '<a href="#_axis.type">_axis.type</a>'
2472 _item.category_id axis
2473 _item.mandatory_code no
2474 _item_type.code ucode
2475 _item_default.value general
2476 loop_
2477 _item_enumeration.value
2478 _item_enumeration.detail rotation
2479 'right-handed axis of rotation'
2480 translation
2481 'translation in the direction of the axis'
2482 general
2483 'axis for which the type is not relevant'
2484
2485 save_
2486
2487
2488 save_<a name="_axis.vector[1]" >_axis.vector[1]</a>
2489 _item_description.description
2490 ; The [1] element of the three-element vector used to specify
2491 the direction of a rotation or translation axis.
2492 The vector should be normalized to be a unit vector and
2493 is dimensionless.
2494 ;
2495 _item.name '<a href="#_axis.vector[1]" >_axis.vector[1]</a>'
2496 _item.category_id axis
2497 _item.mandatory_code no
2498 _item_default.value 0.0
2499 _item_sub_category.id vector
2500 _item_type.code float
2501 save_
2502
2503 save_<a name="_axis.vector[2]" >_axis.vector[2]</a>
2504 _item_description.description
2505 ; The [2] element of the three-element vector used to specify
2506 the direction of a rotation or translation axis.
2507 The vector should be normalized to be a unit vector and
2508 is dimensionless.
2509 ;
2510 _item.name '<a href="#_axis.vector[2]" >_axis.vector[2]</a>'
2511 _item.category_id axis
2512 _item.mandatory_code no
2513 _item_default.value 0.0
2514 _item_sub_category.id vector
2515 _item_type.code float
2516 save_
2517
2518 save_<a name="_axis.vector[3]" >_axis.vector[3]</a>
2519 _item_description.description
2520 ; The [3] element of the three-element vector used to specify
2521 the direction of a rotation or translation axis.
2522 The vector should be normalized to be a unit vector and
2523 is dimensionless.
2524 ;
2525 _item.name '<a href="#_axis.vector[3]" >_axis.vector[3]</a>'
2526 _item.category_id axis
2527 _item.mandatory_code no
2528 _item_default.value 0.0
2529 _item_sub_category.id vector
2530 _item_type.code float
2531 save_
2532
2533
2534
2535 #####################
2536 # <a name="DIFFRN_DATA_FRAME" >DIFFRN_DATA_FRAME</a> #
2537 #####################
2538
2539
2540 save_DIFFRN_DATA_FRAME
2541 _category.description
2542 ; Data items in the <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a> category record
2543 the details about each frame of data.
2544
2545 The items in this category were previously in a
2546 DIFFRN_FRAME_DATA category, which is now deprecated.
2547 The items from the old category are provided
2548 as aliases but should not be used for new work.
2549 ;
2550 _category.id diffrn_data_frame
2551 _category.mandatory_code no
2552 loop_
2553 _category_key.name '<a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a>'
2554 '<a href="#_diffrn_data_frame.detector_element_id" >_diffrn_data_frame.detector_element_id</a>'
2555 loop_
2556 _category_group.id 'inclusive_group'
2557 'array_data_group'
2558 loop_
2559 _category_examples.detail
2560 _category_examples.case
2561 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
2562 ; Example 1 - A frame containing data from 4 frame elements.
2563 Each frame element has a common array configuration
2564 'array_1' described in <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a> and related
2565 categories. The data for each detector element are
2566 stored in four groups of binary data in the
2567 <a href="#ARRAY_DATA">ARRAY_DATA</a> category, linked by the array_id and
2568 binary_id.
2569 ;
2570 ;
2571 loop_
2572 <a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a>
2573 <a href="#_diffrn_data_frame.detector_element_id" >_diffrn_data_frame.detector_element_id</a>
2574 <a href="#_diffrn_data_frame.array_id" >_diffrn_data_frame.array_id</a>
2575 <a href="#_diffrn_data_frame.binary_id" >_diffrn_data_frame.binary_id</a>
2576 frame_1 d1_ccd_1 array_1 1
2577 frame_1 d1_ccd_2 array_1 2
2578 frame_1 d1_ccd_3 array_1 3
2579 frame_1 d1_ccd_4 array_1 4
2580 ;
2581 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
2582 save_
2583
2584
2585 save_<a name="_diffrn_data_frame.array_id" >_diffrn_data_frame.array_id</a>
2586 _item_description.description
2587 ; This item is a pointer to <a href="#_array_structure.id" >_array_structure.id</a> in the
2588 <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a> category.
2589 ;
2590 _item.name '<a href="#_diffrn_data_frame.array_id" >_diffrn_data_frame.array_id</a>'
2591 _item.category_id diffrn_data_frame
2592 _item.mandatory_code implicit
2593 _item_aliases.alias_name '_diffrn_frame_data.array_id'
2594 _item_aliases.dictionary cif_img.dic
2595 _item_aliases.version 1.0
2596 _item_type.code code
2597 save_
2598
2599
2600 save_<a name="_diffrn_data_frame.binary_id" >_diffrn_data_frame.binary_id</a>
2601 _item_description.description
2602 ; This item is a pointer to <a href="#_array_data.binary_id" >_array_data.binary_id</a> in the
2603 <a href="#ARRAY_DATA">ARRAY_DATA</a> category.
2604 ;
2605 _item.name '<a href="#_diffrn_data_frame.binary_id" >_diffrn_data_frame.binary_id</a>'
2606 _item.category_id diffrn_data_frame
2607 _item.mandatory_code implicit
2608 _item_aliases.alias_name '_diffrn_frame_data.binary_id'
2609 _item_aliases.dictionary cif_img.dic
2610 _item_aliases.version 1.0
2611 _item_type.code int
2612 save_
2613
2614
2615 save_<a name="_diffrn_data_frame.center_fast">_diffrn_data_frame.center_fast</a>
2616 _item_description.description
2617 ; The value of <a href="#_diffrn_data_frame.center_fast">_diffrn_data_frame.center_fast</a> is
2618 the fast index axis beam center position relative to the detector
2619 element face in the units specified in the data item
2620 '<a href="#_diffrn_data_frame.center_units">_diffrn_data_frame.center_units</a>' along the fast
2621 axis of the detector from the center of the first pixel to
2622 the point at which the Z-axis (which should be colinear with the
2623 beam) intersects the face of the detector, if in fact is does.
2624 At the time of the measurement the current setting of detector
2625 positioner given frame are used.
2626
2627 It is important to note that for measurements in millimetres,
2628 the sense of the axis is used, rather than the sign of the
2629 pixel-to-pixel increments.
2630
2631 ;
2632 _item.name '<a href="#_diffrn_data_frame.center_fast">_diffrn_data_frame.center_fast</a>'
2633 _item.category_id diffrn_data_frame
2634 _item.mandatory_code no
2635 _item_type.code float
2636
2637 save_
2638
2639
2640 save_<a name="_diffrn_data_frame.center_slow">_diffrn_data_frame.center_slow</a>
2641 _item_description.description
2642 ; The value of <a href="#_diffrn_data_frame.center_slow">_diffrn_data_frame.center_slow</a> is
2643 the slow index axis beam center position relative to the detector
2644 element face in the units specified in the data item
2645 '<a href="#_diffrn_data_frame.center_units">_diffrn_data_frame.center_units</a>' along the slow
2646 axis of the detector from the center of the first pixel to
2647 the point at which the Z-axis (which should be colinear with the
2648 beam) intersects the face of the detector, if in fact is does.
2649 At the time of the measurement the current setting of detector
2650 positioner given frame are used.
2651
2652 It is important to note that the sense of the axis is used,
2653 rather than the sign of the pixel-to-pixel increments.
2654
2655 ;
2656 _item.name '<a href="#_diffrn_data_frame.center_slow">_diffrn_data_frame.center_slow</a>'
2657 _item.category_id diffrn_data_frame
2658 _item.mandatory_code no
2659 _item_type.code float
2660
2661 save_
2662
2663
2664 save_<a name="_diffrn_data_frame.center_units">_diffrn_data_frame.center_units</a>
2665 _item_description.description
2666 ; The value of <a href="#_diffrn_data_frame.center_units">_diffrn_data_frame.center_units</a>
2667 specifies the units in which the values of
2668 '<a href="#_diffrn_data_frame.center_fast">_diffrn_data_frame.center_fast</a>' and
2669 '<a href="#_diffrn_data_frame.center_slow">_diffrn_data_frame.center_slow</a>'
2670 are presented. The default is 'mm' for millimetres. The
2671 alternatives are 'pixels' and 'bins'. In all cases the
2672 center distances are measured from the center of the
2673 first pixel, i.e. in a 2x2 binning, the measuring origin
2674 is offset from the centers of the bins by one half pixel
2675 towards the first pixel.
2676
2677 If 'bins' is specified, the data in
2678 '<a href="#_array_intensities.pixel_fast_bin_size" >_array_intensities.pixel_fast_bin_size</a>',
2679 '<a href="#_array_intensities.pixel_slow_bin_size" >_array_intensities.pixel_slow_bin_size</a>', and
2680 '<a href="#_array_intensities.pixel_binning_method" >_array_intensities.pixel_binning_method</a>'
2681 is used to define the binning scheme.
2682
2683
2684 ;
2685 _item.name '<a href="#_diffrn_data_frame.center_units">_diffrn_data_frame.center_units</a>'
2686 _item.category_id diffrn_data_frame
2687 _item.mandatory_code no
2688 _item_type.code code
2689 loop_
2690 _ item_enumeration.value
2691 _ item_enumeration.detail
2692 mm 'millimetres'
2693 pixels 'detector pixels'
2694 bins 'detector bins'
2695
2696 save_
2697
2698
2699
2700
2701 save_<a name="_diffrn_data_frame.detector_element_id" >_diffrn_data_frame.detector_element_id</a>
2702 _item_description.description
2703 ; This item is a pointer to <a href="#_diffrn_detector_element.id">_diffrn_detector_element.id</a>
2704 in the <a href="#DIFFRN_DETECTOR_ELEMENT">DIFFRN_DETECTOR_ELEMENT</a> category.
2705 ;
2706 _item.name '<a href="#_diffrn_data_frame.detector_element_id" >_diffrn_data_frame.detector_element_id</a>'
2707 _item.category_id diffrn_data_frame
2708 _item.mandatory_code yes
2709 _item_aliases.alias_name '_diffrn_frame_data.detector_element_id'
2710 _item_aliases.dictionary cif_img.dic
2711 _item_aliases.version 1.0
2712 _item_type.code code
2713 save_
2714
2715
2716 save_<a name="_diffrn_data_frame.id" >_diffrn_data_frame.id</a>
2717 _item_description.description
2718 ; The value of <a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a> must uniquely identify
2719 each complete frame of data.
2720 ;
2721 loop_
2722 _item.name
2723 _item.category_id
2724 _item.mandatory_code
2725 '<a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a>' diffrn_data_frame yes
2726 '<a href="#_diffrn_refln.frame_id" >_diffrn_refln.frame_id</a>' diffrn_refln yes
2727 '<a href="#_diffrn_scan.frame_id_start" >_diffrn_scan.frame_id_start</a>' diffrn_scan yes
2728 '<a href="#_diffrn_scan.frame_id_end" >_diffrn_scan.frame_id_end</a>' diffrn_scan yes
2729 '<a href="#_diffrn_scan_frame.frame_id" >_diffrn_scan_frame.frame_id</a>' diffrn_scan_frame yes
2730 '<a href="#_diffrn_scan_frame_axis.frame_id" >_diffrn_scan_frame_axis.frame_id</a>'
2731 diffrn_scan_frame_axis
2732 yes
2733 _item_aliases.alias_name '_diffrn_frame_data.id'
2734 _item_aliases.dictionary cif_img.dic
2735 _item_aliases.version 1.0
2736 _item_type.code code
2737 loop_
2738 _item_linked.child_name
2739 _item_linked.parent_name
2740 '<a href="#_diffrn_refln.frame_id" >_diffrn_refln.frame_id</a>' '<a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a>'
2741 '<a href="#_diffrn_scan.frame_id_start" >_diffrn_scan.frame_id_start</a>' '<a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a>'
2742 '<a href="#_diffrn_scan.frame_id_end" >_diffrn_scan.frame_id_end</a>' '<a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a>'
2743 '<a href="#_diffrn_scan_frame.frame_id" >_diffrn_scan_frame.frame_id</a>' '<a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a>'
2744 '<a href="#_diffrn_scan_frame_axis.frame_id" >_diffrn_scan_frame_axis.frame_id</a>'
2745 '<a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a>'
2746 save_
2747
2748
2749 save_<a name="_diffrn_data_frame.details" >_diffrn_data_frame.details</a>
2750 _item_description.description
2751 ; The value of <a href="#_diffrn_data_frame.details" >_diffrn_data_frame.details</a> should give a
2752 description of special aspects of each frame of data.
2753
2754 This is an appropriate location in which to record
2755 information from vendor headers as presented in those
2756 headers, but it should never be used as a substitute
2757 for providing the fully parsed information within
2758 the appropriate imgCIF/CBF categories.
2759
2760 Normally, when a conversion from a miniCBF has been done
2761 the data from '<a href="#_array_data.header_convention">_array_data.header_convention</a>'
2762 should be transferred to this data item and
2763 '<a href="#_array_data.header_convention">_array_data.header_convention</a>'
2764 should be removed.
2765 ;
2766 _item.name '<a name="_diffrn_data_frame.details" >_diffrn_data_frame.details</a>'
2767 _item.category_id diffrn_data_frame
2768 _item.mandatory_code no
2769 _item_aliases.alias_name '_diffrn_frame_data.details'
2770 _item_aliases.dictionary cif_img.dic
2771 _item_aliases.version 1.4
2772 _item_type.code text
2773 loop_
2774 _item_examples.case
2775 _item_examples.detail
2776 ;
2777 HEADER_BYTES = 512;
2778 DIM = 2;
2779 BYTE_ORDER = big_endian;
2780 TYPE = unsigned_short;
2781 SIZE1 = 3072;
2782 SIZE2 = 3072;
2783 PIXEL_SIZE = 0.102588;
2784 BIN = 2x2;
2785 DETECTOR_SN = 901;
2786 TIME = 29.945155;
2787 DISTANCE = 200.000000;
2788 PHI = 85.000000;
2789 OSC_START = 85.000000;
2790 OSC_RANGE = 1.000000;
2791 WAVELENGTH = 0.979381;
2792 BEAM_CENTER_X = 157.500000;
2793 BEAM_CENTER_Y = 157.500000;
2794 PIXEL SIZE = 0.102588;
2795 OSCILLATION RANGE = 1;
2796 EXPOSURE TIME = 29.9452;
2797 TWO THETA = 0;
2798 BEAM CENTRE = 157.5 157.5;
2799 ;
2800 ; Example of header information extracted from an ADSC Quantum
2801 315 detector header by CBFlib_0.7.6. Image provided by Chris
2802 Nielsen of ADSC from a data collection at SSRL beamline 1-5.
2803 ;
2804 save_
2805
2806
2807
2808 ##########################################################################
2809 # The following is a restatement of the mmCIF <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a>, #
2810 # <a href="#DIFFRN_MEASUREMENT">DIFFRN_MEASUREMENT</a> and <a href="#DIFFRN_RADIATION">DIFFRN_RADIATION</a> categories, modified for #
2811 # the CBF/imgCIF extensions #
2812 ##########################################################################
2813
2814 ###################
2815 # <a name="DIFFRN_DETECTOR">DIFFRN_DETECTOR</a> #
2816 ###################
2817
2818
2819 save_DIFFRN_DETECTOR
2820 _category.description
2821 ; Data items in the <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a> category describe the
2822 detector used to measure the scattered radiation, including
2823 any analyser and post-sample collimation.
2824 ;
2825 _category.id diffrn_detector
2826 _category.mandatory_code no
2827 loop_
2828 _category_key.name '<a href="#_diffrn_detector.diffrn_id" >_diffrn_detector.diffrn_id</a>'
2829 '<a href="#_diffrn_detector.id" >_diffrn_detector.id</a>'
2830 loop_
2831 _category_group.id 'inclusive_group'
2832 'diffrn_group'
2833 loop_
2834 _category_examples.detail
2835 _category_examples.case
2836 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
2837 ; Example 1 - based on PDB entry 5HVP and laboratory records for the
2838 structure corresponding to PDB entry 5HVP.
2839 ;
2840 ;
2841 <a href="#_diffrn_detector.diffrn_id" >_diffrn_detector.diffrn_id</a> 'd1'
2842 <a href="#_diffrn_detector.detector" >_diffrn_detector.detector</a> 'multiwire'
2843 <a href="#_diffrn_detector.type" >_diffrn_detector.type</a> 'Siemens'
2844 ;
2845 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
2846 save_
2847
2848
2849 save_<a name="_diffrn_detector.details" >_diffrn_detector.details</a>
2850 _item_description.description
2851 ; A description of special aspects of the radiation detector.
2852 ;
2853 _item.name '<a href="#_diffrn_detector.details" >_diffrn_detector.details</a>'
2854 _item.category_id diffrn_detector
2855 _item.mandatory_code no
2856 _item_aliases.alias_name '_diffrn_detector_details'
2857 _item_aliases.dictionary cif_core.dic
2858 _item_aliases.version 2.0.1
2859 _item_type.code text
2860 _item_examples.case 'slow mode'
2861 save_
2862
2863
2864 save_<a name="_diffrn_detector.detector" >_diffrn_detector.detector</a>
2865 _item_description.description
2866 ; The general class of the radiation detector.
2867 ;
2868 _item.name '<a href="#_diffrn_detector.detector" >_diffrn_detector.detector</a>'
2869 _item.category_id diffrn_detector
2870 _item.mandatory_code no
2871 loop_
2872 _item_aliases.alias_name
2873 _item_aliases.dictionary
2874 _item_aliases.version '_diffrn_radiation_detector'
2875 cifdic.c91
2876 1.0
2877 '_diffrn_detector'
2878 cif_core.dic
2879 2.0
2880 _item_type.code text
2881 loop_
2882 _item_examples.case 'photographic film'
2883 'scintillation counter'
2884 'CCD plate'
2885 'BF~3~ counter'
2886 save_
2887
2888
2889 save_<a name="_diffrn_detector.diffrn_id" >_diffrn_detector.diffrn_id</a>
2890 _item_description.description
2891 ; This data item is a pointer to <a href="#_diffrn.id">_diffrn.id</a> in the DIFFRN
2892 category.
2893
2894 The value of <a href="#_diffrn.id">_diffrn.id</a> uniquely defines a set of
2895 diffraction data.
2896 ;
2897 _item.name '<a href="#_diffrn_detector.diffrn_id" >_diffrn_detector.diffrn_id</a>'
2898 _item.mandatory_code yes
2899 _item_type.code code
2900 save_
2901
2902
2903 save_<a name="_diffrn_detector.dtime" >_diffrn_detector.dtime</a>
2904 _item_description.description
2905 ; The deadtime in microseconds of the detector(s) used to
2906 measure the diffraction intensities.
2907 ;
2908 _item.name '<a href="#_diffrn_detector.dtime" >_diffrn_detector.dtime</a>'
2909 _item.category_id diffrn_detector
2910 _item.mandatory_code no
2911 loop_
2912 _item_aliases.alias_name
2913 _item_aliases.dictionary
2914 _item_aliases.version '_diffrn_radiation_detector_dtime'
2915 cifdic.c91
2916 1.0
2917 '_diffrn_detector_dtime'
2918 cif_core.dic
2919 2.0
2920 loop_
2921 _item_range.maximum
2922 _item_range.minimum . 0.0
2923 0.0 0.0
2924 _item_type.code float
2925 _item_units.code microseconds
2926 save_
2927
2928
2929 save_<a name="_diffrn_detector.id" >_diffrn_detector.id</a>
2930 _item_description.description
2931 ; The value of <a href="#_diffrn_detector.id" >_diffrn_detector.id</a> must uniquely identify
2932 each detector used to collect each diffraction data set.
2933
2934 If the value of <a href="#_diffrn_detector.id" >_diffrn_detector.id</a> is not given, it is
2935 implicitly equal to the value of
2936 <a href="#_diffrn_detector.diffrn_id" >_diffrn_detector.diffrn_id</a>.
2937 ;
2938 loop_
2939 _item.name
2940 _item.category_id
2941 _item.mandatory_code
2942 '<a href="#_diffrn_detector.id" >_diffrn_detector.id</a>' diffrn_detector implicit
2943 '<a href="#_diffrn_detector_axis.detector_id" >_diffrn_detector_axis.detector_id</a>'
2944 diffrn_detector_axis yes
2945 loop_
2946 _item_linked.child_name
2947 _item_linked.parent_name
2948 '<a href="#_diffrn_detector_axis.detector_id" >_diffrn_detector_axis.detector_id</a>'
2949 '_diffrn_detector.id'
2950
2951 _item_type.code code
2952 save_
2953
2954
2955 save_<a name="_diffrn_detector.number_of_axes" >_diffrn_detector.number_of_axes</a>
2956 _item_description.description
2957 ; The value of <a href="#_diffrn_detector.number_of_axes" >_diffrn_detector.number_of_axes</a> gives the
2958 number of axes of the positioner for the detector identified
2959 by <a href="#_diffrn_detector.id" >_diffrn_detector.id</a>.
2960
2961 The word 'positioner' is a general term used in
2962 instrumentation design for devices that are used to change
2963 the positions of portions of apparatus by linear
2964 translation, rotation or combinations of such motions.
2965
2966 Axes which are used to provide a coordinate system for the
2967 face of an area detetctor should not be counted for this
2968 data item.
2969
2970 The description of each axis should be provided by entries
2971 in <a href="#DIFFRN_DETECTOR_AXIS">DIFFRN_DETECTOR_AXIS</a>.
2972 ;
2973 _item.name '<a href="#_diffrn_detector.number_of_axes" >_diffrn_detector.number_of_axes</a>'
2974 _item.category_id diffrn_detector
2975 _item.mandatory_code no
2976 loop_
2977 _item_range.maximum
2978 _item_range.minimum . 1
2979 1 1
2980 _item_type.code int
2981 save_
2982
2983
2984 save_<a name="_diffrn_detector.type" >_diffrn_detector.type</a>
2985 _item_description.description
2986 ; The make, model or name of the detector device used.
2987 ;
2988 _item.name '<a href="#_diffrn_detector.type" >_diffrn_detector.type</a>'
2989 _item.category_id diffrn_detector
2990 _item.mandatory_code no
2991 _item_aliases.alias_name '_diffrn_detector_type'
2992 _item_aliases.dictionary cif_core.dic
2993 _item_aliases.version 2.0.1
2994 _item_type.code text
2995 save_
2996
2997
2998 ########################
2999 # <a name="DIFFRN_DETECTOR_AXIS" >DIFFRN_DETECTOR_AXIS</a> #
3000 ########################
3001
3002
3003 save_DIFFRN_DETECTOR_AXIS
3004 _category.description
3005 ; Data items in the <a href="#DIFFRN_DETECTOR_AXIS">DIFFRN_DETECTOR_AXIS</a> category associate
3006 axes with detectors.
3007 ;
3008 _category.id diffrn_detector_axis
3009 _category.mandatory_code no
3010 loop_
3011 _category_key.name '<a href="#_diffrn_detector_axis.detector_id" >_diffrn_detector_axis.detector_id</a>'
3012 '_diffrn_detector_axis.axis_id'
3013 loop_
3014 _category_group.id 'inclusive_group'
3015 'diffrn_group'
3016 save_
3017
3018
3019 save_<a name="_diffrn_detector_axis.axis_id" >_diffrn_detector_axis.axis_id</a>
3020 _item_description.description
3021 ; This data item is a pointer to <a href="#_axis.id" >_axis.id</a> in
3022 the AXIS category.
3023 ;
3024 _item.name '<a href="#_diffrn_detector_axis.axis_id">_diffrn_detector_axis.axis_id</a>'
3025 _item.category_id diffrn_detector_axis
3026 _item.mandatory_code yes
3027 _item_type.code code
3028 save_
3029
3030
3031 save_<a name="_diffrn_detector_axis.detector_id" >_diffrn_detector_axis.detector_id</a>
3032 _item_description.description
3033 ; This data item is a pointer to <a href="#_diffrn_detector.id" >_diffrn_detector.id</a> in
3034 the <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a> category.
3035
3036 This item was previously named _diffrn_detector_axis.id
3037 which is now a deprecated name. The old name is
3038 provided as an alias but should not be used for new work.
3039 ;
3040 _item.name '<a href="#_diffrn_detector_axis.detector_id" >_diffrn_detector_axis.detector_id</a>'
3041 _item.category_id diffrn_detector_axis
3042 _item.mandatory_code yes
3043 _item_aliases.alias_name '_diffrn_detector_axis.id'
3044 _item_aliases.dictionary cif_img.dic
3045 _item_aliases.version 1.0
3046 _item_type.code code
3047 save_
3048
3049
3050 ###########################
3051 # <a name="DIFFRN_DETECTOR_ELEMENT">DIFFRN_DETECTOR_ELEMENT</a> #
3052 ###########################
3053
3054
3055 save_DIFFRN_DETECTOR_ELEMENT
3056 _category.description
3057 ; Data items in the <a href="#DIFFRN_DETECTOR_ELEMENT">DIFFRN_DETECTOR_ELEMENT</a> category record
3058 the details about spatial layout and other characteristics
3059 of each element of a detector which may have multiple elements.
3060
3061 In most cases, giving more detailed information
3062 in <a href="#ARRAY_STRUCTURE_LIST">ARRAY_STRUCTURE_LIST</a> and <a href="#ARRAY_STRUCTURE_LIST_AXIS">ARRAY_STRUCTURE_LIST_AXIS</a>
3063 is preferable to simply providing the centre of the
3064 detector element.
3065 ;
3066 _category.id diffrn_detector_element
3067 _category.mandatory_code no
3068 loop_
3069 _category_key.name '<a href="#_diffrn_detector_element.id" >_diffrn_detector_element.id</a>'
3070 '<a href="#_diffrn_detector_element.detector_id" >_diffrn_detector_element.detector_id</a>'
3071 loop_
3072 _category_group.id 'inclusive_group'
3073 'array_data_group'
3074 loop_
3075 _category_examples.detail
3076 _category_examples.case
3077 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
3078 ; Example 1 - Detector d1 is composed of four CCD detector elements,
3079 each 200 mm by 200 mm, arranged in a square, in the pattern
3080
3081 1 2
3082 *
3083 3 4
3084
3085 Note that the beam centre is slightly displaced from each of the
3086 detector elements, just beyond the lower right corner of 1,
3087 the lower left corner of 2, the upper right corner of 3 and
3088 the upper left corner of 4. For each element, the detector
3089 face coordiate system, is assumed to have the fast axis
3090 running from left to right and the slow axis running from
3091 top to bottom with the origin at the top left corner.
3092 ;
3093 ;
3094 loop_
3095 <a href="#_diffrn_detector_element.detector_id" >_diffrn_detector_element.detector_id</a>
3096 <a href="#_diffrn_detector_element.id" >_diffrn_detector_element.id</a>
3097 <a href="#_diffrn_data_frame.center_fast" >_diffrn_detector_element.reference_center_fast</a>
3098 <a href="#_diffrn_detector_element.reference_center_slow" >_diffrn_detector_element.reference_center_slow</a>
3099 <a href="#_diffrn_detector_element.reference_center_units" >_diffrn_detector_element.reference_center_units</a>
3100 d1 d1_ccd_1 201.5 201.5 mm
3101 d1 d1_ccd_2 -1.8 201.5 mm
3102 d1 d1_ccd_3 201.6 -1.4 mm
3103 d1 d1_ccd_4 -1.7 -1.5 mm
3104 ;
3105 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
3106 save_
3107
3108
3109
3110 save_<a name="_diffrn_detector_element.id" >_diffrn_detector_element.id</a>
3111 _item_description.description
3112 ; The value of <a href="#_diffrn_detector_element.id" >_diffrn_detector_element.id</a> must uniquely
3113 identify each element of a detector.
3114 ;
3115 loop_
3116 _item.name
3117 _item.category_id
3118 _item.mandatory_code
3119 '<a href="#_diffrn_detector_element.id" >_diffrn_detector_element.id</a>'
3120 diffrn_detector_element
3121 yes
3122 _item_type.code code
3123 loop_
3124 _item_linked.child_name
3125 _item_linked.parent_name
3126 '<a href="#_diffrn_data_frame.detector_element_id" >_diffrn_data_frame.detector_element_id</a>'
3127 '<a href="#_diffrn_detector_element.id" >_diffrn_detector_element.id</a>'
3128
3129 save_
3130
3131
3132 save_<a name="_diffrn_detector_element.detector_id" >_diffrn_detector_element.detector_id</a>
3133 _item_description.description
3134 ; This item is a pointer to <a href="#_diffrn_detector.id" >_diffrn_detector.id</a>
3135 in the <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a> category.
3136 ;
3137 _item.name '<a href="#_diffrn_detector_element.detector_id" >_diffrn_detector_element.detector_id</a>'
3138 _item.category_id diffrn_detector_element
3139 _item.mandatory_code yes
3140 _item_type.code code
3141 save_
3142
3143 save_<a name="_diffrn_detector_element.reference_center_fast">_diffrn_detector_element.reference_center_fast</a>
3144 _item_description.description
3145 ; The value of <a href="#_diffrn_detector_element.reference_center_fast">_diffrn_detector_element.reference_center_fast</a> is
3146 the fast index axis beam center position relative to the detector
3147 element face in the units specified in the data item
3148 '<a href="#_diffrn_detector_element.reference_center_units">_diffrn_detector_element.reference_center_units</a>' along the fast
3149 axis of the detector from the center of the first pixel to
3150 the point at which the Z-axis (which should be colinear with the
3151 beam) intersects the face of the detector, if in fact is does.
3152 At the time of the measurement all settings of the detector
3153 positioner should be at their reference settings. If more than
3154 one reference setting has been used the value given whould be
3155 representive of the beam center as determined from the ensemble
3156 of settings.
3157
3158 It is important to note that for measurements in millimetres,
3159 the sense of the axis is used, rather than the sign of the
3160 pixel-to-pixel increments.
3161
3162 ;
3163 _item.name '<a href="#_diffrn_detector_element.reference_center_fast">_diffrn_detector_element.reference_center_fast</a>'
3164 _item.category_id diffrn_detector_element
3165 _item.mandatory_code no
3166 _item_type.code float
3167
3168 save_
3169
3170
3171 save_<a name="_diffrn_detector_element.reference_center_slow">_diffrn_detector_element.reference_center_slow</a>
3172 _item_description.description
3173 ; The value of <a href="#_diffrn_detector_element.reference_center_slow">_diffrn_detector_element.reference_center_slow</a> is
3174 the slow index axis beam center position relative to the detector
3175 element face in the units specified in the data item
3176 '<a href="#_diffrn_detector_element.reference_center_units">_diffrn_detector_element.reference_center_units</a>' along the slow
3177 axis of the detector from the center of the first pixel to
3178 the point at which the Z-axis (which should be colinear with the
3179 beam) intersects the face of the detector, if in fact is does.
3180 At the time of the measurement all settings of the detector
3181 positioner should be at their reference settings. If more than
3182 one reference setting has been used the value givien whould be
3183 representive of the beam center as determined from the ensemble
3184 of settings.
3185
3186 It is important to note that the sense of the axis is used,
3187 rather than the sign of the pixel-to-pixel increments.
3188
3189 ;
3190 _item.name '<a href="#_diffrn_detector_element.reference_center_slow">_diffrn_detector_element.reference_center_slow</a>'
3191 _item.category_id diffrn_detector_element
3192 _item.mandatory_code no
3193 _item_type.code float
3194
3195 save_
3196
3197
3198 save_<a name="_diffrn_detector_element.reference_center_units">_diffrn_detector_element.reference_center_units</a>
3199 _item_description.description
3200 ; The value of <a href="#_diffrn_detector_element.reference_center_units">_diffrn_detector_element.reference_center_units</a>
3201 specifies the units in which the values of
3202 '<a href="#_diffrn_detector_element.reference_center_fast">_diffrn_detector_element.reference_center_fast</a>' and
3203 '<a href="#_diffrn_detector_element.reference_center_slow">_diffrn_detector_element.reference_center_slow</a>'
3204 are presented. The default is 'mm' for millimetres. The
3205 alternatives are 'pixels' and 'bins'. In all cases the
3206 center distances are measured from the center of the
3207 first pixel, i.e. in a 2x2 binning, the measuring origin
3208 is offset from the centers of the bins by one half pixel
3209 towards the first pixel.
3210
3211 If 'bins' is specified, the data in
3212 '<a href="#_array_intensities.pixel_fast_bin_size" >_array_intensities.pixel_fast_bin_size</a>',
3213 '<a href="#_array_intensities.pixel_slow_bin_size" >_array_intensities.pixel_slow_bin_size</a>', and
3214 '<a href="#_array_intensities.pixel_binning_method" >_array_intensities.pixel_binning_method</a>'
3215 is used to define the binning scheme.
3216
3217
3218 ;
3219 _item.name '<a href="#_diffrn_detector_element.reference_center_units">_diffrn_detector_element.reference_center_units</a>'
3220 _item.category_id diffrn_detector_element
3221 _item.mandatory_code no
3222 _item_type.code code
3223 loop_
3224 _ item_enumeration.value
3225 _ item_enumeration.detail
3226 mm 'millimetres'
3227 pixels 'detector pixels'
3228 bins 'detector bins'
3229
3230 save_
3231
3232
3233 ########################
3234 ## <a name="DIFFRN_MEASUREMENT" >DIFFRN_MEASUREMENT</a> ##
3235 ########################
3236
3237
3238 save_DIFFRN_MEASUREMENT
3239 _category.description
3240 ; Data items in the <a href="#DIFFRN_MEASUREMENT">DIFFRN_MEASUREMENT</a> category record details
3241 about the device used to orient and/or position the crystal
3242 during data measurement and the manner in which the
3243 diffraction data were measured.
3244 ;
3245 _category.id diffrn_measurement
3246 _category.mandatory_code no
3247 loop_
3248 _category_key.name '<a href="#_diffrn_measurement.device" >_diffrn_measurement.device</a>'
3249 '<a href="#_diffrn_measurement.diffrn_id" >_diffrn_measurement.diffrn_id</a>'
3250 '<a href="#_diffrn_measurement.id" >_diffrn_measurement.id</a>'
3251 loop_
3252 _category_group.id 'inclusive_group'
3253 'diffrn_group'
3254 loop_
3255 _category_examples.detail
3256 _category_examples.case
3257 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
3258 ; Example 1 - based on PDB entry 5HVP and laboratory records for the
3259 structure corresponding to PDB entry 5HVP
3260 ;
3261 ;
3262 <a href="#_diffrn_measurement.diffrn_id" >_diffrn_measurement.diffrn_id</a> 'd1'
3263 <a href="#_diffrn_measurement.device" >_diffrn_measurement.device</a> '3-circle camera'
3264 <a href="#_diffrn_measurement.device_type" >_diffrn_measurement.device_type</a> 'Supper model <b>X</b>'
3265 <a href="#_diffrn_measurement.device_details" >_diffrn_measurement.device_details</a> 'none'
3266 <a href="#_diffrn_measurement.method" >_diffrn_measurement.method</a> 'omega scan'
3267 <a href="#_diffrn_measurement.details" >_diffrn_measurement.details</a>
3268 ; 440 frames, 0.20 degrees, 150 sec, detector distance 12 cm, detector
3269 angle 22.5 degrees
3270 ;
3271 ;
3272 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
3273 ; Example 2 - based on data set TOZ of Willis, Beckwith & Tozer
3274 [Acta Cryst. (1991), C47, 2276-2277].
3275 ;
3276 ;
3277 <a href="#_diffrn_measurement.diffrn_id" >_diffrn_measurement.diffrn_id</a> 's1'
3278 <a href="#_diffrn_measurement.device_type" >_diffrn_measurement.device_type</a> 'Philips PW1100/20 diffractometer'
3279 <a href="#_diffrn_measurement.method" >_diffrn_measurement.method</a> 'theta/2theta (\q/2\q)'
3280 ;
3281 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
3282 save_
3283
3284
3285 save_<a name="_diffrn_measurement.device" >_diffrn_measurement.device</a>
3286 _item_description.description
3287 ; The general class of goniometer or device used to support
3288 and orient the specimen.
3289
3290 If the value of <a href="#_diffrn_measurement.device">_diffrn_measurement.device</a> is not given,
3291 it is implicitly equal to the value of
3292 <a href="#_diffrn_measurement.diffrn_id">_diffrn_measurement.diffrn_id</a>.
3293
3294 Either <a href="#_diffrn_measurement.device">_diffrn_measurement.device</a> or
3295 <a href="#_diffrn_measurement.id">_diffrn_measurement.id</a> may be used to link to other
3296 categories. If the experimental setup admits multiple
3297 devices, then <a href="#_diffrn_measurement.id">_diffrn_measurement.id</a> is used to provide
3298 a unique link.
3299 ;
3300 loop_
3301 _item.name
3302 _item.category_id
3303 _item.mandatory_code
3304 '<a href="#_diffrn_measurement.device">_diffrn_measurement.device</a>' diffrn_measurement implicit
3305 '<a href="#_diffrn_measurement_axis.measurement_device">_diffrn_measurement_axis.measurement_device</a>'
3306 diffrn_measurement_axis implicit
3307 loop_
3308 _item_linked.child_name
3309 _item_linked.parent_name
3310 '<a href="#_diffrn_measurement_axis.measurement_device">_diffrn_measurement_axis.measurement_device</a>'
3311 '_diffrn_measurement.device'
3312 _item_aliases.alias_name '_diffrn_measurement_device'
3313 _item_aliases.dictionary cif_core.dic
3314 _item_aliases.version 2.0.1
3315 _item_type.code text
3316 loop_
3317 _item_examples.case '3-circle camera'
3318 '4-circle camera'
3319 'kappa-geometry camera'
3320 'oscillation camera'
3321 'precession camera'
3322 save_
3323
3324
3325 save_<a name="_diffrn_measurement.device_details" >_diffrn_measurement.device_details</a>
3326 _item_description.description
3327 ; A description of special aspects of the device used to
3328 measure the diffraction intensities.
3329 ;
3330 _item.name '<a href="#_diffrn_measurement.device_details" >_diffrn_measurement.device_details</a>'
3331 _item.category_id diffrn_measurement
3332 _item.mandatory_code no
3333 _item_aliases.alias_name '_diffrn_measurement_device_details'
3334 _item_aliases.dictionary cif_core.dic
3335 _item_aliases.version 2.0.1
3336 _item_type.code text
3337 _item_examples.case
3338 ; commercial goniometer modified locally to
3339 allow for 90\% \t arc
3340 ;
3341 save_
3342
3343
3344 save_<a name="_diffrn_measurement.device_type" >_diffrn_measurement.device_type</a>
3345 _item_description.description
3346 ; The make, model or name of the measurement device
3347 (goniometer) used.
3348 ;
3349 _item.name '<a href="#_diffrn_measurement.device_type" >_diffrn_measurement.device_type</a>'
3350 _item.category_id diffrn_measurement
3351 _item.mandatory_code no
3352 _item_aliases.alias_name '_diffrn_measurement_device_type'
3353 _item_aliases.dictionary cif_core.dic
3354 _item_aliases.version 2.0.1
3355 _item_type.code text
3356 loop_
3357 _item_examples.case 'Supper model q'
3358 'Huber model r'
3359 'Enraf-Nonius model s'
3360 'home-made'
3361 save_
3362
3363
3364 save_<a name="_diffrn_measurement.diffrn_id" >_diffrn_measurement.diffrn_id</a>
3365 _item_description.description
3366 ; This data item is a pointer to <a href="#_diffrn.id">_diffrn.id</a> in the DIFFRN
3367 category.
3368 ;
3369 _item.name '<a href="#_diffrn_measurement.diffrn_id" >_diffrn_measurement.diffrn_id</a>'
3370 _item.mandatory_code yes
3371 _item_type.code code
3372 save_
3373
3374
3375 save_<a name="_diffrn_measurement.details" >_diffrn_measurement.details</a>
3376 _item_description.description
3377 ; A description of special aspects of the intensity
3378 measurement.
3379 ;
3380 _item.name '<a href="#_diffrn_measurement.details" >_diffrn_measurement.details</a>'
3381 _item.category_id diffrn_measurement
3382 _item.mandatory_code no
3383 _item_aliases.alias_name '_diffrn_measurement_details'
3384 _item_aliases.dictionary cif_core.dic
3385 _item_aliases.version 2.0.1
3386 _item_type.code text
3387 _item_examples.case
3388 ; 440 frames, 0.20 degrees, 150 sec, detector
3389 distance 12 cm, detector angle 22.5 degrees
3390 ;
3391 save_
3392
3393
3394 save_<a name="_diffrn_measurement.id" >_diffrn_measurement.id</a>
3395 _item_description.description
3396 ; The value of <a href="#_diffrn_measurement.id" >_diffrn_measurement.id</a> must uniquely identify
3397 the set of mechanical characteristics of the device used to
3398 orient and/or position the sample used during the collection
3399 of each diffraction data set.
3400
3401 If the value of <a href="#_diffrn_measurement.id" >_diffrn_measurement.id</a> is not given, it is
3402 implicitly equal to the value of
3403 <a href="#_diffrn_measurement.diffrn_id" >_diffrn_measurement.diffrn_id</a>.
3404
3405 Either <a href="#_diffrn_measurement.device">_diffrn_measurement.device</a> or
3406 <a href="#_diffrn_measurement.id">_diffrn_measurement.id</a> may be used to link to other
3407 categories. If the experimental setup admits multiple
3408 devices, then <a href="#_diffrn_measurement.id">_diffrn_measurement.id</a> is used to provide
3409 a unique link.
3410 ;
3411 loop_
3412 _item.name
3413 _item.category_id
3414 _item.mandatory_code
3415 '<a href="#_diffrn_measurement.id" >_diffrn_measurement.id</a>' diffrn_measurement implicit
3416 '<a href="#_diffrn_measurement_axis.measurement_id" >_diffrn_measurement_axis.measurement_id</a>'
3417 diffrn_measurement_axis implicit
3418 loop_
3419 _item_linked.child_name
3420 _item_linked.parent_name
3421 '<a href="#_diffrn_measurement_axis.measurement_id" >_diffrn_measurement_axis.measurement_id</a>'
3422 '<a href="#_diffrn_measurement.id" >_diffrn_measurement.id</a>'
3423
3424 _item_type.code code
3425 save_
3426
3427
3428 save_<a name="_diffrn_measurement.method" >_diffrn_measurement.method</a>
3429 _item_description.description
3430 ; Method used to measure intensities.
3431 ;
3432 _item.name '<a href="#_diffrn_measurement.method" >_diffrn_measurement.method</a>'
3433 _item.category_id diffrn_measurement
3434 _item.mandatory_code no
3435 _item_aliases.alias_name '_diffrn_measurement_method'
3436 _item_aliases.dictionary cif_core.dic
3437 _item_aliases.version 2.0.1
3438 _item_type.code text
3439 _item_examples.case
3440 'profile data from theta/2theta (\q/2\q) scans'
3441 save_
3442
3443
3444 save_<a name="_diffrn_measurement.number_of_axes" >_diffrn_measurement.number_of_axes</a>
3445 _item_description.description
3446 ; The value of <a href="#_diffrn_measurement.number_of_axes" >_diffrn_measurement.number_of_axes</a> gives the
3447 number of axes of the positioner for the goniometer or
3448 other sample orientation or positioning device identified
3449 by <a href="#_diffrn_measurement.id" >_diffrn_measurement.id</a>.
3450
3451 The description of the axes should be provided by entries in
3452 <a href="#DIFFRN_MEASUREMENT_AXIS">DIFFRN_MEASUREMENT_AXIS</a>.
3453 ;
3454 _item.name '<a href="#_diffrn_measurement.number_of_axes" >_diffrn_measurement.number_of_axes</a>'
3455 _item.category_id diffrn_measurement
3456 _item.mandatory_code no
3457 loop_
3458 _item_range.maximum
3459 _item_range.minimum . 1
3460 1 1
3461 _item_type.code int
3462 save_
3463
3464
3465 # <a href="#_diffrn_measurement.sample_detector_distance" >_diffrn_measurement.sample_detector_distance</a>
3466 # <a href="#_diffrn_measurement.sample_detector_voffset" >_diffrn_measurement.sample_detector_voffset</a>
3467
3468 save_<a name="_diffrn_measurement.sample_detector_distance" >_diffrn_measurement.sample_detector_distance</a>
3469 _item_description.description
3470 ; The value of <a href="#_diffrn_measurement.sample_detector_distance" >_diffrn_measurement.sample_detector_distance</a> gives the
3471 unsigned distance in millimetres from the sample to the
3472 detector along the beam.
3473 ;
3474 _item.name '<a href="#_diffrn_measurement.sample_detector_distance" >_diffrn_measurement.sample_detector_distance</a>'
3475 _item.category_id diffrn_measurement
3476 _item.mandatory_code no
3477 loop_
3478 _item_range.maximum
3479 _item_range.minimum . 0.0
3480 _item_type.code float
3481 _item_units.code mm
3482 save_
3483
3484 save_<a name="_diffrn_measurement.sample_detector_voffset" >_diffrn_measurement.sample_detector_voffset</a>
3485 _item_description.description
3486 ; The value of <a href="#_diffrn_measurement.sample_detector_voffset" >_diffrn_measurement.sample_detector_voffset</a> gives the
3487 signed distance in millimetres in the vertical
3488 direction (positive for up) from the center of
3489 the beam to the center of the detector.
3490 ;
3491 _item.name '<a href="#_diffrn_measurement.sample_detector_voffset" >_diffrn_measurement.sample_detector_voffset</a>'
3492 _item.category_id diffrn_measurement
3493 _item.mandatory_code no
3494 loop_
3495 _item_range.maximum
3496 _item_range.minimum . .
3497 . .
3498 _item_type.code float
3499 _item_units.code mm
3500 save_
3501
3502
3503 save_<a name="_diffrn_measurement.specimen_support" >_diffrn_measurement.specimen_support</a>
3504 _item_description.description
3505 ; The physical device used to support the crystal during data
3506 collection.
3507 ;
3508 _item.name '<a href="#_diffrn_measurement.specimen_support" >_diffrn_measurement.specimen_support</a>'
3509 _item.category_id diffrn_measurement
3510 _item.mandatory_code no
3511 _item_aliases.alias_name '_diffrn_measurement_specimen_support'
3512 _item_aliases.dictionary cif_core.dic
3513 _item_aliases.version 2.0.1
3514 _item_type.code text
3515 loop_
3516 _item_examples.case 'glass capillary'
3517 'quartz capillary'
3518 'fiber'
3519 'metal loop'
3520 save_
3521
3522
3523 ###########################
3524 # <a name="DIFFRN_MEASUREMENT_AXIS">DIFFRN_MEASUREMENT_AXIS</a> #
3525 ###########################
3526
3527
3528 save_DIFFRN_MEASUREMENT_AXIS
3529 _category.description
3530 ; Data items in the <a href="#DIFFRN_MEASUREMENT_AXIS">DIFFRN_MEASUREMENT_AXIS</a> category associate
3531 axes with goniometers.
3532 ;
3533 _category.id diffrn_measurement_axis
3534 _category.mandatory_code no
3535 loop_
3536 _category_key.name
3537 '<a href="#_diffrn_measurement_axis.measurement_device" >_diffrn_measurement_axis.measurement_device</a>'
3538 '<a href="#_diffrn_measurement_axis.measurement_id" >_diffrn_measurement_axis.measurement_id</a>'
3539 '<a href="#_diffrn_measurement_axis.axis_id" >_diffrn_measurement_axis.axis_id</a>'
3540 loop_
3541 _category_group.id 'inclusive_group'
3542 'diffrn_group'
3543 save_
3544
3545
3546 save_<a name="_diffrn_measurement_axis.axis_id" >_diffrn_measurement_axis.axis_id</a>
3547 _item_description.description
3548 ; This data item is a pointer to <a href="#_axis.id" >_axis.id</a> in
3549 the <a href="#AXIS">AXIS</a> category.
3550 ;
3551 _item.name '<a href="#_diffrn_measurement_axis.axis_id" >_diffrn_measurement_axis.axis_id</a>'
3552 _item.category_id diffrn_measurement_axis
3553 _item.mandatory_code yes
3554 _item_type.code code
3555 save_
3556
3557
3558 save_<A name="_diffrn_measurement_axis.measurement_device">_diffrn_measurement_axis.measurement_device</a>
3559 _item_description.description
3560 ; This data item is a pointer to <a href="#_diffrn_measurement.device">_diffrn_measurement.device</a>
3561 in the <a href="#DIFFRN_MEASUREMENT">DIFFRN_MEASUREMENT</a> category.
3562 ;
3563 _item.name
3564 '<a href="#_diffrn_measurement_axis.measurement_device">_diffrn_measurement_axis.measurement_device</a>'
3565 _item.category_id diffrn_measurement_axis
3566 _item.mandatory_code implicit
3567 _item_type.code text
3568 save_
3569
3570
3571 save_<a name="_diffrn_measurement_axis.measurement_id">_diffrn_measurement_axis.measurement_id</a>
3572 _item_description.description
3573 ; This data item is a pointer to <a href="#_diffrn_measurement.id">_diffrn_measurement.id</a> in
3574 the <a href="#DIFFRN_MEASUREMENT">DIFFRN_MEASUREMENT</a> category.
3575
3576 This item was previously named _diffrn_measurement_axis.id,
3577 which is now a deprecated name. The old name is
3578 provided as an alias but should not be used for new work.
3579 ;
3580 _item.name '<a href="#_diffrn_measurement_axis.measurement_id">_diffrn_measurement_axis.measurement_id</a>'
3581 _item.category_id diffrn_measurement_axis
3582 _item.mandatory_code implicit
3583 _item_aliases.alias_name '_diffrn_measurement_axis.id'
3584 _item_aliases.dictionary cif_img.dic
3585 _item_aliases.version 1.0
3586 _item_type.code code
3587 save_
3588
3589
3590 ####################
3591 # <a name="DIFFRN_RADIATION">DIFFRN_RADIATION</a> #
3592 ####################
3593
3594
3595 save_DIFFRN_RADIATION
3596 _category.description
3597 ; Data items in the <a href="#DIFFRN_RADIATION">DIFFRN_RADIATION</a> category describe
3598 the radiation used for measuring diffraction intensities,
3599 its collimation and monochromatization before the sample.
3600
3601 Post-sample treatment of the beam is described by data
3602 items in the <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a> category.
3603 ;
3604 _category.id diffrn_radiation
3605 _category.mandatory_code no
3606 _category_key.name '<a href="#_diffrn_radiation.diffrn_id">_diffrn_radiation.diffrn_id</a>'
3607 loop_
3608 _category_group.id 'inclusive_group'
3609 'diffrn_group'
3610 loop_
3611 _category_examples.detail
3612 _category_examples.case
3613 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
3614 ; Example 1 - based on PDB entry 5HVP and laboratory records for the
3615 structure corresponding to PDB entry 5HVP
3616 ;
3617 ;
3618 <a href="#_diffrn_radiation.diffrn_id">_diffrn_radiation.diffrn_id</a> 'set1'
3619
3620 <a href="#_diffrn_radiation.collimation">_diffrn_radiation.collimation</a> '0.3 mm double pinhole'
3621 <a href="#_diffrn_radiation.monochromator">_diffrn_radiation.monochromator</a> 'graphite'
3622 <a href="#_diffrn_radiation.type">_diffrn_radiation.type</a> 'Cu K\a'
3623 <a href="#_diffrn_radiation.wavelength_id">_diffrn_radiation.wavelength_id</a> 1
3624 ;
3625 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
3626 ; Example 2 - based on data set TOZ of Willis, Beckwith & Tozer
3627 [Acta Cryst. (1991), C47, 2276-2277].
3628 ;
3629 ;
3630 <a href="#_diffrn_radiation.wavelength_id">_diffrn_radiation.wavelength_id</a> 1
3631 <a href="#_diffrn_radiation.type">_diffrn_radiation.type</a> 'Cu K\a'
3632 <a href="#_diffrn_radiation.monochromator">_diffrn_radiation.monochromator</a> 'graphite'
3633 ;
3634 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
3635 save_
3636
3637 save_<A name="_diffrn_radiation.collimation">_diffrn_radiation.collimation</a>
3638 _item_description.description
3639 ; The collimation or focusing applied to the radiation.
3640 ;
3641 _item.name '<a href="#_diffrn_radiation.collimation">_diffrn_radiation.collimation</a>'
3642 _item.category_id diffrn_radiation
3643 _item.mandatory_code no
3644 _item_aliases.alias_name '_diffrn_radiation_collimation'
3645 _item_aliases.dictionary cif_core.dic
3646 _item_aliases.version 2.0.1
3647 _item_type.code text
3648 loop_
3649 _item_examples.case '0.3 mm double-pinhole'
3650 '0.5 mm'
3651 'focusing mirrors'
3652 save_
3653
3654
3655 save_<A name="_diffrn_radiation.diffrn_id">_diffrn_radiation.diffrn_id</a>
3656 _item_description.description
3657 ; This data item is a pointer to <a href="#_diffrn.id">_diffrn.id</a> in the DIFFRN
3658 category.
3659 ;
3660 _item.name '<a href="#_diffrn_radiation.diffrn_id">_diffrn_radiation.diffrn_id</a>'
3661 _item.mandatory_code yes
3662 _item_type.code code
3663 save_
3664
3665
3666
3667 save_<a name="_diffrn_radiation.div_x_source">_diffrn_radiation.div_x_source</a>
3668 _item_description.description
3669 ; Beam crossfire in degrees parallel to the laboratory <b>X</b> axis
3670 (see <a href="#AXIS">AXIS</a> category).
3671
3672 This is a characteristic of the X-ray beam as it illuminates
3673 the sample (or specimen) after all monochromation and
3674 collimation.
3675
3676 This is the standard uncertainty (e.s.d.) of the directions of
3677 photons in the XZ plane around the mean source beam
3678 direction.
3679
3680 Note that for some synchrotrons this value is specified
3681 in milliradians, in which case a conversion is needed.
3682 To convert a value in milliradians to a value in degrees,
3683 multiply by 0.180 and divide by \p.
3684 ;
3685 _item.name '<a href="#_diffrn_radiation.div_x_source">_diffrn_radiation.div_x_source</a>'
3686 _item.category_id diffrn_radiation
3687 _item.mandatory_code no
3688 _item_type.code float
3689 _item_units.code degrees
3690 save_
3691
3692
3693 save_<A name="_diffrn_radiation.div_y_source">_diffrn_radiation.div_y_source</a>
3694 _item_description.description
3695 ; Beam crossfire in degrees parallel to the laboratory <b>Y</b> axis
3696 (see <a href="#AXIS">AXIS</a> category).
3697
3698 This is a characteristic of the X-ray beam as it illuminates
3699 the sample (or specimen) after all monochromation and
3700 collimation.
3701
3702 This is the standard uncertainty (e.s.d.) of the directions
3703 of photons in the YZ plane around the mean source beam
3704 direction.
3705
3706 Note that for some synchrotrons this value is specified
3707 in milliradians, in which case a conversion is needed.
3708 To convert a value in milliradians to a value in degrees,
3709 multiply by 0.180 and divide by \p.
3710 ;
3711 _item.name '<a href="#_diffrn_radiation.div_y_source">_diffrn_radiation.div_y_source</a>'
3712 _item.category_id diffrn_radiation
3713 _item.mandatory_code no
3714 _item_type.code float
3715 _item_units.code degrees
3716 _item_default.value 0.0
3717 save_
3718
3719
3720 save_<A name="_diffrn_radiation.div_x_y_source">_diffrn_radiation.div_x_y_source</a>
3721 _item_description.description
3722 ; Beam crossfire correlation degrees^<sup>2</sup>^ between the
3723 crossfire laboratory <b>X</b>-axis component and the crossfire
3724 laboratory <b>Y</b>-axis component (see <a href="#AXIS">AXIS</a> category).
3725
3726 This is a characteristic of the X-ray beam as it illuminates
3727 the sample (or specimen) after all monochromation and
3728 collimation.
3729
3730 This is the mean of the products of the deviations of the
3731 direction of each photon in XZ plane times the deviations
3732 of the direction of the same photon in the YZ plane
3733 around the mean source beam direction. This will be zero
3734 for uncorrelated crossfire.
3735
3736 Note that some synchrotrons, this value is specified in
3737 milliradians^<sup>2</sup>^, in which case a conversion would be needed.
3738 To go from a value in milliradians^<sup>2</sup>^ to a value in
3739 degrees^<sup>2</sup>^, multiply by 0.180^<sup>2</sup>^ and divide by \p^<sup>2</sup>^.
3740
3741 ;
3742 _item.name '<a href="#_diffrn_radiation.div_x_y_source">_diffrn_radiation.div_x_y_source</a>'
3743 _item.category_id diffrn_radiation
3744 _item.mandatory_code no
3745 _item_type.code float
3746 _item_units.code degrees_squared
3747 _item_default.value 0.0
3748 save_
3749
3750 save_<A name="_diffrn_radiation.filter_edge">_diffrn_radiation.filter_edge</a>
3751 _item_description.description
3752 ; Absorption edge in \%Angstroms of the radiation filter used.
3753 ;
3754 _item.name '<a href="#_diffrn_radiation.filter_edge">_diffrn_radiation.filter_edge</a>'
3755 _item.category_id diffrn_radiation
3756 _item.mandatory_code no
3757 _item_aliases.alias_name '_diffrn_radiation_filter_edge'
3758 _item_aliases.dictionary cif_core.dic
3759 _item_aliases.version 2.0.1
3760 loop_
3761 _item_range.maximum
3762 _item_range.minimum . 0.0
3763 0.0 0.0
3764 _item_type.code float
3765 _item_units.code angstroms
3766 save_
3767
3768 save_<A name="_diffrn_radiation.inhomogeneity">_diffrn_radiation.inhomogeneity</a>
3769 _item_description.description
3770 ; Half-width in millimetres of the incident beam in the
3771 direction perpendicular to the diffraction plane.
3772 ;
3773 _item.name '<a href="#_diffrn_radiation.inhomogeneity">_diffrn_radiation.inhomogeneity</a>'
3774 _item.category_id diffrn_radiation
3775 _item.mandatory_code no
3776 _item_aliases.alias_name '_diffrn_radiation_inhomogeneity'
3777 _item_aliases.dictionary cif_core.dic
3778 _item_aliases.version 2.0.1
3779 loop_
3780 _item_range.maximum
3781 _item_range.minimum . 0.0
3782 0.0 0.0
3783 _item_type.code float
3784 _item_units.code millimetres
3785 save_
3786
3787 save_<A name="_diffrn_radiation.monochromator">_diffrn_radiation.monochromator</a>
3788 _item_description.description
3789 ; The method used to obtain monochromatic radiation. If a
3790 monochromator crystal is used, the material and the
3791 indices of the Bragg reflection are specified.
3792 ;
3793 _item.name '<a href="#_diffrn_radiation.monochromator">_diffrn_radiation.monochromator</a>'
3794 _item.category_id diffrn_radiation
3795 _item.mandatory_code no
3796 _item_aliases.alias_name '_diffrn_radiation_monochromator'
3797 _item_aliases.dictionary cif_core.dic
3798 _item_aliases.version 2.0.1
3799 _item_type.code text
3800 loop_
3801 _item_examples.case 'Zr filter'
3802 'Ge 220'
3803 'none'
3804 'equatorial mounted graphite'
3805 save_
3806
3807 save_<A name="_diffrn_radiation.polarisn_norm">_diffrn_radiation.polarisn_norm</a>
3808 _item_description.description
3809 ; The angle in degrees, as viewed from the specimen, between the
3810 perpendicular component of the polarization and the diffraction
3811 plane. See _diffrn_radiation_polarisn_ratio.
3812 ;
3813 _item.name '<a href="#_diffrn_radiation.polarisn_norm">_diffrn_radiation.polarisn_norm</a>'
3814 _item.category_id diffrn_radiation
3815 _item.mandatory_code no
3816 _item_aliases.alias_name '_diffrn_radiation_polarisn_norm'
3817 _item_aliases.dictionary cif_core.dic
3818 _item_aliases.version 2.0.1
3819 loop_
3820 _item_range.maximum
3821 _item_range.minimum 90.0 90.0
3822 90.0 -90.0
3823 -90.0 -90.0
3824 _item_type.code float
3825 _item_units.code degrees
3826 save_
3827
3828 save_<A name="_diffrn_radiation.polarisn_ratio">_diffrn_radiation.polarisn_ratio</a>
3829 _item_description.description
3830 ; Polarization ratio of the diffraction beam incident on the
3831 crystal. This is the ratio of the perpendicularly polarized to
3832 the parallel polarized component of the radiation. The
3833 perpendicular component forms an angle of
3834 <a href="#_diffrn_radiation.polarisn_norm">_diffrn_radiation.polarisn_norm</a> to the normal to the
3835 diffraction plane of the sample (i.e. the plane containing
3836 the incident and reflected beams).
3837 ;
3838 _item.name '<a href="#_diffrn_radiation.polarisn_ratio">_diffrn_radiation.polarisn_ratio</a>'
3839 _item.category_id diffrn_radiation
3840 _item.mandatory_code no
3841 _item_aliases.alias_name '_diffrn_radiation_polarisn_ratio'
3842 _item_aliases.dictionary cif_core.dic
3843 _item_aliases.version 2.0.1
3844 loop_
3845 _item_range.maximum
3846 _item_range.minimum . 0.0
3847 0.0 0.0
3848 _item_type.code float
3849 save_
3850
3851
3852
3853 save_<a name="_diffrn_radiation.polarizn_source_norm">_diffrn_radiation.polarizn_source_norm</a>
3854 _item_description.description
3855 ; The angle in degrees, as viewed from the specimen, between
3856 the normal to the polarization plane and the laboratory <b>Y</b>
3857 axis as defined in the <a href="#AXIS">AXIS</a> category.
3858
3859 Note that this is the angle of polarization of the source
3860 photons, either directly from a synchrotron beamline or
3861 from a monochromater.
3862
3863 This differs from the value of
3864 <a href="#_diffrn_radiation.polarisn_norm">_diffrn_radiation.polarisn_norm</a>
3865 in that <a href="#_diffrn_radiation.polarisn_norm">_diffrn_radiation.polarisn_norm</a> refers to
3866 polarization relative to the diffraction plane rather than
3867 to the laboratory axis system.
3868
3869 In the case of an unpolarized beam, or a beam with true
3870 circular polarization, in which no single plane of
3871 polarization can be determined, the plane should be taken
3872 as the XZ plane and the angle as 0.
3873
3874 See <a href="#_diffrn_radiation.polarizn_source_ratio">_diffrn_radiation.polarizn_source_ratio</a>.
3875 ;
3876 _item.name '<a href="#_diffrn_radiation.polarizn_source_norm">_diffrn_radiation.polarizn_source_norm</a>'
3877 _item.category_id diffrn_radiation
3878 _item.mandatory_code no
3879 loop_
3880 _item_range.maximum
3881 _item_range.minimum 90.0 90.0
3882 90.0 -90.0
3883 -90.0 -90.0
3884 _item_type.code float
3885 _item_units.code degrees
3886 _item_default.value 0.0
3887 save_
3888
3889
3890 save_<a name="_diffrn_radiation.polarizn_source_ratio">_diffrn_radiation.polarizn_source_ratio</a>
3891 _item_description.description
3892 ; (Ip-In)/(Ip+In), where Ip is the intensity
3893 (amplitude squared) of the electric vector in the plane of
3894 polarization and In is the intensity (amplitude squared)
3895 of the electric vector in the plane of the normal to the
3896 plane of polarization.
3897
3898 In the case of an unpolarized beam, or a beam with true
3899 circular polarization, in which no single plane of
3900 polarization can be determined, the plane is to be taken
3901 as the XZ plane and the normal is parallel to the <b>Y</b> axis.
3902
3903 Thus, if there was complete polarization in the plane of
3904 polarization, the value of
3905 <a href="#_diffrn_radiation.polarizn_source_ratio">_diffrn_radiation.polarizn_source_ratio</a> would be 1, and
3906 for an unpolarized beam
3907 <a href="#_diffrn_radiation.polarizn_source_ratio">_diffrn_radiation.polarizn_source_ratio</a> would have a
3908 value of 0.
3909
3910 If the <b>X</b> axis has been chosen to lie in the plane of
3911 polarization, this definition will agree with the definition
3912 of 'MONOCHROMATOR' in the Denzo glossary, and values of near
3913 1 should be expected for a bending-magnet source. However,
3914 if the <b>X</b> axis were perpendicular to the polarization plane
3915 (not a common choice), then the Denzo value would be the
3916 negative of <a href="#_diffrn_radiation.polarizn_source_ratio">_diffrn_radiation.polarizn_source_ratio</a>.
3917
3918 See <a href="http://www.hkl-xray.com">http://www.hkl-xray.com</a> for information on Denzo and
3919 Otwinowski & Minor (1997).
3920
3921 This differs both in the choice of ratio and choice of
3922 orientation from <a href="#_diffrn_radiation.polarisn_ratio">_diffrn_radiation.polarisn_ratio</a>, which,
3923 unlike <a href="#_diffrn_radiation.polarizn_source_ratio">_diffrn_radiation.polarizn_source_ratio</a>, is
3924 unbounded.
3925
3926 Reference: Otwinowski, Z. & Minor, W. (1997). 'Processing of
3927 X-ray diffraction data collected in oscillation mode.' Methods
3928 Enzymol. 276, 307-326.
3929 ;
3930 _item.name '<a href="#_diffrn_radiation.polarizn_source_ratio">_diffrn_radiation.polarizn_source_ratio</a>'
3931 _item.category_id diffrn_radiation
3932 _item.mandatory_code no
3933 loop_
3934 _item_range.maximum
3935 _item_range.minimum 1.0 1.0
3936 1.0 -1.0
3937 -1.0 -1.0
3938 _item_type.code float
3939 save_
3940
3941
3942 save_<A name="_diffrn_radiation.probe">_diffrn_radiation.probe</a>
3943 _item_description.description
3944 ; Name of the type of radiation used. It is strongly
3945 recommended that this be given so that the
3946 probe radiation is clearly specified.
3947 ;
3948 _item.name '<a href="#_diffrn_radiation.probe">_diffrn_radiation.probe</a>'
3949 _item.category_id diffrn_radiation
3950 _item.mandatory_code no
3951 _item_aliases.alias_name '_diffrn_radiation_probe'
3952 _item_aliases.dictionary cif_core.dic
3953 _item_aliases.version 2.0.1
3954 _item_type.code line
3955 loop_
3956 _item_enumeration.value 'X-ray'
3957 'neutron'
3958 'electron'
3959 'gamma'
3960 save_
3961
3962 save_<A name="_diffrn_radiation.type">_diffrn_radiation.type</a>
3963 _item_description.description
3964 ; The nature of the radiation. This is typically a description
3965 of the X-ray wavelength in Siegbahn notation.
3966 ;
3967 _item.name '<a href="#_diffrn_radiation.type">_diffrn_radiation.type</a>'
3968 _item.category_id diffrn_radiation
3969 _item.mandatory_code no
3970 _item_aliases.alias_name '_diffrn_radiation_type'
3971 _item_aliases.dictionary cif_core.dic
3972 _item_aliases.version 2.0.1
3973 _item_type.code line
3974 loop_
3975 _item_examples.case 'CuK\a'
3976 'Cu K\a~1~'
3977 'Cu K-L~2,3~'
3978 'white-beam'
3979
3980 save_
3981
3982 save_<A name="_diffrn_radiation.xray_symbol">_diffrn_radiation.xray_symbol</a>
3983 _item_description.description
3984 ; The IUPAC symbol for the X-ray wavelength for the probe
3985 radiation.
3986 ;
3987 _item.name '<a href="#_diffrn_radiation.xray_symbol">_diffrn_radiation.xray_symbol</a>'
3988 _item.category_id diffrn_radiation
3989 _item.mandatory_code no
3990 _item_aliases.alias_name '_diffrn_radiation_xray_symbol'
3991 _item_aliases.dictionary cif_core.dic
3992 _item_aliases.version 2.0.1
3993 _item_type.code line
3994 loop_
3995 _item_enumeration.value
3996 _item_enumeration.detail 'K-L~3~'
3997 'K\a~1~ in older Siegbahn notation'
3998 'K-L~2~'
3999 'K\a~2~ in older Siegbahn notation'
4000 'K-M~3~'
4001 'K\b~1~ in older Siegbahn notation'
4002 'K-L~2,3~'
4003 'use where K-L~3~ and K-L~2~ are not resolved'
4004 save_
4005
4006 save_<A name="_diffrn_radiation.wavelength_id">_diffrn_radiation.wavelength_id</a>
4007 _item_description.description
4008 ; This data item is a pointer to
4009 <a href="#_diffrn_radiation_wavelength.id">_diffrn_radiation_wavelength.id</a> in the
4010 DIFFRN_RADIATION_WAVELENGTH category.
4011 ;
4012 _item.name '<a href="#_diffrn_radiation.wavelength_id">_diffrn_radiation.wavelength_id</a>'
4013 _item.category_id diffrn_radiation
4014 _item.mandatory_code yes
4015 _item_type.code code
4016 save_
4017
4018
4019
4020 ################
4021 # <a name="DIFFRN_REFLN">DIFFRN_REFLN</a> #
4022 ################
4023
4024
4025 save_DIFFRN_REFLN
4026 _category.description
4027 ; This category redefinition has been added to extend the key of
4028 the standard <a href="#DIFFRN_REFLN">DIFFRN_REFLN</a> category.
4029 ;
4030 _category.id diffrn_refln
4031 _category.mandatory_code no
4032 _category_key.name '<a href="#_diffrn_refln.frame_id" >_diffrn_refln.frame_id</a>'
4033 loop_
4034 _category_group.id 'inclusive_group'
4035 'diffrn_group'
4036 save_
4037
4038
4039 save_<a name="_diffrn_refln.frame_id" >_diffrn_refln.frame_id</a>
4040 _item_description.description
4041 ; This item is a pointer to <a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a>
4042 in the <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a> category.
4043 ;
4044 _item.name '<a href="#_diffrn_refln.frame_id" >_diffrn_refln.frame_id</a>'
4045 _item.category_id diffrn_refln
4046 _item.mandatory_code yes
4047 _item_type.code code
4048 save_
4049
4050
4051 ###############
4052 # <a name="DIFFRN_SCAN">DIFFRN_SCAN</a> #
4053 ###############
4054
4055 save_DIFFRN_SCAN
4056 _category.description
4057 ; Data items in the <a href="#DIFFRN_SCAN">DIFFRN_SCAN</a> category describe the parameters of one
4058 or more scans, relating axis positions to frames.
4059
4060 ;
4061 _category.id diffrn_scan
4062 _category.mandatory_code no
4063 _category_key.name '<a href="#_diffrn_scan.id" >_diffrn_scan.id</a>'
4064 loop_
4065 _category_group.id 'inclusive_group'
4066 'diffrn_group'
4067 loop_
4068 _category_examples.detail
4069 _category_examples.case
4070 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
4071 ; Example 1 - derived from a suggestion by R. M. Sweet.
4072
4073 The vector of each axis is not given here, because it is provided in
4074 the <a href="#AXIS">AXIS</a> category. By making <a href="#_diffrn_scan_axis.scan_id" >_diffrn_scan_axis.scan_id</a> and
4075 <a href="#_diffrn_scan_axis.axis_id" >_diffrn_scan_axis.axis_id</a> keys of the <a href="#DIFFRN_SCAN_AXIS">DIFFRN_SCAN_AXIS</a> category,
4076 an arbitrary number of scanning and fixed axes can be specified for a
4077 scan. In this example, three rotation axes and one translation axis
4078 at nonzero values are specified, with one axis stepping. There is no
4079 reason why more axes could not have been specified to step. Range
4080 information has been specified, but note that it can be calculated from
4081 the number of frames and the increment, so the data item
4082 <a href="#_diffrn_scan_axis.angle_range">_diffrn_scan_axis.angle_range</a> could be dropped.
4083
4084 Both the sweep data and the data for a single frame are specified.
4085
4086 Note that the information on how the axes are stepped is given twice,
4087 once in terms of the overall averages in the value of
4088 <a href="#_diffrn_scan.integration_time" >_diffrn_scan.integration_time</a> and the values for <a href="#DIFFRN_SCAN_AXIS">DIFFRN_SCAN_AXIS</a>,
4089 and precisely for the given frame in the value for
4090 <a href="#_diffrn_scan_frame.integration_time" >_diffrn_scan_frame.integration_time</a> and the values for
4091 <a href="#DIFFRN_SCAN_FRAME_AXIS">DIFFRN_SCAN_FRAME_AXIS</a>. If dose-related adjustments are made to
4092 scan times and nonlinear stepping is done, these values may differ.
4093 Therefore, in interpreting the data for a particular frame it is
4094 important to use the frame-specific data.
4095 ;
4096 ;
4097 <a href="#_diffrn_scan.id">_diffrn_scan.id</a> 1
4098 <a href="#_diffrn_scan.date_start" >_diffrn_scan.date_start</a> '2001-11-18T03:26:42'
4099 <a href="#_diffrn_scan.date_end" >_diffrn_scan.date_end</a> '2001-11-18T03:36:45'
4100 <a href="#_diffrn_scan.integration_time" >_diffrn_scan.integration_time</a> 3.0
4101 <a href="#_diffrn_scan.frame_id_start" >_diffrn_scan.frame_id_start</a> mad_L2_000
4102 <a href="#_diffrn_scan.frame_id_end" >_diffrn_scan.frame_id_end</a> mad_L2_200
4103 <a href="#_diffrn_scan.frames" >_diffrn_scan.frames</a> 201
4104
4105 loop_
4106 <a href="#_diffrn_scan_axis.scan_id" >_diffrn_scan_axis.scan_id</a>
4107 <a href="#_diffrn_scan_axis.axis_id" >_diffrn_scan_axis.axis_id</a>
4108 <a href="#_diffrn_scan_axis.angle_start" >_diffrn_scan_axis.angle_start</a>
4109 <a href="#_diffrn_scan_axis.angle_range" >_diffrn_scan_axis.angle_range</a>
4110 <a href="#_diffrn_scan_axis.angle_increment" >_diffrn_scan_axis.angle_increment</a>
4111 <a href="#_diffrn_scan_axis.displacement_start" >_diffrn_scan_axis.displacement_start</a>
4112 <a href="#_diffrn_scan_axis.displacement_range" >_diffrn_scan_axis.displacement_range</a>
4113 <a href="#_diffrn_scan_axis.displacement_increment" >_diffrn_scan_axis.displacement_increment</a>
4114
4115 1 omega 200.0 20.0 0.1 . . .
4116 1 kappa -40.0 0.0 0.0 . . .
4117 1 phi 127.5 0.0 0.0 . . .
4118 1 tranz . . . 2.3 0.0 0.0
4119
4120 <a href="#_diffrn_scan_frame.scan_id" >_diffrn_scan_frame.scan_id</a> 1
4121 <a href="#_diffrn_scan_frame.date" >_diffrn_scan_frame.date</a> '2001-11-18T03:27:33'
4122 <a href="#_diffrn_scan_frame.integration_time" >_diffrn_scan_frame.integration_time</a> 3.0
4123 <a href="#_diffrn_scan_frame.frame_id" >_diffrn_scan_frame.frame_id</a> mad_L2_018
4124 <a href="#_diffrn_scan_frame.frame_number" >_diffrn_scan_frame.frame_number</a> 18
4125
4126 loop_
4127 <a href="#_diffrn_scan_frame_axis.frame_id" >_diffrn_scan_frame_axis.frame_id</a>
4128 <a href="#_diffrn_scan_frame_axis.axis_id" >_diffrn_scan_frame_axis.axis_id</a>
4129 <a href="#_diffrn_scan_frame_axis.angle">_diffrn_scan_frame_axis.angle</a>
4130 <a href="#_diffrn_scan_frame_axis.angle_increment" >_diffrn_scan_frame_axis.angle_increment</a>
4131 <a href="#_diffrn_scan_frame_axis.displacement" >_diffrn_scan_frame_axis.displacement</a>
4132 <a href="#_diffrn_scan_frame_axis.displacement_increment" >_diffrn_scan_frame_axis.displacement_increment</a>
4133
4134 mad_L2_018 omega 201.8 0.1 . .
4135 mad_L2_018 kappa -40.0 0.0 . .
4136 mad_L2_018 phi 127.5 0.0 . .
4137 mad_L2_018 tranz . . 2.3 0.0
4138 ;
4139
4140 ; Example 2 - a more extensive example (R. M. Sweet, P. J. Ellis &
4141 H. J. Bernstein).
4142
4143 A detector is placed 240 mm along the <b>Z</b> axis from the goniometer.
4144 This leads to a choice: either the axes of
4145 the detector are defined at the origin, and then a Z setting of -240
4146 is entered, or the axes are defined with the necessary Z offset.
4147 In this case, the setting is used and the offset is left as zero.
4148 This axis is called DETECTOR_Z.
4149
4150 The axis for positioning the detector in the <b>Y</b> direction depends
4151 on the detector <b>Z</b> axis. This axis is called DETECTOR_Y.
4152
4153 The axis for positioning the detector in the <b>X</b> direction depends
4154 on the detector <b>Y</b> axis (and therefore on the detector <b>Z</b> axis).
4155 This axis is called DETECTOR_X.
4156
4157 This detector may be rotated around the <b>Y</b> axis. This rotation axis
4158 depends on the three translation axes. It is called DETECTOR_PITCH.
4159
4160 A coordinate system is defined on the face of the detector in terms of
4161 2300 0.150 mm pixels in each direction. The ELEMENT_X axis is used to
4162 index the first array index of the data array and the ELEMENT_Y
4163 axis is used to index the second array index. Because the pixels
4164 are 0.150mm <b>X</b> 0.150mm, the centre of the first pixel is at (0.075,
4165 0.075) in this coordinate system.
4166 ;
4167
4168 ; ###CBF: VERSION 1.1
4169
4170 data_image_1
4171
4172 # category DIFFRN
4173 _diffrn.id P6MB
4174 _diffrn.crystal_id P6MB_CRYSTAL7
4175
4176 # category DIFFRN_SOURCE
4177 loop_
4178 _diffrn_source.diffrn_id
4179 _diffrn_source.source
4180 _diffrn_source.type
4181 P6MB synchrotron 'SSRL beamline 9-1'
4182
4183 # category <a href="#DIFFRN_RADIATION">DIFFRN_RADIATION</a>
4184 loop_
4185 <a href="#_diffrn_radiation.diffrn_id">_diffrn_radiation.diffrn_id</a>
4186 <a href="#_diffrn_radiation.wavelength_id">_diffrn_radiation.wavelength_id</a>
4187 <a href="#_diffrn_radiation.monochromator">_diffrn_radiation.monochromator</a>
4188 <a href="#_diffrn_radiation.polarizn_source_ratio">_diffrn_radiation.polarizn_source_ratio</a>
4189 <a href="#_diffrn_radiation.polarizn_source_norm">_diffrn_radiation.polarizn_source_norm</a>
4190 <a href="#_diffrn_radiation.div_x_source">_diffrn_radiation.div_x_source</a>
4191 <a href="#_diffrn_radiation.div_y_source">_diffrn_radiation.div_y_source</a>
4192 <a href="#_diffrn_radiation.div_x_y_source">_diffrn_radiation.div_x_y_source</a>
4193 P6MB WAVELENGTH1 'Si 111' 0.8 0.0 0.08
4194 0.01 0.00
4195
4196 # category DIFFRN_RADIATION_WAVELENGTH
4197 loop_
4198 _diffrn_radiation_wavelength.id
4199 _diffrn_radiation_wavelength.wavelength
4200 _diffrn_radiation_wavelength.wt
4201 WAVELENGTH1 0.98 1.0
4202
4203 # category <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a>
4204 loop_
4205 <a href="#_diffrn_detector.diffrn_id">_diffrn_detector.diffrn_id</a>
4206 <a href="#_diffrn_detector.id">_diffrn_detector.id</a>
4207 <a href="#_diffrn_detector.type">_diffrn_detector.type</a>
4208 <a href="#_diffrn_detector.number_of_axes">_diffrn_detector.number_of_axes</a>
4209 P6MB MAR345-SN26 'MAR 345' 4
4210
4211 # category <a href="#DIFFRN_DETECTOR_AXIS">DIFFRN_DETECTOR_AXIS</a>
4212 loop_
4213 <a href="#_diffrn_detector_axis.detector_id">_diffrn_detector_axis.detector_id</a>
4214 <a href="#_diffrn_detector_axis.axis_id">_diffrn_detector_axis.axis_id</a>
4215 MAR345-SN26 DETECTOR_X
4216 MAR345-SN26 DETECTOR_Y
4217 MAR345-SN26 DETECTOR_Z
4218 MAR345-SN26 DETECTOR_PITCH
4219
4220 # category <a href="#DIFFRN_DETECTOR_ELEMENT">DIFFRN_DETECTOR_ELEMENT</a>
4221 loop_
4222 <a href="#_diffrn_detector_element.id">_diffrn_detector_element.id</a>
4223 <a href="#_diffrn_detector_element.detector_id#">_diffrn_detector_element.detector_id</a>
4224 ELEMENT1 MAR345-SN26
4225
4226 # category <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a>
4227 loop_
4228 <a href="#_diffrn_data_frame.id">_diffrn_data_frame.id</a>
4229 <a href="#_diffrn_data_frame.detector_element_id">_diffrn_data_frame.detector_element_id</a>
4230 <a href="#_diffrn_data_frame.array_id">_diffrn_data_frame.array_id</a>
4231 <a href="#_diffrn_data_frame.binary_id">_diffrn_data_frame.binary_id</a>
4232 FRAME1 ELEMENT1 ARRAY1 1
4233
4234 # category <a href="#DIFFRN_MEASUREMENT">DIFFRN_MEASUREMENT</a>
4235 loop_
4236 <a href="#_diffrn_measurement.diffrn_id">_diffrn_measurement.diffrn_id</a>
4237 <a href="#_diffrn_measurement.id">_diffrn_measurement.id</a>
4238 <a href="#_diffrn_measurement.number_of_axes">_diffrn_measurement.number_of_axes</a>
4239 <a href="#_diffrn_measurement.method">_diffrn_measurement.method</a>
4240 P6MB GONIOMETER 3 rotation
4241
4242 # category <a href="#DIFFRN_MEASUREMENT_AXIS">DIFFRN_MEASUREMENT_AXIS</a>
4243 loop_
4244 <a href="#_diffrn_measurement_axis.measurement_id">_diffrn_measurement_axis.measurement_id</a>
4245 <a href="#_diffrn_measurement_axis.axis_id">_diffrn_measurement_axis.axis_id</a>
4246 GONIOMETER GONIOMETER_PHI
4247 GONIOMETER GONIOMETER_KAPPA
4248 GONIOMETER GONIOMETER_OMEGA
4249
4250 # category <a href="#DIFFRN_SCAN">DIFFRN_SCAN</a>
4251 loop_
4252 <a href="#_diffrn_scan.id" >_diffrn_scan.id</a>
4253 <a href="#_diffrn_scan.frame_id_start" >_diffrn_scan.frame_id_start</a>
4254 <a href="#_diffrn_scan.frame_id_end" >_diffrn_scan.frame_id_end</a>
4255 <a href="#_diffrn_scan.frames" >_diffrn_scan.frames</a>
4256 SCAN1 FRAME1 FRAME1 1
4257
4258 # category <a href="#DIFFRN_SCAN_AXIS">DIFFRN_SCAN_AXIS</a>
4259 loop_
4260 <a href="#_diffrn_scan_axis.scan_id" >_diffrn_scan_axis.scan_id</a>
4261 <a href="#_diffrn_scan_axis.axis_id" >_diffrn_scan_axis.axis_id</a>
4262 <a href="#_diffrn_scan_axis.angle_start" >_diffrn_scan_axis.angle_start</a>
4263 <a href="#_diffrn_scan_axis.angle_range" >_diffrn_scan_axis.angle_range</a>
4264 <a href="#_diffrn_scan_axis.angle_increment" >_diffrn_scan_axis.angle_increment</a>
4265 <a href="#_diffrn_scan_axis.displacement_start" >_diffrn_scan_axis.displacement_start</a>
4266 <a href="#_diffrn_scan_axis.displacement_range" >_diffrn_scan_axis.displacement_range</a>
4267 <a href="#_diffrn_scan_axis.displacement_increment" >_diffrn_scan_axis.displacement_increment</a>
4268 SCAN1 GONIOMETER_OMEGA 12.0 1.0 1.0 0.0 0.0 0.0
4269 SCAN1 GONIOMETER_KAPPA 23.3 0.0 0.0 0.0 0.0 0.0
4270 SCAN1 GONIOMETER_PHI -165.8 0.0 0.0 0.0 0.0 0.0
4271 SCAN1 DETECTOR_Z 0.0 0.0 0.0 -240.0 0.0 0.0
4272 SCAN1 DETECTOR_Y 0.0 0.0 0.0 0.6 0.0 0.0
4273 SCAN1 DETECTOR_X 0.0 0.0 0.0 -0.5 0.0 0.0
4274 SCAN1 DETECTOR_PITCH 0.0 0.0 0.0 0.0 0.0 0.0
4275
4276 # category <a href="#DIFFRN_SCAN_FRAME">DIFFRN_SCAN_FRAME</a>
4277 loop_
4278 <a href="#_diffrn_scan_frame.frame_id" >_diffrn_scan_frame.frame_id</a>
4279 <a href="#_diffrn_scan_frame.frame_number" >_diffrn_scan_frame.frame_number</a>
4280 <a href="#_diffrn_scan_frame.integration_time" >_diffrn_scan_frame.integration_time</a>
4281 <a href="#_diffrn_scan_frame.scan_id" >_diffrn_scan_frame.scan_id</a>
4282 <a href="#_diffrn_scan_frame.date" >_diffrn_scan_frame.date</a>
4283 FRAME1 1 20.0 SCAN1 1997-12-04T10:23:48
4284
4285 # category <a href="#DIFFRN_SCAN_FRAME_AXIS">DIFFRN_SCAN_FRAME_AXIS</a>
4286 loop_
4287 <a href="#_diffrn_scan_frame_axis.frame_id" >_diffrn_scan_frame_axis.frame_id</a>
4288 <a href="#_diffrn_scan_frame_axis.axis_id" >_diffrn_scan_frame_axis.axis_id</a>
4289 <a href="#_diffrn_scan_frame_axis.angle" >_diffrn_scan_frame_axis.angle</a>
4290 <a href="#_diffrn_scan_frame_axis.displacement" >_diffrn_scan_frame_axis.displacement</a>
4291 FRAME1 GONIOMETER_OMEGA 12.0 0.0
4292 FRAME1 GONIOMETER_KAPPA 23.3 0.0
4293 FRAME1 GONIOMETER_PHI -165.8 0.0
4294 FRAME1 DETECTOR_Z 0.0 -240.0
4295 FRAME1 DETECTOR_Y 0.0 0.6
4296 FRAME1 DETECTOR_X 0.0 -0.5
4297 FRAME1 DETECTOR_PITCH 0.0 0.0
4298
4299 # category <a href="#AXIS">AXIS</a>
4300 loop_
4301 <a href="#_axis.id">_axis.id</a>
4302 <a href="#_axis.type">_axis.type</a>
4303 <a href="#_axis.equipment">_axis.equipment</a>
4304 <a href="#_axis.depends_on">_axis.depends_on</a>
4305 <a href="#_axis.vector[1]">_axis.vector[1]</a> <a href="#_axis.vector[2]">_axis.vector[2]</a> <a href="#_axis.vector[3]">_axis.vector[3]</a>
4306 <a href="#_axis.offset[1]">_axis.offset[1]</a> <a href="#_axis.offset[2]">_axis.offset[2]</a> <a href="#_axis.offset[3]">_axis.offset[3]</a>
4307 GONIOMETER_OMEGA rotation goniometer . 1 0 0 . . .
4308 GONIOMETER_KAPPA rotation goniometer GONIOMETER_OMEGA 0.64279
4309 0 0.76604 . . .
4310 GONIOMETER_PHI rotation goniometer GONIOMETER_KAPPA 1 0 0
4311 . . .
4312 SOURCE general source . 0 0 1 . . .
4313 GRAVITY general gravity . 0 -1 0 . . .
4314 DETECTOR_Z translation detector . 0 0 1 0 0 0
4315 DETECTOR_Y translation detector DETECTOR_Z 0 1 0 0 0 0
4316 DETECTOR_X translation detector DETECTOR_Y 1 0 0 0 0 0
4317 DETECTOR_PITCH rotation detector DETECTOR_X 0 1 0 0 0 0
4318 ELEMENT_X translation detector DETECTOR_PITCH
4319 1 0 0 172.43 -172.43 0
4320 ELEMENT_Y translation detector ELEMENT_X
4321 0 1 0 0 0 0
4322
4323 # category <a href="#ARRAY_STRUCTURE_LIST">ARRAY_STRUCTURE_LIST</a>
4324 loop_
4325 <a href="#_array_structure_list.array_id">_array_structure_list.array_id</a>
4326 <a href="#_array_structure_list.index">_array_structure_list.index</a>
4327 <a href="#_array_structure_list.dimension">_array_structure_list.dimension</a>
4328 <a href="#_array_structure_list.precedence">_array_structure_list.precedence</a>
4329 <a href="#_array_structure_list.direction">_array_structure_list.direction</a>
4330 <a href="#_array_structure_list.axis_set_id">_array_structure_list.axis_set_id</a>
4331 ARRAY1 1 2300 1 increasing ELEMENT_X
4332 ARRAY1 2 2300 2 increasing ELEMENT_Y
4333
4334 # category <a href="#ARRAY_STRUCTURE_LIST_AXIS">ARRAY_STRUCTURE_LIST_AXIS</a>
4335 loop_
4336 <a href="#_array_structure_list_axis.axis_set_id">_array_structure_list_axis.axis_set_id</a>
4337 <a href="#_array_structure_list_axis.axis_id">_array_structure_list_axis.axis_id</a>
4338 <a href="#_array_structure_list_axis.displacement">_array_structure_list_axis.displacement</a>
4339 <a href="#_array_structure_list_axis.displacement_increment">_array_structure_list_axis.displacement_increment</a>
4340 ELEMENT_X ELEMENT_X 0.075 0.150
4341 ELEMENT_Y ELEMENT_Y 0.075 0.150
4342
4343 # category <a href="#ARRAY_ELEMENT_SIZE">ARRAY_ELEMENT_SIZE</a>
4344 loop_
4345 <a href="#_array_element_size.array_id">_array_element_size.array_id</a>
4346 <a href="#_array_element_size.index">_array_element_size.index</a>
4347 <a href="#_array_element_size.index">_array_element_size.size</a>
4348 ARRAY1 1 150e-6
4349 ARRAY1 2 150e-6
4350
4351 # category <a href="#ARRAY_INTENSITIES">ARRAY_INTENSITIES</a>
4352 loop_
4353 <a href="#_array_intensities.array_id">_array_intensities.array_id</a>
4354 <a href="#_array_intensities.binary_id">_array_intensities.binary_id</a>
4355 <a href="#_array_intensities.linearity">_array_intensities.linearity</a>
4356 <a href="#_array_intensities.gain">_array_intensities.gain</a>
4357 <a href="#_array_intensities.gain_esd">_array_intensities.gain_esd</a>
4358 <a href="#_array_intensities.overload">_array_intensities.overload</a>
4359 <a href="#_array_intensities.undefined_value">_array_intensities.undefined_value</a>
4360 ARRAY1 1 linear 1.15 0.2 240000 0
4361
4362 # category <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a>
4363 loop_
4364 <a href="#_array_structure.id">_array_structure.id</a>
4365 <a href="#_array_structure.encoding_type">_array_structure.encoding_type</a>
4366 <a href="#_array_structure.compression_type">_array_structure.compression_type</a>
4367 <a href="#_array_structure.byte_order">_array_structure.byte_order</a>
4368 ARRAY1 "signed 32-bit integer" packed little_endian
4369
4370 # category <a href="#ARRAY_DATA">ARRAY_DATA</a>
4371 loop_
4372 <a href="#_array_data.array_id">_array_data.array_id</a>
4373 <a href="#_array_data.binary_id">_array_data.binary_id</a>
4374 <a href="#_array_data.data">_array_data.data</a>
4375 ARRAY1 1
4376 ;
4377 --CIF-BINARY-FORMAT-SECTION--
4378 Content-Type: application/octet-stream;
4379 conversions="<b>X</b>-CBF_PACKED"
4380 Content-Transfer-Encoding: BASE64
4381 <b>X</b>-Binary-Size: 3801324
4382 <b>X</b>-Binary-ID: 1
4383 <b>X</b>-Binary-Element-Type: "signed 32-bit integer"
4384 Content-MD5: 07lZFvF+aOcW85IN7usl8A==
4385
4386 AABRAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAZBQSr1sKNBOeOe9HITdMdDUnbq7bg
4387 ...
4388 8REo6TtBrxJ1vKqAvx9YDMD6J18Qg83OMr/tgssjMIJMXATDsZobL90AEXc4KigE
4389
4390 --CIF-BINARY-FORMAT-SECTION----
4391 ;
4392 ;
4393
4394 ; Example 3 - Example 2 revised for a spiral scan (R. M. Sweet,
4395 P. J. Ellis & H. J. Bernstein).
4396
4397 A detector is placed 240 mm along the <b>Z</b> axis from the
4398 goniometer, as in Example 2 above, but in this example the
4399 image plate is scanned in a spiral pattern from the outside edge in.
4400
4401 The axis for positioning the detector in the <b>Y</b> direction depends
4402 on the detector <b>Z</b> axis. This axis is called DETECTOR_Y.
4403
4404 The axis for positioning the detector in the <b>X</b> direction depends
4405 on the detector <b>Y</b> axis (and therefore on the detector <b>Z</b> axis).
4406 This axis is called DETECTOR_X.
4407
4408 This detector may be rotated around the <b>Y</b> axis. This rotation axis
4409 depends on the three translation axes. It is called DETECTOR_PITCH.
4410
4411 A coordinate system is defined on the face of the detector in
4412 terms of a coupled rotation axis and radial scan axis to form
4413 a spiral scan. The rotation axis is called ELEMENT_ROT and the
4414 radial axis is called ELEMENT_RAD. A 150 micrometre radial pitch
4415 and a 75 micrometre 'constant velocity' angular pitch are assumed.
4416
4417 Indexing is carried out first on the rotation axis and the radial axis
4418 is made to be dependent on it.
4419
4420 The two axes are coupled to form an axis set ELEMENT_SPIRAL.
4421 ;
4422 ; ###CBF: VERSION 1.1
4423
4424 data_image_1
4425
4426 # category DIFFRN
4427 _diffrn.id P6MB
4428 _diffrn.crystal_id P6MB_CRYSTAL7
4429
4430 # category DIFFRN_SOURCE
4431 loop_
4432 _diffrn_source.diffrn_id
4433 _diffrn_source.source
4434 _diffrn_source.type
4435 P6MB synchrotron 'SSRL beamline 9-1'
4436
4437 # category <a href="#DIFFRN_RADIATION">DIFFRN_RADIATION</a>
4438 loop_
4439 <a href="#_diffrn_radiation.diffrn_id">_diffrn_radiation.diffrn_id</a>
4440 <a href="#_diffrn_radiation.wavelength_id">_diffrn_radiation.wavelength_id</a>
4441 <a href="#_diffrn_radiation.monochromator">_diffrn_radiation.monochromator</a>
4442 <a href="#_diffrn_radiation.polarizn_source_ratio">_diffrn_radiation.polarizn_source_ratio</a>
4443 <a href="#_diffrn_radiation.polarizn_source_norm">_diffrn_radiation.polarizn_source_norm</a>
4444 <a href="#_diffrn_radiation.div_x_source">_diffrn_radiation.div_x_source</a>
4445 <a href="#_diffrn_radiation.div_y_source">_diffrn_radiation.div_y_source</a>
4446 <a href="#_diffrn_radiation.div_x_y_source">_diffrn_radiation.div_x_y_source</a>
4447 P6MB WAVELENGTH1 'Si 111' 0.8 0.0 0.08
4448 0.01 0.00
4449
4450 # category DIFFRN_RADIATION_WAVELENGTH
4451 loop_
4452 _diffrn_radiation_wavelength.id
4453 _diffrn_radiation_wavelength.wavelength
4454 _diffrn_radiation_wavelength.wt
4455 WAVELENGTH1 0.98 1.0
4456
4457 # category <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a>
4458 loop_
4459 <a href="#_diffrn_detector.diffrn_id">_diffrn_detector.diffrn_id</a>
4460 <a href="#_diffrn_detector.id">_diffrn_detector.id</a>
4461 <a href="#_diffrn_detector.type">_diffrn_detector.type</a>
4462 <a href="#_diffrn_detector.number_of_axes">_diffrn_detector.number_of_axes</a>
4463 P6MB MAR345-SN26 'MAR 345' 4
4464
4465 # category <a href="#DIFFRN_DETECTOR_AXIS">DIFFRN_DETECTOR_AXIS</a>
4466 loop_
4467 <a href="#_diffrn_detector_axis.detector_id">_diffrn_detector_axis.detector_id</a>
4468 <a href="#_diffrn_detector_axis.axis_id">_diffrn_detector_axis.axis_id</a>
4469 MAR345-SN26 DETECTOR_X
4470 MAR345-SN26 DETECTOR_Y
4471 MAR345-SN26 DETECTOR_Z
4472 MAR345-SN26 DETECTOR_PITCH
4473
4474 # category <a href="#DIFFRN_DETECTOR_ELEMENT">DIFFRN_DETECTOR_ELEMENT</a>
4475 loop_
4476 <a href="#_diffrn_detector_element.id">_diffrn_detector_element.id</a>
4477 <a href="#_diffrn_detector_element.detector_id#">_diffrn_detector_element.detector_id</a>
4478 ELEMENT1 MAR345-SN26
4479
4480 # category <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a>
4481 loop_
4482 <a href="#_diffrn_data_frame.id">_diffrn_data_frame.id</a>
4483 <a href="#_diffrn_data_frame.detector_element_id">_diffrn_data_frame.detector_element_id</a>
4484 <a href="#_diffrn_data_frame.array_id">_diffrn_data_frame.array_id</a>
4485 <a href="#_diffrn_data_frame.binary_id">_diffrn_data_frame.binary_id</a>
4486 FRAME1 ELEMENT1 ARRAY1 1
4487
4488 # category <a href="#DIFFRN_MEASUREMENT">DIFFRN_MEASUREMENT</a>
4489 loop_
4490 <a href="#_diffrn_measurement.diffrn_id">_diffrn_measurement.diffrn_id</a>
4491 <a href="#_diffrn_measurement.id">_diffrn_measurement.id</a>
4492 <a href="#_diffrn_measurement.number_of_axes">_diffrn_measurement.number_of_axes</a>
4493 <a href="#_diffrn_measurement.method">_diffrn_measurement.method</a>
4494 P6MB GONIOMETER 3 rotation
4495
4496 # category <a href="#DIFFRN_MEASUREMENT_AXIS">DIFFRN_MEASUREMENT_AXIS</a>
4497 loop_
4498 <a href="#_diffrn_measurement_axis.measurement_id">_diffrn_measurement_axis.measurement_id</a>
4499 <a href="#_diffrn_measurement_axis.axis_id">_diffrn_measurement_axis.axis_id</a>
4500 GONIOMETER GONIOMETER_PHI
4501 GONIOMETER GONIOMETER_KAPPA
4502 GONIOMETER GONIOMETER_OMEGA
4503
4504 # category <a href="#DIFFRN_SCAN">DIFFRN_SCAN</a>
4505 loop_
4506 <a href="#_diffrn_scan.id" >_diffrn_scan.id</a>
4507 <a href="#_diffrn_scan.frame_id_start" >_diffrn_scan.frame_id_start</a>
4508 <a href="#_diffrn_scan.frame_id_end" >_diffrn_scan.frame_id_end</a>
4509 <a href="#_diffrn_scan.frames" >_diffrn_scan.frames</a>
4510 SCAN1 FRAME1 FRAME1 1
4511
4512 # category <a href="#DIFFRN_SCAN_AXIS">DIFFRN_SCAN_AXIS</a>
4513 loop_
4514 <a href="#_diffrn_scan_axis.scan_id" >_diffrn_scan_axis.scan_id</a>
4515 <a href="#_diffrn_scan_axis.axis_id" >_diffrn_scan_axis.axis_id</a>
4516 <a href="#_diffrn_scan_axis.angle_start" >_diffrn_scan_axis.angle_start</a>
4517 <a href="#_diffrn_scan_axis.angle_range" >_diffrn_scan_axis.angle_range</a>
4518 <a href="#_diffrn_scan_axis.angle_increment" >_diffrn_scan_axis.angle_increment</a>
4519 <a href="#_diffrn_scan_axis.displacement_start" >_diffrn_scan_axis.displacement_start</a>
4520 <a href="#_diffrn_scan_axis.displacement_range" >_diffrn_scan_axis.displacement_range</a>
4521 <a href="#_diffrn_scan_axis.displacement_increment" >_diffrn_scan_axis.displacement_increment</a>
4522 SCAN1 GONIOMETER_OMEGA 12.0 1.0 1.0 0.0 0.0 0.0
4523 SCAN1 GONIOMETER_KAPPA 23.3 0.0 0.0 0.0 0.0 0.0
4524 SCAN1 GONIOMETER_PHI -165.8 0.0 0.0 0.0 0.0 0.0
4525 SCAN1 DETECTOR_Z 0.0 0.0 0.0 -240.0 0.0 0.0
4526 SCAN1 DETECTOR_Y 0.0 0.0 0.0 0.6 0.0 0.0
4527 SCAN1 DETECTOR_X 0.0 0.0 0.0 -0.5 0.0 0.0
4528 SCAN1 DETECTOR_PITCH 0.0 0.0 0.0 0.0 0.0 0.0
4529
4530 # category <a href="#DIFFRN_SCAN_FRAME">DIFFRN_SCAN_FRAME</a>
4531 loop_
4532 <a href="#_diffrn_scan_frame.frame_id" >_diffrn_scan_frame.frame_id</a>
4533 <a href="#_diffrn_scan_frame.frame_number" >_diffrn_scan_frame.frame_number</a>
4534 <a href="#_diffrn_scan_frame.integration_time" >_diffrn_scan_frame.integration_time</a>
4535 <a href="#_diffrn_scan_frame.scan_id" >_diffrn_scan_frame.scan_id</a>
4536 <a href="#_diffrn_scan_frame.date" >_diffrn_scan_frame.date</a>
4537 FRAME1 1 20.0 SCAN1 1997-12-04T10:23:48
4538
4539 # category <a href="#DIFFRN_SCAN_FRAME_AXIS">DIFFRN_SCAN_FRAME_AXIS</a>
4540 loop_
4541 <a href="#_diffrn_scan_frame_axis.frame_id" >_diffrn_scan_frame_axis.frame_id</a>
4542 <a href="#_diffrn_scan_frame_axis.axis_id" >_diffrn_scan_frame_axis.axis_id</a>
4543 <a href="#_diffrn_scan_frame_axis.angle" >_diffrn_scan_frame_axis.angle</a>
4544 <a href="#_diffrn_scan_frame_axis.displacement" >_diffrn_scan_frame_axis.displacement</a>
4545 FRAME1 GONIOMETER_OMEGA 12.0 0.0
4546 FRAME1 GONIOMETER_KAPPA 23.3 0.0
4547 FRAME1 GONIOMETER_PHI -165.8 0.0
4548 FRAME1 DETECTOR_Z 0.0 -240.0
4549 FRAME1 DETECTOR_Y 0.0 0.6
4550 FRAME1 DETECTOR_X 0.0 -0.5
4551 FRAME1 DETECTOR_PITCH 0.0 0.0
4552
4553 # category <a href="#AXIS">AXIS</a>
4554 loop_
4555 <a href="#_axis.id">_axis.id</a>
4556 <a href="#_axis.type">_axis.type</a>
4557 <a href="#_axis.equipment">_axis.equipment</a>
4558 <a href="#_axis.depends_on">_axis.depends_on</a>
4559 <a href="#_axis.vector[1]">_axis.vector[1]</a> <a href="#_axis.vector[2]">_axis.vector[2]</a> <a href="#_axis.vector[3]">_axis.vector[3]</a>
4560 <a href="#_axis.offset[1]">_axis.offset[1]</a> <a href="#_axis.offset[2]">_axis.offset[2]</a> <a href="#_axis.offset[3]">_axis.offset[3]</a>
4561 GONIOMETER_OMEGA rotation goniometer . 1 0 0 . . .
4562 GONIOMETER_KAPPA rotation goniometer GONIOMETER_OMEGA 0.64279
4563 0 0.76604 . . .
4564 GONIOMETER_PHI rotation goniometer GONIOMETER_KAPPA 1 0 0
4565 . . .
4566 SOURCE general source . 0 0 1 . . .
4567 GRAVITY general gravity . 0 -1 0 . . .
4568 DETECTOR_Z translation detector . 0 0 1 0 0 0
4569 DETECTOR_Y translation detector DETECTOR_Z 0 1 0 0 0 0
4570 DETECTOR_X translation detector DETECTOR_Y 1 0 0 0 0 0
4571 DETECTOR_PITCH rotation detector DETECTOR_X 0 1 0 0 0 0
4572 ELEMENT_ROT translation detector DETECTOR_PITCH 0 0 1 0 0 0
4573 ELEMENT_RAD translation detector ELEMENT_ROT 0 1 0 0 0 0
4574
4575 # category <a href="#ARRAY_STRUCTURE_LIST">ARRAY_STRUCTURE_LIST</a>
4576 loop_
4577 <a href="#_array_structure_list.array_id">_array_structure_list.array_id</a>
4578 <a href="#_array_structure_list.index">_array_structure_list.index</a>
4579 <a href="#_array_structure_list.dimension">_array_structure_list.dimension</a>
4580 <a href="#_array_structure_list.precedence">_array_structure_list.precedence</a>
4581 <a href="#_array_structure_list.direction">_array_structure_list.direction</a>
4582 <a href="#_array_structure_list.axis_set_id">_array_structure_list.axis_set_id</a>
4583 ARRAY1 1 8309900 1 increasing ELEMENT_SPIRAL
4584
4585 # category <a href="#ARRAY_STRUCTURE_LIST_AXIS">ARRAY_STRUCTURE_LIST_AXIS</a>
4586 loop_
4587 <a href="#_array_structure_list_axis.axis_set_id">_array_structure_list_axis.axis_set_id</a>
4588 <a href="#_array_structure_list_axis.axis_id">_array_structure_list_axis.axis_id</a>
4589 <a href="#_array_structure_list_axis.angle">_array_structure_list_axis.angle</a>
4590 <a href="#_array_structure_list_axis.displacement">_array_structure_list_axis.displacement</a>
4591 <a href="#_array_structure_list_axis.angular_pitch">_array_structure_list_axis.angular_pitch</a>
4592 <a href="#_array_structure_list_axis.radial_pitch">_array_structure_list_axis.radial_pitch</a>
4593 ELEMENT_SPIRAL ELEMENT_ROT 0 . 0.075 .
4594 ELEMENT_SPIRAL ELEMENT_RAD . 172.5 . -0.150
4595
4596 # category <a href="#ARRAY_ELEMENT_SIZE">ARRAY_ELEMENT_SIZE</a>
4597 # the actual pixels are 0.075 by 0.150 mm
4598 # We give the coarser dimension here.
4599 loop_
4600 <a href="#_array_element_size.array_id">_array_element_size.array_id</a>
4601 <a href="#_array_element_size.index">_array_element_size.index</a>
4602 <a href="#_array_element_size.index">_array_element_size.size</a>
4603 ARRAY1 1 150e-6
4604
4605 # category <a href="#ARRAY_INTENSITIES">ARRAY_INTENSITIES</a>
4606 loop_
4607 <a href="#_array_intensities.array_id">_array_intensities.array_id</a>
4608 <a href="#_array_intensities.binary_id">_array_intensities.binary_id</a>
4609 <a href="#_array_intensities.linearity">_array_intensities.linearity</a>
4610 <a href="#_array_intensities.gain">_array_intensities.gain</a>
4611 <a href="#_array_intensities.gain_esd">_array_intensities.gain_esd</a>
4612 <a href="#_array_intensities.overload">_array_intensities.overload</a>
4613 <a href="#_array_intensities.undefined_value">_array_intensities.undefined_value</a>
4614 ARRAY1 1 linear 1.15 0.2 240000 0
4615
4616 # category <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a>
4617 loop_
4618 <a href="#_array_structure.id">_array_structure.id</a>
4619 <a href="#_array_structure.encoding_type">_array_structure.encoding_type</a>
4620 <a href="#_array_structure.compression_type">_array_structure.compression_type</a>
4621 <a href="#_array_structure.byte_order">_array_structure.byte_order</a>
4622 ARRAY1 "signed 32-bit integer" packed little_endian
4623
4624 # category <a href="#ARRAY_DATA">ARRAY_DATA</a>
4625 loop_
4626 <a href="#_array_data.array_id">_array_data.array_id</a>
4627 <a href="#_array_data.binary_id">_array_data.binary_id</a>
4628 <a href="#_array_data.data">_array_data.data</a>
4629 ARRAY1 1
4630 ;
4631 --CIF-BINARY-FORMAT-SECTION--
4632 Content-Type: application/octet-stream;
4633 conversions="<b>X</b>-CBF_PACKED"
4634 Content-Transfer-Encoding: BASE64
4635 <b>X</b>-Binary-Size: 3801324
4636 <b>X</b>-Binary-ID: 1
4637 <b>X</b>-Binary-Element-Type: "signed 32-bit integer"
4638 Content-MD5: 07lZFvF+aOcW85IN7usl8A==
4639
4640 AABRAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAZBQSr1sKNBOeOe9HITdMdDUnbq7bg
4641 ...
4642 8REo6TtBrxJ1vKqAvx9YDMD6J18Qg83OMr/tgssjMIJMXATDsZobL90AEXc4KigE
4643
4644 --CIF-BINARY-FORMAT-SECTION----
4645 ;
4646 ;
4647 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
4648 save_
4649
4650
4651 save_<a name="_diffrn_scan.id" >_diffrn_scan.id</a>
4652 _item_description.description
4653 ; The value of <a href="#_diffrn_scan.id" >_diffrn_scan.id</a> uniquely identifies each
4654 scan. The identifier is used to tie together all the
4655 information about the scan.
4656 ;
4657 loop_
4658 _item.name
4659 _item.category_id
4660 _item.mandatory_code
4661 '<a href="#_diffrn_scan.id" >_diffrn_scan.id</a>' diffrn_scan yes
4662 '<a href="#_diffrn_scan_axis.scan_id" >_diffrn_scan_axis.scan_id</a>' diffrn_scan_axis yes
4663 '<a href="#_diffrn_scan_frame.scan_id" >_diffrn_scan_frame.scan_id</a>' diffrn_scan_frame yes
4664 _item_type.code code
4665 loop_
4666 _item_linked.child_name
4667 _item_linked.parent_name
4668 '<a href="#_diffrn_scan_axis.scan_id" >_diffrn_scan_axis.scan_id</a>' '<a href="#_diffrn_scan.id" >_diffrn_scan.id</a>'
4669 '<a href="#_diffrn_scan_frame.scan_id" >_diffrn_scan_frame.scan_id</a>' '<a href="#_diffrn_scan.id" >_diffrn_scan.id</a>'
4670 save_
4671
4672
4673 save_<a name="_diffrn_scan.date_end">_diffrn_scan.date_end</a>
4674 _item_description.description
4675 ; The date and time of the end of the scan. Note that this
4676 may be an estimate generated during the scan, before the
4677 precise time of the end of the scan is known.
4678 ;
4679 _item.name '<a href="#_diffrn_scan.date_end">_diffrn_scan.date_end</a>'
4680 _item.category_id diffrn_scan
4681 _item.mandatory_code no
4682 _item_type.code yyyy-mm-dd
4683 save_
4684
4685
4686 save_<a name="_diffrn_scan.date_start">_diffrn_scan.date_start</a>
4687 _item_description.description
4688 ; The date and time of the start of the scan.
4689 ;
4690 _item.name '<a href="#_diffrn_scan.date_start">_diffrn_scan.date_start</a>'
4691 _item.category_id diffrn_scan
4692 _item.mandatory_code no
4693 _item_type.code yyyy-mm-dd
4694 save_
4695
4696
4697 save_<a name="_diffrn_scan.integration_time" >_diffrn_scan.integration_time</a>
4698 _item_description.description
4699 ; Approximate average time in seconds to integrate each
4700 step of the scan. The precise time for integration
4701 of each particular step must be provided in
4702 <a href="#_diffrn_scan_frame.integration_time" >_diffrn_scan_frame.integration_time</a>, even
4703 if all steps have the same integration time.
4704 ;
4705 _item.name '<a href="#_diffrn_scan.integration_time" >_diffrn_scan.integration_time</a>'
4706 _item.category_id diffrn_scan
4707 _item.mandatory_code no
4708 _item_type.code float
4709 _item_units.code 'seconds'
4710 loop_
4711 _item_range.maximum
4712 _item_range.minimum
4713 . 0.0
4714 save_
4715
4716
4717 save_<a name="_diffrn_scan.frame_id_start" >_diffrn_scan.frame_id_start</a>
4718 _item_description.description
4719 ; The value of this data item is the identifier of the
4720 first frame in the scan.
4721
4722 This item is a pointer to <a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a> in the
4723 <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a> category.
4724 ;
4725 _item.name '<a href="#_diffrn_scan.frame_id_start" >_diffrn_scan.frame_id_start</a>'
4726 _item.category_id diffrn_scan
4727 _item.mandatory_code yes
4728 _item_type.code code
4729 save_
4730
4731
4732 save_<a name="_diffrn_scan.frame_id_end" >_diffrn_scan.frame_id_end</a>
4733 _item_description.description
4734 ; The value of this data item is the identifier of the
4735 last frame in the scan.
4736
4737 This item is a pointer to <a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a> in the
4738 <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a> category.
4739 ;
4740 _item.name '<a href="#_diffrn_scan.frame_id_end" >_diffrn_scan.frame_id_end</a>'
4741 _item.category_id diffrn_scan
4742 _item.mandatory_code yes
4743 _item_type.code code
4744 save_
4745
4746
4747 save_<a name="_diffrn_scan.frames" >_diffrn_scan.frames</a>
4748 _item_description.description
4749 ; The value of this data item is the number of frames in
4750 the scan.
4751 ;
4752 _item.name '<a href="#_diffrn_scan.frames" >_diffrn_scan.frames</a>'
4753 _item.category_id diffrn_scan
4754 _item.mandatory_code no
4755 _item_type.code int
4756 loop_
4757 _item_range.maximum
4758 _item_range.minimum
4759 . 1
4760 1 1
4761 save_
4762
4763
4764 ####################
4765 # <a name="DIFFRN_SCAN_AXIS">DIFFRN_SCAN_AXIS</a> #
4766 ####################
4767
4768 save_DIFFRN_SCAN_AXIS
4769 _category.description
4770 ; Data items in the <a href="#DIFFRN_SCAN_AXIS">DIFFRN_SCAN_AXIS</a> category describe the settings of
4771 axes for particular scans. Unspecified axes are assumed to be at
4772 their zero points.
4773 ;
4774 _category.id diffrn_scan_axis
4775 _category.mandatory_code no
4776 loop_
4777 _category_key.name
4778 '<a href="#_diffrn_scan_axis.scan_id" >_diffrn_scan_axis.scan_id</a>'
4779 '<a href="#_diffrn_scan_axis.axis_id" >_diffrn_scan_axis.axis_id</a>'
4780 loop_
4781 _category_group.id 'inclusive_group'
4782 'diffrn_group'
4783 save_
4784
4785
4786 save_<a name="_diffrn_scan_axis.scan_id" >_diffrn_scan_axis.scan_id</a>
4787 _item_description.description
4788 ; The value of this data item is the identifier of the
4789 scan for which axis settings are being specified.
4790
4791 Multiple axes may be specified for the same value of
4792 <a href="#_diffrn_scan.id" >_diffrn_scan.id</a>.
4793
4794 This item is a pointer to <a href="#_diffrn_scan.id" >_diffrn_scan.id</a> in the
4795 <a href="#DIFFRN_SCAN">DIFFRN_SCAN</a> category.
4796 ;
4797 _item.name '<a href="#_diffrn_scan_axis.scan_id" >_diffrn_scan_axis.scan_id</a>'
4798 _item.category_id diffrn_scan_axis
4799 _item.mandatory_code yes
4800 _item_type.code code
4801 save_
4802
4803
4804 save_<a name="_diffrn_scan_axis.axis_id" >_diffrn_scan_axis.axis_id</a>
4805 _item_description.description
4806 ; The value of this data item is the identifier of one of
4807 the axes for the scan for which settings are being specified.
4808
4809 Multiple axes may be specified for the same value of
4810 <a href="#_diffrn_scan.id" >_diffrn_scan.id</a>.
4811
4812 This item is a pointer to <a href="#_axis.id" >_axis.id</a> in the
4813 AXIS category.
4814 ;
4815 _item.name '<a href="#_diffrn_scan_axis.axis_id" >_diffrn_scan_axis.axis_id</a>'
4816 _item.category_id diffrn_scan_axis
4817 _item.mandatory_code yes
4818 _item_type.code code
4819 save_
4820
4821
4822 save_<a name="_diffrn_scan_axis.angle_start" >_diffrn_scan_axis.angle_start</a>
4823 _item_description.description
4824 ; The starting position for the specified axis in degrees.
4825 ;
4826 _item.name '<a href="#_diffrn_scan_axis.angle_start" >_diffrn_scan_axis.angle_start</a>'
4827 _item.category_id diffrn_scan_axis
4828 _item.mandatory_code no
4829 _item_default.value 0.0
4830 _item_type.code float
4831 _item_units.code 'degrees'
4832 save_
4833
4834
4835 save_<a name="_diffrn_scan_axis.angle_range" >_diffrn_scan_axis.angle_range</a>
4836 _item_description.description
4837 ; The range from the starting position for the specified axis
4838 in degrees.
4839 ;
4840 _item.name '<a href="#_diffrn_scan_axis.angle_range" >_diffrn_scan_axis.angle_range</a>'
4841 _item.category_id diffrn_scan_axis
4842 _item.mandatory_code no
4843 _item_default.value 0.0
4844 _item_type.code float
4845 _item_units.code 'degrees'
4846 save_
4847
4848
4849 save_<a name="_diffrn_scan_axis.angle_increment" >_diffrn_scan_axis.angle_increment</a>
4850 _item_description.description
4851 ; The increment for each step for the specified axis
4852 in degrees. In general, this will agree with
4853 <a href="#_diffrn_scan_frame_axis.angle_increment" >_diffrn_scan_frame_axis.angle_increment</a>. The
4854 sum of the values of <a href="#_diffrn_scan_frame_axis.angle">_diffrn_scan_frame_axis.angle</a> and
4855 <a href="#_diffrn_scan_frame_axis.angle_increment">_diffrn_scan_frame_axis.angle_increment</a> is the
4856 angular setting of the axis at the end of the integration
4857 time for a given frame. If the individual frame values
4858 vary, then the value of
4859 <a href="#_diffrn_scan_axis.angle_increment">_diffrn_scan_axis.angle_increment</a> will be
4860 representative
4861 of the ensemble of values of
4862 <a href="#_diffrn_scan_frame_axis.angle_increment">_diffrn_scan_frame_axis.angle_increment</a> (e.g.
4863 the mean).
4864 ;
4865 _item.name '<a href="#_diffrn_scan_axis.angle_increment" >_diffrn_scan_axis.angle_increment</a>'
4866 _item.category_id diffrn_scan_axis
4867 _item.mandatory_code no
4868 _item_default.value 0.0
4869 _item_type.code float
4870 _item_units.code 'degrees'
4871 save_
4872
4873
4874 save_<a name="_diffrn_scan_axis.angle_rstrt_incr">_diffrn_scan_axis.angle_rstrt_incr</a>
4875 _item_description.description
4876 ; The increment after each step for the specified axis
4877 in degrees. In general, this will agree with
4878 <a href="#_diffrn_scan_frame_axis.angle_rstrt_incr" >_diffrn_scan_frame_axis.angle_rstrt_incr</a>. The
4879 sum of the values of <a href="#_diffrn_scan_frame_axis.angle" >_diffrn_scan_frame_axis.angle</a>,
4880 <a href="#_diffrn_scan_frame_axis.angle_increment" >_diffrn_scan_frame_axis.angle_increment</a>
4881 and <a href="#_diffrn_scan_frame_axis.angle_rstrt_incr" >_diffrn_scan_frame_axis.angle_rstrt_incr</a> is the
4882 angular setting of the axis at the start of the integration
4883 time for the next frame relative to a given frame and
4884 should equal <a href="#_diffrn_scan_frame_axis.angle" >_diffrn_scan_frame_axis.angle</a> for this
4885 next frame. If the individual frame values
4886 vary, then the value of
4887 <a href="#_diffrn_scan_axis.angle_rstrt_incr" >_diffrn_scan_axis.angle_rstrt_incr</a> will be
4888 representative
4889 of the ensemble of values of
4890 <a href="#_diffrn_scan_frame_axis.angle_rstrt_incr" >_diffrn_scan_frame_axis.angle_rstrt_incr</a> (e.g.
4891 the mean).
4892 ;
4893 _item.name '<a href="#_diffrn_scan_axis.angle_rstrt_incr">_diffrn_scan_axis.angle_rstrt_incr</a>'
4894 _item.category_id diffrn_scan_axis
4895 _item.mandatory_code no
4896 _item_default.value 0.0
4897 _item_type.code float
4898 _item_units.code 'degrees'
4899 save_
4900
4901
4902 save_<a name="_diffrn_scan_axis.displacement_start" >_diffrn_scan_axis.displacement_start</a>
4903 _item_description.description
4904 ; The starting position for the specified axis in millimetres.
4905 ;
4906 _item.name '<a href="#_diffrn_scan_axis.displacement_start" >_diffrn_scan_axis.displacement_start</a>'
4907 _item.category_id diffrn_scan_axis
4908 _item.mandatory_code no
4909 _item_default.value 0.0
4910 _item_type.code float
4911 _item_units.code 'millimetres'
4912 save_
4913
4914
4915 save_<a name="_diffrn_scan_axis.displacement_range" >_diffrn_scan_axis.displacement_range</a>
4916 _item_description.description
4917 ; The range from the starting position for the specified axis
4918 in millimetres.
4919 ;
4920 _item.name '<a href="#_diffrn_scan_axis.displacement_range" >_diffrn_scan_axis.displacement_range</a>'
4921 _item.category_id diffrn_scan_axis
4922 _item.mandatory_code no
4923 _item_default.value 0.0
4924 _item_type.code float
4925 _item_units.code 'millimetres'
4926 save_
4927
4928
4929 save_<a name="_diffrn_scan_axis.displacement_increment" >_diffrn_scan_axis.displacement_increment</a>
4930 _item_description.description
4931 ; The increment for each step for the specified axis
4932 in millimetres. In general, this will agree with
4933 <a href="#_diffrn_scan_frame_axis.displacement_increment">_diffrn_scan_frame_axis.displacement_increment</a>.
4934 The sum of the values of
4935 <a href="#_diffrn_scan_frame_axis.displacement" >_diffrn_scan_frame_axis.displacement</a> and
4936 <a href="#_diffrn_scan_frame_axis.displacement_increment" >_diffrn_scan_frame_axis.displacement_increment</a> is the
4937 angular setting of the axis at the end of the integration
4938 time for a given frame. If the individual frame values
4939 vary, then the value of
4940 <a href="#_diffrn_scan_axis.displacement_increment" >_diffrn_scan_axis.displacement_increment</a> will be
4941 representative
4942 of the ensemble of values of
4943 <a href="#_diffrn_scan_frame_axis.displacement_increment" >_diffrn_scan_frame_axis.displacement_increment</a> (e.g.
4944 the mean).
4945 ;
4946 _item.name '<a href="#_diffrn_scan_axis.displacement_increment" >_diffrn_scan_axis.displacement_increment</a>'
4947 _item.category_id diffrn_scan_axis
4948 _item.mandatory_code no
4949 _item_default.value 0.0
4950 _item_type.code float
4951 _item_units.code 'millimetres'
4952 save_
4953
4954
4955 save_<a name="_diffrn_scan_axis.displacement_rstrt_incr">_diffrn_scan_axis.displacement_rstrt_incr</a>
4956 _item_description.description
4957 ; The increment for each step for the specified axis
4958 in millimetres. In general, this will agree with
4959 <a href="#_diffrn_scan_frame_axis.displacement_rstrt_incr">_diffrn_scan_frame_axis.displacement_rstrt_incr</a>.
4960 The sum of the values of
4961 <a href="#_diffrn_scan_frame_axis.displacement" >_diffrn_scan_frame_axis.displacement</a>,
4962 <a href="#_diffrn_scan_frame_axis.displacement_increment" >_diffrn_scan_frame_axis.displacement_increment</a> and
4963 <a href="#_diffrn_scan_frame_axis.displacement_rstrt_incr" >_diffrn_scan_frame_axis.displacement_rstrt_incr</a> is the
4964 angular setting of the axis at the start of the integration
4965 time for the next frame relative to a given frame and
4966 should equal <a href="#_diffrn_scan_frame_axis.displacement" >_diffrn_scan_frame_axis.displacement</a>
4967 for this next frame. If the individual frame values
4968 vary, then the value of
4969 <a href="#_diffrn_scan_axis.displacement_rstrt_incr" >_diffrn_scan_axis.displacement_rstrt_incr</a> will be
4970 representative
4971 of the ensemble of values of
4972 <a href="#_diffrn_scan_frame_axis.displacement_rstrt_incr" >_diffrn_scan_frame_axis.displacement_rstrt_incr</a> (e.g.
4973 the mean).
4974 ;
4975 _item.name '<a href="#_diffrn_scan_axis.displacement_rstrt_incr">_diffrn_scan_axis.displacement_rstrt_incr</a>'
4976 _item.category_id diffrn_scan_axis
4977 _item.mandatory_code no
4978 _item_default.value 0.0
4979 _item_type.code float
4980 _item_units.code 'millimetres'
4981 save_
4982
4983 save_<a name="_diffrn_scan_axis.reference_angle">_diffrn_scan_axis.reference_angle</a>
4984 _item_description.description
4985 ; The setting of the specified axis in degrees
4986 against which measurements of the reference beam center
4987 and reference detector distance should be made.
4988
4989 In general, this will agree with
4990 <a href="#_diffrn_scan_frame_axis.reference_angle">_diffrn_scan_frame_axis.reference_angle</a>.
4991
4992 If the individual frame values vary, then the value of
4993 <a href="#_diffrn_scan_axis.reference_angle">_diffrn_scan_axis.reference_angle</a> will be
4994 representative of the ensemble of values of
4995 <a href="#_diffrn_scan_frame_axis.reference_angle">_diffrn_scan_frame_axis.reference_angle</a> (e.g.
4996 the mean).
4997
4998 If not specified, the value defaults to zero.
4999 ;
5000 _item.name '<a href="#_diffrn_scan_axis.reference_angle">_diffrn_scan_axis.reference_angle</a>'
5001 _item.category_id diffrn_scan_axis
5002 _item.mandatory_code implicit
5003 _item_default.value 0.0
5004 _item_type.code float
5005 _item_units.code 'degrees'
5006 save_
5007
5008
5009 save_<a name="_diffrn_scan_axis.reference_displacement">_diffrn_scan_axis.reference_displacement</a>
5010 _item_description.description
5011 ; The setting of the specified axis in millimetres
5012 against which measurements of the reference beam center
5013 and reference detector distance should be made.
5014
5015 In general, this will agree with
5016 <a href="#_diffrn_scan_frame_axis.reference_displacement">_diffrn_scan_frame_axis.reference_displacement</a>.
5017
5018 If the individual frame values vary, then the value of
5019 <a href="#_diffrn_scan_axis.reference_displacement">_diffrn_scan_axis.reference_displacement</a> will be
5020 representative of the ensemble of values of
5021 <a href="#_diffrn_scan_frame_axis.reference_displacement">_diffrn_scan_frame_axis.reference_displacement</a> (e.g.
5022 the mean).
5023
5024 If not specified, the value defaults to to the value of
5025 <a href="#">_diffrn_scan_axis.displacement</a>.
5026 ;
5027 _item.name '<a href="#_diffrn_scan_axis.reference_displacement">_diffrn_scan_axis.reference_displacement</a>'
5028 _item.category_id diffrn_scan_axis
5029 _item.mandatory_code implicit
5030 _item_type.code float
5031 _item_units.code 'millimetres'
5032 save_
5033
5034
5035
5036 #####################
5037 # <a name="DIFFRN_SCAN_FRAME">DIFFRN_SCAN_FRAME</a> #
5038 #####################
5039
5040 save_DIFFRN_SCAN_FRAME
5041 _category.description
5042 ; Data items in the <a href="#DIFFRN_SCAN_FRAME">DIFFRN_SCAN_FRAME</a> category describe
5043 the relationships of particular frames to scans.
5044 ;
5045 _category.id diffrn_scan_frame
5046 _category.mandatory_code no
5047 loop_
5048 _category_key.name
5049 '<a href="#_diffrn_scan_frame.scan_id" >_diffrn_scan_frame.scan_id</a>'
5050 '<a href="#_diffrn_scan_frame.frame_id" >_diffrn_scan_frame.frame_id</a>'
5051 loop_
5052 _category_group.id 'inclusive_group'
5053 'diffrn_group'
5054 save_
5055
5056
5057 save_<a name="_diffrn_scan_frame.date">_diffrn_scan_frame.date</a>
5058 _item_description.description
5059 ; The date and time of the start of the frame being scanned.
5060 ;
5061 _item.name '<a href="#_diffrn_scan_frame.date">_diffrn_scan_frame.date</a>'
5062 _item.category_id diffrn_scan_frame
5063 _item.mandatory_code no
5064 _item_type.code yyyy-mm-dd
5065 save_
5066
5067
5068 save_<a name="_diffrn_scan_frame.frame_id" >_diffrn_scan_frame.frame_id</a>
5069 _item_description.description
5070 ; The value of this data item is the identifier of the
5071 frame being examined.
5072
5073 This item is a pointer to <a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a> in the
5074 <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a> category.
5075 ;
5076 _item.name '<a href="#_diffrn_scan_frame.frame_id" >_diffrn_scan_frame.frame_id</a>'
5077 _item.category_id diffrn_scan_frame
5078 _item.mandatory_code yes
5079 _item_type.code code
5080 save_
5081
5082
5083 save_<a name="_diffrn_scan_frame.frame_number" >_diffrn_scan_frame.frame_number</a>
5084 _item_description.description
5085 ; The value of this data item is the number of the frame
5086 within the scan, starting with 1. It is not necessarily
5087 the same as the value of <a href="#_diffrn_scan_frame.frame_id">_diffrn_scan_frame.frame_id</a>,
5088 but it may be.
5089
5090 ;
5091 _item.name '<a href="#_diffrn_scan_frame.frame_number" >_diffrn_scan_frame.frame_number</a>'
5092 _item.category_id diffrn_scan_frame
5093 _item.mandatory_code no
5094 _item_type.code int
5095 loop_
5096 _item_range.maximum
5097 _item_range.minimum
5098 . 0
5099 0 0
5100 save_
5101
5102
5103 save_<a name="_diffrn_scan_frame.integration_time">_diffrn_scan_frame.integration_time</a>
5104 _item_description.description
5105 ; The time in seconds to integrate this step of the scan.
5106 This should be the precise time of integration of each
5107 particular frame. The value of this data item should
5108 be given explicitly for each frame and not inferred
5109 from the value of <a href="#_diffrn_scan.integration_time" >_diffrn_scan.integration_time</a>.
5110 ;
5111 _item.name '<a href="#_diffrn_scan_frame.integration_time" >_diffrn_scan_frame.integration_time</a>'
5112 _item.category_id diffrn_scan_frame
5113 _item.mandatory_code yes
5114 _item_type.code float
5115 _item_units.code 'seconds'
5116 loop_
5117 _item_range.maximum
5118 _item_range.minimum
5119 . 0.0
5120 save_
5121
5122
5123 save_<a name="_diffrn_scan_frame.scan_id" >_diffrn_scan_frame.scan_id</a>
5124 _item_description.description
5125 ; The value of <a href="#_diffrn_scan_frame.scan_id" >_diffrn_scan_frame.scan_id</a> identifies the scan
5126 containing this frame.
5127
5128 This item is a pointer to <a href="#_diffrn_scan.id" >_diffrn_scan.id</a> in the
5129 <a href="#DIFFRN_SCAN">DIFFRN_SCAN</a> category.
5130 ;
5131 _item.name '<a href="#_diffrn_scan_frame.scan_id">_diffrn_scan_frame.scan_id</a>'
5132 _item.category_id diffrn_scan_frame
5133 _item.mandatory_code yes
5134 _item_type.code code
5135 save_
5136
5137
5138 ##########################
5139 # <a name="DIFFRN_SCAN_FRAME_AXIS">DIFFRN_SCAN_FRAME_AXIS</a> #
5140 ##########################
5141
5142 save_DIFFRN_SCAN_FRAME_AXIS
5143 _category.description
5144 ; Data items in the <a href="#DIFFRN_SCAN_FRAME_AXIS">DIFFRN_SCAN_FRAME_AXIS</a> category describe the
5145 settings of axes for particular frames. Unspecified axes are
5146 assumed to be at their zero points. If, for any given frame,
5147 nonzero values apply for any of the data items in this category,
5148 those values should be given explicitly in this category and not
5149 simply inferred from values in <a href="#DIFFRN_SCAN_AXIS">DIFFRN_SCAN_AXIS</a>.
5150 ;
5151 _category.id diffrn_scan_frame_axis
5152 _category.mandatory_code no
5153 loop_
5154 _category_key.name
5155 '<a href="#_diffrn_scan_frame_axis.frame_id" >_diffrn_scan_frame_axis.frame_id</a>'
5156 '<a href="#_diffrn_scan_frame_axis.axis_id" >_diffrn_scan_frame_axis.axis_id</a>'
5157 loop_
5158 _category_group.id 'inclusive_group'
5159 'diffrn_group'
5160 save_
5161
5162
5163 save_<a name="_diffrn_scan_frame_axis.axis_id" >_diffrn_scan_frame_axis.axis_id</a>
5164 _item_description.description
5165 ; The value of this data item is the identifier of one of
5166 the axes for the frame for which settings are being specified.
5167
5168 Multiple axes may be specified for the same value of
5169 <a href="#_diffrn_scan_frame.id" >_diffrn_scan_frame.frame_id</a>.
5170
5171 This item is a pointer to <a href="#_axis.id" >_axis.id</a> in the
5172 <a href="#AXIS">AXIS</a> category.
5173 ;
5174 _item.name '<a href="#_diffrn_scan_frame_axis.axis_id" >_diffrn_scan_frame_axis.axis_id</a>'
5175 _item.category_id diffrn_scan_frame_axis
5176 _item.mandatory_code yes
5177 _item_type.code code
5178 save_
5179
5180
5181 save_<a name="_diffrn_scan_frame_axis.angle" >_diffrn_scan_frame_axis.angle</a>
5182 _item_description.description
5183 ; The setting of the specified axis in degrees for this frame.
5184 This is the setting at the start of the integration time.
5185 ;
5186 _item.name '<a href="#_diffrn_scan_frame_axis.angle" >_diffrn_scan_frame_axis.angle</a>'
5187 _item.category_id diffrn_scan_frame_axis
5188 _item.mandatory_code no
5189 _item_default.value 0.0
5190 _item_type.code float
5191 _item_units.code 'degrees'
5192 save_
5193
5194
5195 save_<a name="_diffrn_scan_frame_axis.angle_increment">_diffrn_scan_frame_axis.angle_increment</a>
5196 _item_description.description
5197 ; The increment for this frame for the angular setting of
5198 the specified axis in degrees. The sum of the values
5199 of <a href="#_diffrn_scan_frame_axis.angle">_diffrn_scan_frame_axis.angle</a> and
5200 <a href="#_diffrn_scan_frame_axis.angle_increment">_diffrn_scan_frame_axis.angle_increment</a> is the
5201 angular setting of the axis at the end of the integration
5202 time for this frame.
5203 ;
5204 _item.name '<a href="#_diffrn_scan_frame_axis.angle_increment">_diffrn_scan_frame_axis.angle_increment</a>'
5205 _item.category_id diffrn_scan_frame_axis
5206 _item.mandatory_code no
5207 _item_default.value 0.0
5208 _item_type.code float
5209 _item_units.code 'degrees'
5210 save_
5211
5212
5213 save_<a name="_diffrn_scan_frame_axis.angle_rstrt_incr">_diffrn_scan_frame_axis.angle_rstrt_incr</a>
5214 _item_description.description
5215 ; The increment after this frame for the angular setting of
5216 the specified axis in degrees. The sum of the values
5217 of <a href="#_diffrn_scan_frame_axis.angle">_diffrn_scan_frame_axis.angle</a>,
5218 <a href="#_diffrn_scan_frame_axis.angle_increment">_diffrn_scan_frame_axis.angle_increment</a> and
5219 <a href="#_diffrn_scan_frame_axis.angle_rstrt_incr">_diffrn_scan_frame_axis.angle_rstrt_incr</a> is the
5220 angular setting of the axis at the start of the integration
5221 time for the next frame and should equal
5222 <a href="#_diffrn_scan_frame_axis.angle">_diffrn_scan_frame_axis.angle</a> for this next frame.
5223 ;
5224 _item.name '<a href="#_diffrn_scan_frame_axis.angle_rstrt_incr">_diffrn_scan_frame_axis.angle_rstrt_incr</a>'
5225 _item.category_id diffrn_scan_frame_axis
5226 _item.mandatory_code no
5227 _item_default.value 0.0
5228 _item_type.code float
5229 _item_units.code 'degrees'
5230 save_
5231
5232
5233 save_<a name="_diffrn_scan_frame_axis.displacement" >_diffrn_scan_frame_axis.displacement</a>
5234 _item_description.description
5235 ; The setting of the specified axis in millimetres for this
5236 frame. This is the setting at the start of the integration
5237 time.
5238 ;
5239 _item.name '<a href="#_diffrn_scan_frame_axis.displacement" >_diffrn_scan_frame_axis.displacement</a>'
5240 _item.category_id diffrn_scan_frame_axis
5241 _item.mandatory_code no
5242 _item_default.value 0.0
5243 _item_type.code float
5244 _item_units.code 'millimetres'
5245 save_
5246
5247
5248 save_<a name="_diffrn_scan_frame_axis.displacement_increment">_diffrn_scan_frame_axis.displacement_increment</a>
5249 _item_description.description
5250 ; The increment for this frame for the displacement setting of
5251 the specified axis in millimetres. The sum of the values
5252 of <a href="#_diffrn_scan_frame_axis.displacement">_diffrn_scan_frame_axis.displacement</a> and
5253 <a href="#_diffrn_scan_frame_axis.displacement_increment">_diffrn_scan_frame_axis.displacement_increment</a> is the
5254 angular setting of the axis at the end of the integration
5255 time for this frame.
5256 ;
5257 _item.name '<a href="#_diffrn_scan_frame_axis.displacement_increment">_diffrn_scan_frame_axis.displacement_increment</a>'
5258 _item.category_id diffrn_scan_frame_axis
5259 _item.mandatory_code no
5260 _item_default.value 0.0
5261 _item_type.code float
5262 _item_units.code 'millimetres'
5263 save_
5264
5265
5266 save_<a name="_diffrn_scan_frame_axis.displacement_rstrt_incr">_diffrn_scan_frame_axis.displacement_rstrt_incr</a>
5267 _item_description.description
5268 ; The increment for this frame for the displacement setting of
5269 the specified axis in millimetres. The sum of the values
5270 of <a href="#_diffrn_scan_frame_axis.displacement">_diffrn_scan_frame_axis.displacement</a>,
5271 <a href="#_diffrn_scan_frame_axis.displacement_increment">_diffrn_scan_frame_axis.displacement_increment</a> and
5272 <a href="#_diffrn_scan_frame_axis.displacement_rstrt_incr">_diffrn_scan_frame_axis.displacement_rstrt_incr</a> is the
5273 angular setting of the axis at the start of the integration
5274 time for the next frame and should equal
5275 <a href="#_diffrn_scan_frame_axis.displacement">_diffrn_scan_frame_axis.displacement</a> for this next frame.
5276 ;
5277 _item.name '<a href="#_diffrn_scan_frame_axis.displacement_rstrt_incr">_diffrn_scan_frame_axis.displacement_rstrt_incr</a>'
5278 _item.category_id diffrn_scan_frame_axis
5279 _item.mandatory_code no
5280 _item_default.value 0.0
5281 _item_type.code float
5282 _item_units.code 'millimetres'
5283 save_
5284
5285 save_<a name="_diffrn_scan_frame_axis.frame_id" >_diffrn_scan_frame_axis.frame_id</a>
5286 _item_description.description
5287 ; The value of this data item is the identifier of the
5288 frame for which axis settings are being specified.
5289
5290 Multiple axes may be specified for the same value of
5291 <a href="#_diffrn_scan_frame.frame_id" >_diffrn_scan_frame.frame_id</a>.
5292
5293 This item is a pointer to <a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a> in the
5294 <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a> category.
5295 ;
5296 _item.name '<a href="#_diffrn_scan_frame_axis.frame_id" >_diffrn_scan_frame_axis.frame_id</a>'
5297 _item.category_id diffrn_scan_frame_axis
5298 _item.mandatory_code yes
5299 _item_type.code code
5300 save_
5301
5302 save_<a name="_diffrn_scan_frame_axis.reference_angle" >_diffrn_scan_frame_axis.reference_angle</a>
5303 _item_description.description
5304 ; The setting of the specified axis in degrees
5305 against which measurements of the reference beam center
5306 and reference detector distance should be made.
5307
5308 This is normally the same for all frames, but the
5309 option is provided here of making changes when
5310 needed.
5311
5312 If not provided, it is assumed to be zero.
5313 ;
5314 _item.name '<a href="#_diffrn_scan_frame_axis.reference_angle">_diffrn_scan_frame_axis.reference_angle</a>'
5315 _item.category_id diffrn_scan_frame_axis
5316 _item.mandatory_code implicit
5317 _item_default.value 0.0
5318 _item_type.code float
5319 _item_units.code 'degrees'
5320 save_
5321
5322
5323 save_<a name="_diffrn_scan_frame_axis.reference_displacement">_diffrn_scan_frame_axis.reference_displacement</a>
5324 _item_description.description
5325 ; The setting of the specified axis in millimetres for this
5326 frame against which measurements of the reference beam center
5327 and reference detector distance should be made.
5328
5329 This is normally the same for all frames, but the
5330 option is provided here of making changes when
5331 needed.
5332
5333 If not provided, it is assumed to be equal to
5334 <a href="#_diffrn_scan_frame_axis.displacement" >_diffrn_scan_frame_axis.displacement</a>.
5335 ;
5336 _item.name '<a href="#_diffrn_scan_frame_axis.reference_displacement">_diffrn_scan_frame_axis.reference_displacement</a>'
5337 _item.category_id diffrn_scan_frame_axis
5338 _item.mandatory_code implicit
5339 _item_type.code float
5340 _item_units.code 'millimetres'
5341 save_
5342
5343
5344
5345 #######
5346 # <a name="MAP">MAP</a> #
5347 #######
5348
5349 save_MAP
5350 _category.description
5351 ; Data items in the <a href="#MAP">MAP</a> category record
5352 the details of a maps. Maps record values of parameters,
5353 such as density, that are functions of position within
5354 a cell or are functions of orthogonal coordinates in
5355 three space.
5356
5357 A map may is composed of one or more map segments
5358 specified in the MAP_SEGMENT category.
5359
5360 Examples are given in the MAP_SEGMENT category.
5361 ;
5362 _category.id map
5363 _category.mandatory_code no
5364 loop_
5365 _category_key.name '<a href="#_map.id" >_map.id</a>'
5366 '<a href="#_map.diffrn_id" >_map.diffrn_id</a>'
5367 '<a href="#_map.entry_id" >_map.entry_id</a>'
5368 loop_
5369 _category_group.id 'inclusive_group'
5370 'array_data_group'
5371 loop_
5372 _category_examples.detail
5373 _category_examples.case
5374 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
5375 ; Example 1 - Identifying an observed density map
5376 and a calculated density map
5377 ;
5378 ;
5379
5380 loop_
5381 <a href="#_map.id" >_map.id</a>
5382 <a href="#_map.details" >_map.details</a>
5383
5384 rho_calc
5385 ;
5386 density calculated from F_calc derived from the ATOM_SITE list
5387 ;
5388 rho_obs
5389 ;
5390 density combining the observed structure factors with the
5391 calculated phases
5392 ;
5393 ;
5394
5395 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
5396 save_
5397
5398
5399 save_<a name="_map.details" >_map.details</a>
5400 _item_description.description
5401 ; The value of <a href="#_map.details" >_map.details</a> should give a
5402 description of special aspects of each map.
5403
5404 ;
5405 _item.name '<a name="_map.details" >_map.details</a>'
5406 _item.category_id map
5407 _item.mandatory_code no
5408 _item_type.code text
5409 loop_
5410 _item_examples.case
5411 _item_examples.detail
5412 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
5413 ; Example 1 - Identifying an observed density map
5414 and a calculated density map
5415 ;
5416 ;
5417
5418 loop_
5419 <a href="#_map.id" >_map.id</a>
5420 <a href="#_map.details" >_map.details</a>
5421
5422 rho_calc
5423 ;
5424 density calculated from F_calc derived from the ATOM_SITE list
5425 ;
5426 rho_obs
5427 ;
5428 density combining the observed structure factors with the
5429 calculated phases
5430 ;
5431 ;
5432
5433 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
5434 save_
5435
5436 save_<a name="_map.diffrn_id" >_map.diffrn_id</a>
5437 _item_description.description
5438 ; This item is a pointer to <a href="#_diffrn.id" >_diffrn.id</a> in the
5439 <a href="#DIFFRN">DIFFRN</a> category.
5440 ;
5441 _item.name '<a href="#_map.diffrn_id" >_map.diffrn_id</a>'
5442 _item.category_id map
5443 _item.mandatory_code implicit
5444 _item_type.code code
5445 save_
5446
5447 save_<a name="_map.entry_id" >_map.entry_id</a>
5448 _item_description.description
5449 ; This item is a pointer to <a href="#_entry.id" >_entry.id</a> in the
5450 <a href="#ENTRY">ENTRY</a> category.
5451 ;
5452 _item.name '<a href="#_map.entry_id" >_map.entry_id</a>'
5453 _item.category_id map
5454 _item.mandatory_code implicit
5455 _item_type.code code
5456 save_
5457
5458
5459 save_<a name="_map.id" >_map.id</a>
5460 _item_description.description
5461 ; The value of <a href="#_map.id" >_map.id</a> must uniquely identify
5462 each map for the given diffrn.id or entry.id.
5463 ;
5464 loop_
5465 _item.name
5466 _item.category_id
5467 _item.mandatory_code
5468 '<a href="#_map.id" >_map.id</a>' map yes
5469 '<a href="#_map_segment.id" >_map_segment.id</a>' map_segment yes
5470 _item_type.code code
5471 loop_
5472 _item_linked.child_name
5473 _item_linked.parent_name
5474 '<a href="#_map_segment.id" >_map_segment.id</a>' '<a href="#_map.id" >_map.id</a>'
5475 save_
5476
5477
5478
5479
5480 ###########################
5481 # <a name="MAP_SEGMENT">MAP_SEGMENT</a> #
5482 ###########################
5483
5484
5485 save_MAP_SEGMENT
5486 _category.description
5487 ; Data items in the <a href="#MAP_SEGMENT">MAP_SEGMENT</a> category record
5488 the details about each segment (section or brick) of a map.
5489 ;
5490 _category.id map_segment
5491 _category.mandatory_code no
5492 loop_
5493 _category_key.name '<a href="#_map_segment.id" >_map_segment.id</a>'
5494 '<a href="#_map_segment.map_id" >_map_segment.map_id</a>'
5495 loop_
5496 _category_group.id 'inclusive_group'
5497 'array_data_group'
5498 loop_
5499 _category_examples.detail
5500 _category_examples.case
5501 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
5502 ; Example 1 - Identifying an observed density map
5503 and a calculated density map, each consisting of one
5504 segment, both using the same array structure
5505 and mask.
5506 ;
5507 ;
5508
5509 loop_
5510 <a href="#_map.id" >_map.id</a>
5511 <a href="#_map.details" >_map.details</a>
5512
5513 rho_calc
5514 ;
5515 density calculated from F_calc derived from the ATOM_SITE list
5516 ;
5517 rho_obs
5518 ;
5519 density combining the observed structure factors with the
5520 calculated phases
5521 ;
5522
5523 loop_
5524 _map_segment.map_id
5525 _map_segment.id
5526 _map_segment.array_id
5527 _map_segment.binary_id
5528 _map_segment.mask_array_id
5529 _map_segment.mask_binary_id
5530 rho_calc rho_calc map_structure 1 mask_structure 1
5531 rho_obs rho_obs map_structure 2 mask_structure 1
5532 ;
5533
5534 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
5535 save_
5536
5537
5538 save_<a name="_map_segment.array_id" >_map_segment.array_id</a>
5539 _item_description.description
5540 ; The value of _map_segment.array_id identifies the array structure
5541 into which the map is organized.
5542
5543 This item is a pointer to <a href="#_array_structure.id" >_array_structure.id</a> in the
5544 <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a> category.
5545 ;
5546 _item.name '<a href="#_map_segement.array_id" >_map_segment.array_id</a>'
5547 _item.category_id map_segment
5548 _item.mandatory_code implicit
5549 _item_type.code code
5550 save_
5551
5552
5553 save_<a name="_map_segment.binary_id" >_map_segment.binary_id</a>
5554 _item_description.description
5555 ; The value of <a href="#_map_segment.binary_id">_map_segment.binary_id</a> distinguishes the particular
5556 set of data organized according to <a href="#_map_segment.mask_array_id">_map_segment.array_id</a> in
5557 which the data values of the map are stored.
5558
5559 This item is a pointer to <a href="#_array_data.binary_id" >_array_data.binary_id</a> in the
5560 <a href="#ARRAY_DATA">ARRAY_DATA</a> category.
5561 ;
5562 _item.name '<a href="#_map_segment.binary_id" >_map_segment.binary_id</a>'
5563 _item.category_id map_segment
5564 _item.mandatory_code implicit
5565 _item_type.code int
5566 save_
5567
5568 save_<a name="_map_segment.mask_array_id" >_map_segment.mask_array_id</a>
5569 _item_description.description
5570 ; The value of <a href="#_map_segment.mask_array_id">_map_segment.mask_array_id</a>, if given, the array
5571 structure into which the mask for the map is organized. If no
5572 value is given, then all elements of the map are valid. If a
5573 value is given, then only elements of the map for which the
5574 corresponding element of the mask is non-zero are valid. The
5575 value of <a href="#_map_segment.mask_array_id">_map_segment.mask_array_id</a> differs from the value of
5576 <a href="#_map_segment.array_id">_map_segment.array_id</a> in order to permit the mask to be given
5577 as, say, unsigned 8-bit integers, while the map is given as
5578 a data type with more range. However, the two array structures
5579 must be aligned, using the same axes in the same order with the
5580 same displacements and increments
5581
5582 This item is a pointer to <a href="#_array_structure.id" >_array_structure.id</a> in the
5583 <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a> category.
5584 ;
5585 _item.name '<a href="#_map_segment.mask_array_id" >_map_segment.mask_array_id</a>'
5586 _item.category_id map_segment
5587 _item.mandatory_code implicit
5588 _item_type.code code
5589 save_
5590
5591
5592 save_<a name="_map_segment.mask_binary_id" >_map_segment.mask_binary_id</a>
5593 _item_description.description
5594 ; The value of <a href="#_map_segment.mask_binary_id">_map_segment.mask_binary_id</a> identifies the
5595 particular set of data organized according to
5596 _map_segment.mask_array_id specifying the mask for the map.
5597
5598 This item is a pointer to <a href="#_array_data.mask_binary_id" >_array_data.mask_binary_id</a> in the
5599 <a href="#ARRAY_DATA">ARRAY_DATA</a> category.
5600 ;
5601 _item.name '<a href="#_map_segment.mask_binary_id" >_map_segment.mask_binary_id</a>'
5602 _item.category_id map_segment
5603 _item.mandatory_code implicit
5604 _item_type.code int
5605 save_
5606
5607
5608 save_<a name="_map_segment.id" >_map_segment.id</a>
5609 _item_description.description
5610 ; The value of <a href="#_map_segment.id" >_map_segment.id</a> must uniquely
5611 identify each segment of a map.
5612 ;
5613 loop_
5614 _item.name
5615 _item.category_id
5616 _item.mandatory_code
5617 '<a href="#_map_segment.id" >_map_segment.id</a>'
5618 map_segment
5619 yes
5620 _item_type.code code
5621 loop_
5622 _item_linked.child_name
5623 _item_linked.parent_name
5624 '<a href="#_map_data_frame.map_segment_id" >_map_data_frame.map_segment_id</a>'
5625 '<a href="#_map_segment.id" >_map_segment.id</a>'
5626
5627 save_
5628
5629
5630 save_<a name="_map_segment.map_id" >_map_segment.map_id</a>
5631 _item_description.description
5632 ; This item is a pointer to <a href="#_map.id" >_map.id</a>
5633 in the <a href="#MAP">MAP</a> category.
5634 ;
5635 _item.name '<a href="#_map_segment.map_id" >_map_segment.map_id</a>'
5636 _item.category_id map_segment
5637 _item.mandatory_code yes
5638 _item_type.code code
5639 save_
5640
5641 save_<a name="_map_segment.details" >_map_segment.details</a>
5642 _item_description.description
5643 ; The value of <a href="#_map_segment.details" >_map_segment.details</a> should give a
5644 description of special aspects of each segment of a map.
5645
5646 ;
5647 _item.name '<a name="_map_segment.details" >_map_segment.details</a>'
5648 _item.category_id map_segment
5649 _item.mandatory_code no
5650 _item_type.code text
5651 loop_
5652 _item_examples.case
5653 _item_examples.detail
5654 ; Example to be provided
5655 ;
5656 ;
5657
5658 ;
5659 save_
5660
5661
5662 ######################## DEPRECATED DATA ITEMS ########################
5663
5664 save_<a name="_diffrn_detector_axis.id">_diffrn_detector_axis.id</a>
5665 _item_description.description
5666 ; This data item is a pointer to <a href="#_diffrn_detector.id">_diffrn_detector.id</a> in
5667 the <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a> category.
5668
5669 DEPRECATED -- DO NOT USE
5670 ;
5671 _item.name '<a href="#_diffrn_detector_axis.id">_diffrn_detector_axis.id</a>'
5672 _item.category_id diffrn_detector_axis
5673 _item.mandatory_code yes
5674 _item_type.code code
5675 save_
5676
5677 save_<a name="_diffrn_detector_element.center[1]" >_diffrn_detector_element.center[1]</a>
5678 _item_description.description
5679 ; The value of <a href="#_diffrn_detector_element.center[1]" >_diffrn_detector_element.center[1]</a> is the <b>X</b>
5680 component of the distortion-corrected beam centre in
5681 millimetres from the (0, 0) (lower-left) corner of the
5682 detector element viewed from the sample side.
5683
5684 The <b>X</b> and <b>Y</b> axes are the laboratory coordinate system
5685 coordinates defined in the <a href="#AXIS">AXIS category</a> measured
5686 when all positioning axes for the detector are at their zero
5687 settings. If the resulting <b>X</b> or <b>Y</b> axis is then orthogonal to the
5688 detector, the <b>Z</b> axis is used instead of the orthogonal axis.
5689
5690 Because of ambiguity about the setting used to determine this center,
5691 use of this data item is deprecated. The data item
5692 <a href="#_diffrn_data_frame.center_fast">_diffrn_data_frame.center_fast</a>
5693 which is referenced to the detector coordinate system and not
5694 directly to the laboratory coordinate system should be used instead.
5695
5696 ;
5697 _item.name '<a href="#_diffrn_detector_element.center[1]" >_diffrn_detector_element.center[1]</a>'
5698 _item.category_id diffrn_detector_element
5699 _item.mandatory_code no
5700 _item_default.value 0.0
5701 _item_sub_category.id vector
5702 _item_type.code float
5703 _item_units.code millimetres
5704
5705 save_
5706
5707
5708 save_<a name="_diffrn_detector_element.center[2]" >_diffrn_detector_element.center[2]</a>
5709 _item_description.description
5710 ; The value of <a href="#_diffrn_detector_element.center[2]" >_diffrn_detector_element.center[2]</a> is the <b>Y</b>
5711 component of the distortion-corrected beam centre in
5712 millimetres from the (0, 0) (lower-left) corner of the
5713 detector element viewed from the sample side.
5714
5715 The <b>X</b> and <b>Y</b> axes are the laboratory coordinate system
5716 coordinates defined in the <a href="#AXIS">AXIS category</a> measured
5717 when all positioning axes for the detector are at their zero
5718 settings. If the resulting <b>X</b> or <b>Y</b> axis is then orthogonal to the
5719 detector, the <b>Z</b> axis is used instead of the orthogonal axis.
5720
5721 Because of ambiguity about the setting used to determine this center,
5722 use of this data item is deprecated. The data item
5723 <a href="#_diffrn_data_frame.center_slow">_diffrn_data_frame.center_slow</a>
5724 which is referenced to the detector coordinate system and not
5725 directly to the laboratory coordinate system should be used instead.
5726
5727
5728 ;
5729 _item.name '<a href="#_diffrn_detector_element.center[2]" >_diffrn_detector_element.center[2]</a>'
5730 _item.category_id diffrn_detector_element
5731 _item.mandatory_code no
5732 _item_default.value 0.0
5733 _item_sub_category.id vector
5734 _item_type.code float
5735 _item_units.code millimetres
5736
5737 save_
5738
5739
5740
5741 save_<a name="_diffrn_measurement_axis.id">_diffrn_measurement_axis.id</a>
5742 _item_description.description
5743 ; This data item is a pointer to <a href="#_diffrn_measurement.id">_diffrn_measurement.id</a> in
5744 the <a href="#DIFFRN_MEASUREMENT">DIFFRN_MEASUREMENT</a> category.
5745
5746 DEPRECATED -- DO NOT USE
5747 ;
5748 _item.name '<a href="#_diffrn_measurement_axis.id">_diffrn_measurement_axis.id</a>'
5749 _item.category_id diffrn_measurement_axis
5750 _item.mandatory_code yes
5751 _item_type.code code
5752 save_
5753
5754 ######################### DEPRECATED CATEGORY #########################
5755 #####################
5756 # <a name="DIFFRN_FRAME_DATA" >DIFFRN_FRAME_DATA</a> #
5757 #####################
5758
5759
5760 save_DIFFRN_FRAME_DATA
5761 _category.description
5762 ; Data items in the DIFFRN_FRAME_DATA category record
5763 the details about each frame of data.
5764
5765 The items in this category are now in the
5766 <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a> category.
5767
5768 The items in the DIFFRN_FRAME_DATA category
5769 are now deprecated. The items from this category
5770 are provided as aliases in the 1.0 dictionary
5771 or, in the case of _diffrn_frame_data.details,
5772 in the 1.4 dictionary. THESE ITEMS SHOULD NOT
5773 BE USED FOR NEW WORK.
5774
5775 The items from the old category are provided
5776 in this dictionary for completeness
5777 but should not be used or cited. To avoid
5778 confusion, the example has been removed
5779 and the redundant parent-child links to other
5780 categories have been removed.
5781 ;
5782 _category.id diffrn_frame_data
5783 _category.mandatory_code no
5784 loop_
5785 _category_key.name '<a href="#_diffrn_frame_data.id" >_diffrn_frame_data.id</a>'
5786 '<a href="#_diffrn_frame_data.detector_element_id" >_diffrn_frame_data.detector_element_id</a>'
5787 loop_
5788 _category_group.id 'inclusive_group'
5789 'array_data_group'
5790 loop_
5791 _category_examples.detail
5792 _category_examples.case
5793 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
5794 ;
5795 THE DIFFRN_FRAME_DATA category is deprecated and should not be used.
5796 ;
5797 ;
5798 # EXAMPLE REMOVED #
5799 ;
5800 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
5801 save_
5802
5803
5804 save_<a name="_diffrn_frame_data.array_id" >_diffrn_frame_data.array_id</a>
5805 _item_description.description
5806 ; This item is a pointer to <a href="#_array_structure.id" >_array_structure.id</a> in the
5807 ARRAY_STRUCTURE category.
5808
5809 DEPRECATED -- DO NOT USE
5810 ;
5811 _item.name '<a href="#_diffrn_frame_data.array_id" >_diffrn_frame_data.array_id</a>'
5812 _item.category_id diffrn_frame_data
5813 _item.mandatory_code implicit
5814 _item_type.code code
5815 save_
5816
5817
5818 save_<a name="_diffrn_frame_data.binary_id" >_diffrn_frame_data.binary_id</a>
5819 _item_description.description
5820 ; This item is a pointer to <a href="#_array_data.binary_id" >_array_data.binary_id</a> in the
5821 ARRAY_STRUCTURE category.
5822
5823 DEPRECATED -- DO NOT USE
5824 ;
5825 _item.name '<a href="#_diffrn_frame_data.binary_id" >_diffrn_frame_data.binary_id</a>'
5826 _item.category_id diffrn_frame_data
5827 _item.mandatory_code implicit
5828 _item_type.code int
5829 save_
5830
5831
5832 save_<a name="_diffrn_frame_data.detector_element_id" >_diffrn_frame_data.detector_element_id</a>
5833 _item_description.description
5834 ; This item is a pointer to <a href="#_diffrn_detector_element.id">_diffrn_detector_element.id</a>
5835 in the DIFFRN_DETECTOR_ELEMENT category.
5836
5837 DEPRECATED -- DO NOT USE
5838 ;
5839 _item.name '<a href="#_diffrn_frame_data.detector_element_id" >_diffrn_frame_data.detector_element_id</a>'
5840 _item.category_id diffrn_frame_data
5841 _item.mandatory_code yes
5842 _item_type.code code
5843 save_
5844
5845
5846 save_<a name="_diffrn_frame_data.id" >_diffrn_frame_data.id</a>
5847 _item_description.description
5848 ; The value of <a href="#_diffrn_frame_data.id" >_diffrn_frame_data.id</a> must uniquely identify
5849 each complete frame of data.
5850
5851 DEPRECATED -- DO NOT USE
5852 ;
5853 loop_
5854 _item.name
5855 _item.category_id
5856 _item.mandatory_code
5857 '<a href="#_diffrn_frame_data.id" >_diffrn_frame_data.id</a>' diffrn_frame_data yes
5858 _item_type.code code
5859 save_
5860
5861 save_<a name="_diffrn_frame_data.details" >_diffrn_frame_data.details</a>
5862 _item_description.description
5863 ; The value of <a href="#_diffrn_data_frame.details" >_diffrn_data_frame.details</a> should give a
5864 description of special aspects of each frame of data.
5865
5866 DEPRECATED -- DO NOT USE
5867 ;
5868 _item.name '<a name="_diffrn_frame_data.details" >_diffrn_frame_data.details</a>'
5869 _item.category_id diffrn_frame_data
5870 _item.mandatory_code no
5871 _item_type.code text
5872 save_
5873
5874 ################ END DEPRECATED SECTION ###########
5875
5876
5877 ####################
5878 ## <a name="ITEM_TYPE_LIST">ITEM_TYPE_LIST</a> ##
5879 ####################
5880 #
5881 #
5882 # The regular expressions defined here are not compliant
5883 # with the POSIX 1003.2 standard as they include the
5884 # '\n' and '\t' special characters. These regular expressions
5885 # have been tested using version 0.12 of Richard Stallman's
5886 # GNU regular expression library in POSIX mode.
5887 # In order to allow presentation of a regular expression
5888 # in a text field concatenate any line ending in a backslash
5889 # with the following line, after discarding the backslash.
5890 #
5891 # A formal definition of the '\n' and '\t' special characters
5892 # is most properly done in the DDL, but for completeness, please
5893 # note that '\n' is the line termination character ('newline')
5894 # and '\t' is the horizontal tab character. There is a formal
5895 # ambiguity in the use of '\n' for line termination, in that
5896 # the intention is that the equivalent machine/OS-dependent line
5897 # termination character sequence should be accepted as a match, e.g.
5898 #
5899 # '\r' (control-M) under MacOS
5900 # '\n' (control-J) under Unix
5901 # '\r\n' (control-M control-J) under DOS and MS Windows
5902 #
5903 loop_
5904 _item_type_list.code
5905 _item_type_list.primitive_code
5906 _item_type_list.construct
5907 _item_type_list.detail
5908 code char
5909 '[_,.;:&quot;&amp;&lt;&gt;()/\{}'`~!@#$%A-Za-z0-9*|+-]*'
5910 ; code item types/single words ...
5911 ;
5912 ucode uchar
5913 '[_,.;:&quot;&amp;&lt;&gt;()/\{}'`~!@#$%A-Za-z0-9*|+-]*'
5914 ; code item types/single words (case insensitive) ...
5915 ;
5916 line char
5917 '[][ \t_(),.;:&quot;&amp;&lt;&gt;/\{}'`~!@#$%?+=*A-Za-z0-9|^-]*'
5918 ; char item types / multi-word items ...
5919 ;
5920 uline uchar
5921 '[][ \t_(),.;:&quot;&amp;&lt;&gt;/\{}'`~!@#$%?+=*A-Za-z0-9|^-]*'
5922 ; char item types / multi-word items (case insensitive)...
5923 ;
5924 text char
5925 '[][ \n\t()_,.;:&quot;&amp;&lt;&gt;/\{}'`~!@#$%?+=*A-Za-z0-9|^-]*'
5926 ; text item types / multi-line text ...
5927 ;
5928 binary char
5929 ;\n--CIF-BINARY-FORMAT-SECTION--\n\
5930 [][ \n\t()_,.;:&quot;&amp;&lt;&gt;/\{}'`~!@#$%?+=*A-Za-z0-9|^-]*\
5931 \n--CIF-BINARY-FORMAT-SECTION----
5932 ;
5933 ; binary items are presented as MIME-like ascii-encoded
5934 sections in an imgCIF. In a CBF, raw octet streams
5935 are used to convey the same information.
5936 ;
5937 int numb
5938 '-?[0-9]+'
5939 ; int item types are the subset of numbers that are the negative
5940 or positive integers.
5941 ;
5942 float numb
5943 '-?(([0-9]+)[.]?|([0-9]*[.][0-9]+))([(][0-9]+[)])?([eE][+-]?[0-9]+)?'
5944 ; float item types are the subset of numbers that are the floating
5945 point numbers.
5946 ;
5947 any char
5948 '.*'
5949 ; A catch all for items that may take any form...
5950 ;
5951 yyyy-mm-dd char
5952 ;\
5953 [0-9]?[0-9]?[0-9][0-9]-[0-9]?[0-9]-[0-9]?[0-9]\
5954 ((T[0-2][0-9](:[0-5][0-9](:[0-5][0-9](.[0-9]+)?)?)?)?\
5955 ([+-][0-5][0-9]:[0-5][0-9]))?
5956 ;
5957 ;
5958 Standard format for CIF date and time strings (see
5959 http://www.iucr.org/iucr-top/cif/spec/datetime.html),
5960 consisting of a yyyy-mm-dd date optionally followed by
5961 the character 'T' followed by a 24-hour clock time,
5962 optionally followed by a signed time-zone offset.
5963
5964 The IUCr standard has been extended to allow for an optional
5965 decimal fraction on the seconds of time.
5966
5967 Time is local time if no time-zone offset is given.
5968
5969 Note that this type extends the mmCIF yyyy-mm-dd type
5970 but does not conform to the mmCIF yyyy-mm-dd:hh:mm
5971 type that uses a ':' in place if the 'T' specified
5972 by the IUCr standard. For reading, both forms should
5973 be accepted, but for writing, only the IUCr form should
5974 be used.
5975
5976 For maximal compatibility, the special time zone
5977 indicator 'Z' (for 'zulu') should be accepted on
5978 reading in place of '+00:00' for GMT.
5979 ;
5980
5981
5982 #####################
5983 ## <a name="ITEM_UNITS_LIST">ITEM_UNITS_LIST</a> ##
5984 #####################
5985
5986 loop_
5987 _item_units_list.code
5988 _item_units_list.detail
5989 #
5990 'metres' 'metres'
5991 'centimetres' 'centimetres (metres * 10^<sup>( -2)</sup>^)'
5992 'millimetres' 'millimetres (metres * 10^<sup>( -3)</sup>^)'
5993 'nanometres' 'nanometres (metres * 10^<sup>( -9)</sup>^)'
5994 'angstroms' '\%Angstroms (metres * 10^<sup>(-10)</sup>^)'
5995 'picometres' 'picometres (metres * 10^<sup>(-12)</sup>^)'
5996 'femtometres' 'femtometres (metres * 10^<sup>(-15)</sup>^)'
5997 #
5998 'reciprocal_metres' 'reciprocal metres (metres^<sup>(-1)</sup>^)'
5999 'reciprocal_centimetres'
6000 'reciprocal centimetres ((metres * 10^<sup>( -2)</sup>^)^<sup>(-1)</sup>^)'
6001 'reciprocal_millimetres'
6002 'reciprocal millimetres ((metres * 10^<sup>( -3)</sup>^)^<sup>(-1)</sup>^)'
6003 'reciprocal_nanometres'
6004 'reciprocal nanometres ((metres * 10^<sup>( -9)</sup>^)^<sup>(-1)</sup>^)'
6005 'reciprocal_angstroms'
6006 'reciprocal \%Angstroms ((metres * 10^<sup>(-10)</sup>^)^<sup>(-1)</sup>^)'
6007 'reciprocal_picometres'
6008 'reciprocal picometres ((metres * 10^<sup>(-12)</sup>^)^<sup>(-1)</sup>^)'
6009 #
6010 'nanometres_squared' 'nanometres squared (metres * 10^<sup>( -9)</sup>^)^<sup>2</sup>^'
6011 'angstroms_squared' '\%Angstroms squared (metres * 10^<sup>(-10)</sup>^)^<sup>2</sup>^'
6012 '8pi2_angstroms_squared'
6013 '8\p^<sup>2</sup>^ * \%Angstroms squared (metres * 10^<sup>(-10)</sup>^)^<sup>2</sup>^'
6014 'picometres_squared' 'picometres squared (metres * 10^<sup>(-12)</sup>^)^<sup>2</sup>^'
6015 #
6016 'nanometres_cubed' 'nanometres cubed (metres * 10^<sup>( -9)</sup>^)^<sup>3</sup>^'
6017 'angstroms_cubed' '\%Angstroms cubed (metres * 10^<sup>(-10)</sup>^)^<sup>3</sup>^'
6018 'picometres_cubed' 'picometres cubed (metres * 10^<sup>(-12)</sup>^)^<sup>3</sup>^'
6019 #
6020 'kilopascals' 'kilopascals'
6021 'gigapascals' 'gigapascals'
6022 #
6023 'hours' 'hours'
6024 'minutes' 'minutes'
6025 'seconds' 'seconds'
6026 'microseconds' 'microseconds'
6027 #
6028 'degrees' 'degrees (of arc)'
6029 'degrees_squared' 'degrees (of arc) squared'
6030 #
6031 'degrees_per_minute' 'degrees (of arc) per minute'
6032 #
6033 'celsius' 'degrees (of temperature) Celsius'
6034 'kelvins' 'degrees (of temperature) Kelvin'
6035 #
6036 'counts' 'counts'
6037 'counts_per_photon' 'counts per photon'
6038 #
6039 'electrons' 'electrons'
6040 #
6041 'electrons_squared' 'electrons squared'
6042 #
6043 'electrons_per_nanometres_cubed'
6044 ; electrons per nanometres cubed (electrons/(metres * 10^<sup>( -9)</sup>^)^<sup>(-3)</sup>^)
6045 ;
6046 'electrons_per_angstroms_cubed'
6047 ; electrons per \%Angstroms cubed (electrons/(metres * 10^<sup>(-10)</sup>^)^<sup>(-3)</sup>^)
6048 ;
6049 'electrons_per_picometres_cubed'
6050 ; electrons per picometres cubed (electrons/(metres * 10^<sup>(-12)</sup>^)^<sup>(-3)</sup>^)
6051 ;
6052 'kilowatts' 'kilowatts'
6053 'milliamperes' 'milliamperes'
6054 'kilovolts' 'kilovolts'
6055 #
6056 'pixels_per_element' '(image) pixels per (array) element'
6057 #
6058 'arbitrary'
6059 ; arbitrary system of units.
6060 ;
6061 #
6062
6063 loop_
6064 _item_units_conversion.from_code
6065 _item_units_conversion.to_code
6066 _item_units_conversion.operator
6067 _item_units_conversion.factor
6068 ###
6069 'metres' 'centimetres' '*' 1.0E+02
6070 'metres' 'millimetres' '*' 1.0E+03
6071 'metres' 'nanometres' '*' 1.0E+09
6072 'metres' 'angstroms' '*' 1.0E+10
6073 'metres' 'picometres' '*' 1.0E+12
6074 'metres' 'femtometres' '*' 1.0E+15
6075 #
6076 'centimetres' 'metres' '*' 1.0E-02
6077 'centimetres' 'millimetres' '*' 1.0E+01
6078 'centimetres' 'nanometres' '*' 1.0E+07
6079 'centimetres' 'angstroms' '*' 1.0E+08
6080 'centimetres' 'picometres' '*' 1.0E+10
6081 'centimetres' 'femtometres' '*' 1.0E+13
6082 #
6083 'millimetres' 'metres' '*' 1.0E-03
6084 'millimetres' 'centimetres' '*' 1.0E-01
6085 'millimetres' 'nanometres' '*' 1.0E+06
6086 'millimetres' 'angstroms' '*' 1.0E+07
6087 'millimetres' 'picometres' '*' 1.0E+09
6088 'millimetres' 'femtometres' '*' 1.0E+12
6089 #
6090 'nanometres' 'metres' '*' 1.0E-09
6091 'nanometres' 'centimetres' '*' 1.0E-07
6092 'nanometres' 'millimetres' '*' 1.0E-06
6093 'nanometres' 'angstroms' '*' 1.0E+01
6094 'nanometres' 'picometres' '*' 1.0E+03
6095 'nanometres' 'femtometres' '*' 1.0E+06
6096 #
6097 'angstroms' 'metres' '*' 1.0E-10
6098 'angstroms' 'centimetres' '*' 1.0E-08
6099 'angstroms' 'millimetres' '*' 1.0E-07
6100 'angstroms' 'nanometres' '*' 1.0E-01
6101 'angstroms' 'picometres' '*' 1.0E+02
6102 'angstroms' 'femtometres' '*' 1.0E+05
6103 #
6104 'picometres' 'metres' '*' 1.0E-12
6105 'picometres' 'centimetres' '*' 1.0E-10
6106 'picometres' 'millimetres' '*' 1.0E-09
6107 'picometres' 'nanometres' '*' 1.0E-03
6108 'picometres' 'angstroms' '*' 1.0E-02
6109 'picometres' 'femtometres' '*' 1.0E+03
6110 #
6111 'femtometres' 'metres' '*' 1.0E-15
6112 'femtometres' 'centimetres' '*' 1.0E-13
6113 'femtometres' 'millimetres' '*' 1.0E-12
6114 'femtometres' 'nanometres' '*' 1.0E-06
6115 'femtometres' 'angstroms' '*' 1.0E-05
6116 'femtometres' 'picometres' '*' 1.0E-03
6117 ###
6118 'reciprocal_centimetres' 'reciprocal_metres' '*' 1.0E+02
6119 'reciprocal_centimetres' 'reciprocal_millimetres' '*' 1.0E-01
6120 'reciprocal_centimetres' 'reciprocal_nanometres' '*' 1.0E-07
6121 'reciprocal_centimetres' 'reciprocal_angstroms' '*' 1.0E-08
6122 'reciprocal_centimetres' 'reciprocal_picometres' '*' 1.0E-10
6123 #
6124 'reciprocal_millimetres' 'reciprocal_metres' '*' 1.0E+03
6125 'reciprocal_millimetres' 'reciprocal_centimetres' '*' 1.0E+01
6126 'reciprocal_millimetres' 'reciprocal_nanometres' '*' 1.0E-06
6127 'reciprocal_millimetres' 'reciprocal_angstroms' '*' 1.0E-07
6128 'reciprocal_millimetres' 'reciprocal_picometres' '*' 1.0E-09
6129 #
6130 'reciprocal_nanometres' 'reciprocal_metres' '*' 1.0E+09
6131 'reciprocal_nanometres' 'reciprocal_centimetres' '*' 1.0E+07
6132 'reciprocal_nanometres' 'reciprocal_millimetres' '*' 1.0E+06
6133 'reciprocal_nanometres' 'reciprocal_angstroms' '*' 1.0E-01
6134 'reciprocal_nanometres' 'reciprocal_picometres' '*' 1.0E-03
6135 #
6136 'reciprocal_angstroms' 'reciprocal_metres' '*' 1.0E+10
6137 'reciprocal_angstroms' 'reciprocal_centimetres' '*' 1.0E+08
6138 'reciprocal_angstroms' 'reciprocal_millimetres' '*' 1.0E+07
6139 'reciprocal_angstroms' 'reciprocal_nanometres' '*' 1.0E+01
6140 'reciprocal_angstroms' 'reciprocal_picometres' '*' 1.0E-02
6141 #
6142 'reciprocal_picometres' 'reciprocal_metres' '*' 1.0E+12
6143 'reciprocal_picometres' 'reciprocal_centimetres' '*' 1.0E+10
6144 'reciprocal_picometres' 'reciprocal_millimetres' '*' 1.0E+09
6145 'reciprocal_picometres' 'reciprocal_nanometres' '*' 1.0E+03
6146 'reciprocal_picometres' 'reciprocal_angstroms' '*' 1.0E+01
6147 ###
6148 'nanometres_squared' 'angstroms_squared' '*' 1.0E+02
6149 'nanometres_squared' 'picometres_squared' '*' 1.0E+06
6150 #
6151 'angstroms_squared' 'nanometres_squared' '*' 1.0E-02
6152 'angstroms_squared' 'picometres_squared' '*' 1.0E+04
6153 'angstroms_squared' '8pi2_angstroms_squared' '*' 78.9568
6154
6155 #
6156 'picometres_squared' 'nanometres_squared' '*' 1.0E-06
6157 'picometres_squared' 'angstroms_squared' '*' 1.0E-04
6158 ###
6159 'nanometres_cubed' 'angstroms_cubed' '*' 1.0E+03
6160 'nanometres_cubed' 'picometres_cubed' '*' 1.0E+09
6161 #
6162 'angstroms_cubed' 'nanometres_cubed' '*' 1.0E-03
6163 'angstroms_cubed' 'picometres_cubed' '*' 1.0E+06
6164 #
6165 'picometres_cubed' 'nanometres_cubed' '*' 1.0E-09
6166 'picometres_cubed' 'angstroms_cubed' '*' 1.0E-06
6167 ###
6168 'kilopascals' 'gigapascals' '*' 1.0E-06
6169 'gigapascals' 'kilopascals' '*' 1.0E+06
6170 ###
6171 'hours' 'minutes' '*' 6.0E+01
6172 'hours' 'seconds' '*' 3.6E+03
6173 'hours' 'microseconds' '*' 3.6E+09
6174 #
6175 'minutes' 'hours' '/' 6.0E+01
6176 'minutes' 'seconds' '*' 6.0E+01
6177 'minutes' 'microseconds' '*' 6.0E+07
6178 #
6179 'seconds' 'hours' '/' 3.6E+03
6180 'seconds' 'minutes' '/' 6.0E+01
6181 'seconds' 'microseconds' '*' 1.0E+06
6182 #
6183 'microseconds' 'hours' '/' 3.6E+09
6184 'microseconds' 'minutes' '/' 6.0E+07
6185 'microseconds' 'seconds' '/' 1.0E+06
6186 ###
6187 'celsius' 'kelvins' '-' 273.0
6188 'kelvins' 'celsius' '+' 273.0
6189 ###
6190 'electrons_per_nanometres_cubed'
6191 'electrons_per_angstroms_cubed' '*' 1.0E+03
6192 'electrons_per_nanometres_cubed'
6193 'electrons_per_picometres_cubed' '*' 1.0E+09
6194 #
6195 'electrons_per_angstroms_cubed'
6196 'electrons_per_nanometres_cubed' '*' 1.0E-03
6197 'electrons_per_angstroms_cubed'
6198 'electrons_per_picometres_cubed' '*' 1.0E+06
6199 #
6200 'electrons_per_picometres_cubed'
6201 'electrons_per_nanometres_cubed' '*' 1.0E-09
6202 'electrons_per_picometres_cubed'
6203 'electrons_per_angstroms_cubed' '*' 1.0E-06
6204 ###
6205
6206 ########################
6207 ## <a name="DICTIONARY_HISTORY">DICTIONARY_HISTORY</a> ##
6208 ########################
6209
6210 loop_
6211 _dictionary_history.version
6212 _dictionary_history.update
6213 _dictionary_history.revision
6214
6215 1.5.3 2007-07-08
6216
6217 ; Changes to support SLS miniCBF and suggestions
6218 from the 24 May 07 BNL imgCIF workshop (HJB)
6219
6220 + Added new data items
6221 '<a href="#_array_data.header_contents" >_array_data.header_contents</a>',
6222 '<a href="#_array_data.header_convention" >_array_data.header_convention</a>',
6223 '<a href="#_diffrn_data_frame.center_fast" >_diffrn_data_frame.center_fast</a>',
6224 '<a href="#_diffrn_data_frame.center_slow" >_diffrn_data_frame.center_slow</a>',
6225 '<a href="#_diffrn_data_frame.center_units" >_diffrn_data_frame.center_units</a>',
6226 '<a href="#_diffrn_measurement.sample_detector_distance" >_diffrn_measurement.sample_detector_distance</a>',
6227 '<a href="#_diffrn_measurement.sample_detector_voffset" >_diffrn_measurement.sample_detector_voffset</a>
6228 + Deprecated data items
6229 '<a href="#_diffrn_detector_element.center[1]" >_diffrn_detector_element.center[1]</a>',
6230 '<a href="#_diffrn_detector_element.center[2]" >_diffrn_detector_element.center[2]</a>'
6231 + Added comments and example on miniCBF
6232 + Changed all array_id data items to implicit
6233 ;
6234
6235 1.5.2 2007-05-06
6236
6237 ; Further clarifications of the coordinate system. (HJB)
6238 ;
6239
6240 1.5.1 2007-04-26
6241
6242 ; Improve defintion of X-axis to cover the case of no goniometer
6243 and clean up more line folds (HJB)
6244 ;
6245
6246 1.5 2007-07-25
6247
6248 ; This is a cummulative list of the changes proposed since the
6249 imgCIF workshop in Hawaii in July 2006. It is the result
6250 of contributions by H. J. Bernstein, A. Hammersley,
6251 J. Wright and W. Kabsch.
6252
6253 2007-02-19 Consolidated changes (edited by HJB)
6254 + Added new data items
6255 '<a href="#_array_structure.compression_type_flag" >_array_structure.compression_type_flag</a>',
6256 '<a href="#_array_structure_list_axis.fract_displacement">_array_structure_list_axis.fract_displacement</a>',
6257 '<a href="#_array_structure_list_axis.fract_displacement_increment" >_array_structure_list_axis.displacement_increment</a>',
6258 '<a href="#_array_structure_list_axis.reference_angle" >_array_structure_list_axis.reference_angle</a>',
6259 '<a href="#_array_structure_list_axis.reference_displacement" >_array_structure_list_axis.reference_displacement</a>',
6260 '<a href="#_axis.sdystem" >_axis.system</a>',
6261 '<a href="#_diffrn_detector_element.reference_center_fast" >_diffrn_detector_element.reference_center_fast</a>',
6262 '<a href="#_diffrn_detector_element.reference_center_slow" >_diffrn_detector_element.reference_center_slow</a>',
6263 '<a href="#_diffrn_scan_axis.reference_angle" >_diffrn_scan_axis.reference_angle</a>',
6264 '<a href="#_diffrn_scan_axis.reference_displacement" >_diffrn_scan_axis.reference_displacement</a>',
6265 '<a href="#_map.details" >_map.details</a>', '<a href="#_map.diffrn_id" >_map.diffrn_id</a>',
6266 '<a href="#_map.entry_id" >_map.entry_id</a>', '<a name="#_map.id" >_map.id</a>',
6267 '<a href="#_map_segment.array_id" >_map_segment.array_id</a>', '<a href="#_map_segment.binary_id" >_map_segment.binary_id</a>',
6268 '<a href="#_map_segment.mask_array_id" >_map_segment.mask_array_id</a>', '<a href="#_map_segment.mask_binary_id" >_map_segment.mask_binary_id</a>',
6269 '<a href="#_map_segment.id" >_map_segment.id</a>', '<a href="#_map_segment.map_id" >_map_segment.map_id</a>',
6270 '<a href="#_map_segment.details" >_map_segment.details</a>.
6271 + Change type of
6272 '<a href="#_array_structure.byte_order" >_array_structure.byte_order</a>' and
6273 '<a href="#_array_structure.compression_type" >_array_structure.compression_type</a>'
6274 to ucode to make these values case-insensitive
6275 + Add values 'packed_v2' and 'byte_offset' to enumeration of values for
6276 '<a href="#_array_structure.compression_type" >_array_structure.compression_type</a>'
6277 + Add to defintions for the binary data type to handle new compression types, maps,
6278 and a variety of new axis types.
6279 2007-07-25 Cleanup of typos for formal release (HJB)
6280 + Corrected text fields for reference_ tag descriptions that
6281 were off by one column
6282 + Fix typos in comments listing fract_ tags
6283 + Changed name of release from 1.5_DRAFT to 1.5
6284 + Fix unclosed text fields in various map definitions
6285
6286 ;
6287
6288 1.4 2006-07-04
6289
6290 ; This is a change to reintegrate all changes made in the course of
6291 publication of ITVG, by the RCSB from April 2005 through
6292 August 2008 and changes for the 2006 imgCIF workshop in
6293 Hawaii.
6294
6295 2006-07-04 Consolidated changes for the 2006 imgCIF workshop (edited by HJB)
6296 + Correct type of '<a href="#_array_structure_list.direction">_array_structure_list.direction</a>' from 'int' to 'code'.
6297 + Added new data items suggested by CN
6298 '<a href="#_diffrn_data_frame.details">_diffrn_data_frame.details</a>'
6299 '<a href="#_array_intensities.pixel_fast_bin_size" >_array_intensities.pixel_fast_bin_size</a>',
6300 '<a href="#_array_intensities.pixel_slow_bin_size" >_array_intensities.pixel_slow_bin_size</a> and
6301 '<a href="#_array_intensities.pixel_binning_method" >_array_intensities.pixel_binning_method</a>
6302 + Added deprecated item for completeness
6303 '<a href="#_diffrn_frame_data.details">_diffrn_frame_data.details</a>'
6304 + Added entry for missing item in contents list
6305 '<a href="#_array_structure_list_axis.displacement" >_array_structure_list_axis.displacement</a>'
6306 + Added new MIME type <b>X</b>-BASE32K based on work by VL, KM, GD, HJB
6307 + Correct description of MIME boundary delimiter to start in
6308 column 1.
6309 + General cleanup of text fields to conform to changes for ITVG
6310 by removing empty lines at start and finish of text field.
6311 + Amend example for ARRAY_INTENSITIES to include binning.
6312 + Add local copy of type specification (as 'code') for all children
6313 of '<a href="#_diffrn.id">_diffrn.id</a>'.
6314 + For consistency, change all references to 'pi' to '\p' and all
6315 references to 'Angstroms' to '\%Angstroms'.
6316 + Clean up all powers to use IUCr convention of '^power^', as in
6317 '10^3^' for '10**3'.
6318 + Update 'yyyy-mm-dd' type regex to allow truncation from the right
6319 and improve comments to explain handling of related mmCIF
6320 'yyyy-mm-dd:hh:mm' type, and use of 'Z' for GMT time zone.
6321
6322 2005-03-08 and
6323 2004-08-08 fixed cases where _item_units.code used
6324 instead of _item_type.code (JDW)
6325 2004-04-15 fixed item ordering in
6326 _diffrn_measurement_axis.measurement_id
6327 added sub_category 'vector' (JDW)
6328 ;
6329
6330 1.3.2 2005-06-25
6331
6332 ; 2005-06-25 ITEM_TYPE_LIST: code, ucode, line, uline regexps updated
6333 to those of current mmCIF; float modified by allowing integers
6334 terminated by a point as valid. The 'time' part of
6335 yyyy-mm-dd types made optional in the regexp. (BM)
6336
6337 2005-06-17 Minor corrections as for proofs for IT G Chapter 4.6
6338 (NJA)
6339
6340 2005-02-21 Minor corrections to spelling and punctuation
6341 (NJA)
6342
6343 2005-01-08 Changes as per Nicola Ashcroft.
6344 + Updated example 1 for DIFFRN_MEASUREMENT to agree with mmCIF.
6345 + Spelled out "micrometres" for "um" and "millimetres" for "mm".
6346 + Removed phrase "which may be stored" from ARRAY_STRUCTURE
6347 description.
6348 + Removed unused 'byte-offsets' compressions and updated
6349 cites to ITVG for '_array_structure.compression_type'.
6350 (HJB)
6351 ;
6352
6353 1.3.1 2003-08-13
6354 ;
6355 Changes as per Frances C. Bernstein.
6356 + Identify initials.
6357 + Adopt British spelling for centre in text.
6358 + Set \p and \%Angstrom and powers.
6359 + Clean up commas and unclear wordings.
6360 + Clean up tenses in history.
6361 Changes as per Gotzon Madariaga.
6362 + Fix the ARRAY_DATA example to align '_array_data.binary_id'
6363 and <b>X</b>-Binary-ID.
6364 + Add a range to '<a href="#_array_intensities.gain_esd">_array_intensities.gain_esd</a>'.
6365 + In the example of DIFFRN_DETECTOR_ELEMENT,
6366 '<a href="#_diffrn_detector_element.id">_diffrn_detector_element.id</a>' and
6367 '<a href="#_diffrn_detector_element.detector_id">_diffrn_detector_element.detector_id</a>' interchanged.
6368 + Fix typos for direction, detector and axes.
6369 + Clarify description of polarisation.
6370 + Clarify axes in '<a href="#_diffrn_detector_element.center[1]">_diffrn_detector_element.center[1]</a>'
6371 '<a href="#_diffrn_detector_element.center[2]">_diffrn_detector_element.center[2]</a>'.
6372 + Add local item types for items that are pointers.
6373 (HJB)
6374 ;
6375
6376
6377 1.3.0 2003-07-24
6378 ;
6379 Changes as per Brian McMahon.
6380 + Consistently quote tags embedded in text.
6381 + Clean up introductory comments.
6382 + Adjust line lengths to fit in 80 character window.
6383 + Fix several descriptions in AXIS category which
6384 referred to '_axis.type' instead of the current item.
6385 + Fix erroneous use of deprecated item
6386 '_diffrn_detector_axis.id' in examples for
6387 DIFFRN_SCAN_AXIS.
6388 + Add deprecated items '_diffrn_detector_axis.id'
6389 and '_diffrn_measurement_axis.id'.
6390 (HJB)
6391 ;
6392
6393
6394 1.2.4 2003-07-14
6395 ;
6396 Changes as per I. David Brown.
6397 + Enhance descriptions in DIFFRN_SCAN_AXIS to make them less
6398 dependent on the descriptions in DIFFRN_SCAN_FRAME_AXIS.
6399 + Provide a copy of the deprecated DIFFRN_FRAME_DATA
6400 category for completeness.
6401 (HJB)
6402 ;
6403
6404
6405 1.2.3 2003-07-03
6406 ;
6407 Cleanup to conform to ITVG.
6408 + Correct sign error in ..._cubed units.
6409 + Correct '_diffrn_radiation.polarisn_norm' range.
6410 (HJB)
6411 ;
6412
6413
6414 1.2.2 2003-03-10
6415 ;
6416 Correction of typos in various DIFFRN_SCAN_AXIS descriptions.
6417 (HJB)
6418 ;
6419
6420
6421 1.2.1 2003-02-22
6422 ;
6423 Correction of ATOM_ for ARRAY_ typos in various descriptions.
6424 (HJB)
6425 ;
6426
6427
6428 1.2 2003-02-07
6429 ;
6430 Corrections to encodings (remove extraneous hyphens) remove
6431 extraneous underscore in '<a href="#_array_structure.encoding_type">_array_structure.encoding_type</a>'
6432 enumeration. Correct typos in items units list. (HJB)
6433 ;
6434
6435
6436 1.1.3 2001-04-19
6437 ;
6438 Another typo corrections by Wilfred Li, and cleanup by HJB.
6439 ;
6440
6441
6442 1.1.2 2001-03-06
6443 ;
6444 Several typo corrections by Wilfred Li.
6445 ;
6446
6447
6448 1.1.1 2001-02-16
6449 ;
6450 Several typo corrections by JW.
6451 ;
6452
6453
6454 1.1 2001-02-06
6455 ;
6456 Draft resulting from discussions on header for use at NSLS. (HJB)
6457
6458 + Change DIFFRN_FRAME_DATA to <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a>.
6459
6460 + Change '_diffrn_detector_axis.id' to '<a href="#_diffrn_detector_axis.detector_id">_diffrn_detector_axis.detector_id</a>'.
6461
6462 + Add '<a href="#_diffrn_measurement_axis.measurement_device">_diffrn_measurement_axis.measurement_device</a>' and change
6463 '_diffrn_measurement_axis.id' to
6464 '<a href="#_diffrn_measurement_axis.measurement_id">_diffrn_measurement_axis.measurement_id</a>'.
6465
6466 + Add '<a href="#_diffrn_radiation.div_x_source">_diffrn_radiation.div_x_source</a>', '<a href="#_diffrn_radiation.div_y_source">_diffrn_radiation.div_y_source</a>',
6467 '<a href="#_diffrn_radiation.div_x_y_source">_diffrn_radiation.div_x_y_source</a>',
6468 '<a href="#_diffrn_radiation.polarizn_source_norm">_diffrn_radiation.polarizn_source_norm</a>',
6469 '<a href="#_diffrn_radiation.polarizn_source_ratio">_diffrn_radiation.polarizn_source_ratio</a>', '<a href="#_diffrn_scan.date_end">_diffrn_scan.date_end</a>',
6470 '<a href="#_diffrn_scan.date_start">_diffrn_scan.date_start</a>', '<a href="#_diffrn_scan_axis.angle_rstrt_incr">_diffrn_scan_axis.angle_rstrt_incr</a>',
6471 '<a href="#_diffrn_scan_axis.displacement_rstrt_incr">_diffrn_scan_axis.displacement_rstrt_incr</a>',
6472 '<a href="#_diffrn_scan_frame_axis.angle_increment">_diffrn_scan_frame_axis.angle_increment</a>',
6473 '<a href="#_diffrn_scan_frame_axis.angle_rstrt_incr">_diffrn_scan_frame_axis.angle_rstrt_incr</a>',
6474 '<a href="#_diffrn_scan_frame_axis.displacement">_diffrn_scan_frame_axis.displacement</a>',
6475 '<a href="#_diffrn_scan_frame_axis.displacement_increment">_diffrn_scan_frame_axis.displacement_increment</a>',and
6476 '<a href="#_diffrn_scan_frame_axis.displacement_rstrt_incr">_diffrn_scan_frame_axis.displacement_rstrt_incr</a>'.
6477
6478 + Add '<a href="#_diffrn_measurement.device">_diffrn_measurement.device</a>' to category key.
6479
6480 + Update yyyy-mm-dd to allow optional time with fractional seconds
6481 for time stamps.
6482
6483 + Fix typos caught by RS.
6484
6485 + Add <a href="#ARRAY_STRUCTURE_LIST_AXIS">ARRAY_STRUCTURE_LIST_AXIS</a> category, and use concept of axis sets to
6486 allow for coupled axes, as in spiral scans.
6487
6488 + Add examples for fairly complete headers thanks to R. Sweet and P.
6489 Ellis.
6490 ;
6491
6492
6493 1.0 2000-12-21
6494 ;
6495 Release version - few typos and tidying up. (BM &amp; HJB)
6496
6497 + Move ITEM_TYPE_LIST, ITEM_UNITS_LIST and DICTIONARY_HISTORY to end
6498 of dictionary.
6499
6500 + Alphabetize dictionary.
6501 ;
6502
6503
6504 0.7.1 2000-09-29
6505 ;
6506 Cleanup fixes. (JW)
6507
6508 + Correct spelling of diffrn_measurement_axis in '<a href="#_axis.id">_axis.id</a>'
6509
6510 + Correct ordering of uses of '_item.mandatory_code' and
6511 '_item_default.value'.
6512 ;
6513
6514
6515 0.7.0 2000-09-09
6516 ;
6517 Respond to comments by I. David Brown. (HJB)
6518
6519 + Add further comments on '\n' and '\t'.
6520
6521 + Update ITEM_UNITS_LIST by taking section from mmCIF dictionary
6522 and adding metres. Change 'meter' to 'metre' throughout.
6523
6524 + Add missing enumerations to '<a href="#_array_structure.compression_type">_array_structure.compression_type</a>'
6525 and make 'none' the default.
6526
6527 + Remove parent-child relationship between
6528 '<a href="#_array_structure_list.index">_array_structure_list.index</a>' and '<a href="#_array_structure_list.precedence">_array_structure_list.precedence</a>'.
6529
6530 + Improve alphabetization.
6531
6532 + Fix '<a href="#_array_intensities.gain_esd">_array_intensities_gain.esd</a>' related function.
6533
6534 + Improve comments in <a href="#AXIS">AXIS</a>.
6535
6536 + Fix DIFFRN_FRAME_DATA example.
6537
6538 + Remove erroneous <a href="#DIFFRN_MEASUREMENT">DIFFRN_MEASUREMENT</a> example.
6539
6540 + Add '<a href="#_diffrn_measurement_axis.id">_diffrn_measurement_axis.id</a>' to the category key.
6541 ;
6542
6543
6544 0.6.0 1999-01-14
6545 ;
6546 Remove redundant information for ENC_NONE data. (HJB)
6547
6548 + After the D5 remove binary section identifier, size and
6549 compression type.
6550
6551 + Add Control-L to header.
6552 ;
6553
6554
6555 0.5.1 1999-01-03
6556 ;
6557 Cleanup of typos and syntax errors. (HJB)
6558
6559 + Cleanup example details for <a href="#DIFFRN_SCAN">DIFFRN_SCAN</a> category.
6560
6561 + Add missing quote marks for '<a href="#_diffrn_scan.id" >_diffrn_scan.id</a>' definition.
6562 ;
6563
6564
6565 0.5 1999-01-01
6566 ;
6567 Modifications for axis definitions and reduction of binary header. (HJB)
6568
6569 + Restore '<a href="#_diffrn_detector.diffrn_id" >_diffrn_detector.diffrn_id</a>' to <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a> KEY.
6570
6571 + Add <a href="#AXIS">AXIS</a> category.
6572
6573 + Bring in complete <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a> and <a href="#DIFFRN_MEASUREMENT">DIFFRN_MEASUREMENT</a> categories
6574 from cif_mm.dic for clarity.
6575
6576 + Change '<a href="#_array_structure.encoding_type">_array_structure.encoding_type</a>' from type code to uline and
6577 added X-Binary-Element-Type to MIME header.
6578
6579 + Add detector beam centre '<a href="#_diffrn_detector_element.center[1]">_diffrn_detector_element.center[1]</a>' and
6580 '<a href="#_diffrn_detector_element.center[2]">_diffrn_detector_element.center[2]</a>'.
6581
6582 + Correct item name of '<a href="#_diffrn_refln.frame_id">_diffrn_refln.frame_id</a>'.
6583
6584 + Replace reference to '_array_intensities.undefined' by
6585 '_array_intensities.undefined_value'.
6586
6587 + Replace references to '_array_intensity.scaling' with
6588 '_array_intensities.scaling'.
6589
6590 + Add <a href="#DIFFRN_SCAN">DIFFRN_SCAN</a>... categories.
6591 ;
6592
6593
6594 0.4 1998-08-11
6595 ;
6596 Modifications to the 0.3 imgCIF draft. (HJB)
6597
6598 + Reflow comment lines over 80 characters and corrected typos.
6599
6600 + Update examples and descriptions of MIME encoded data.
6601
6602 + Change name to cbfext98.dic.
6603 ;
6604
6605
6606 0.3 1998-07-04
6607 ;
6608 Modifications for imgCIF. (HJB)
6609
6610 + Add binary type, which is a text field containing a variant on
6611 MIME encoded data.
6612
6613 + Change type of '<a href="#_array_data.data" >_array_data.data</a>' to binary and specify internal
6614 structure of raw binary data.
6615
6616 + Add '<a href="#_array_data.binary_id" >_array_data.binary_id</a>', and make
6617 '<a href="#_diffrn_frame_data.binary_id" >_diffrn_frame_data.binary_id</a>' and '<a href="#_array_intensities.binary_id" >_array_intensities.binary_id</a>'
6618 into pointers to this item.
6619 ;
6620
6621
6622 0.2 1997-12-02
6623 ;
6624 Modifications to the CBF draft. (JW)
6625
6626 + Add category hierarchy for describing frame data developed from
6627 discussions at the BNL imgCIF Workshop Oct 1997. The following
6628 changes are made in implementing the workshop draft. Category
6629 DIFFRN_ARRAY_DATA is renamed to DIFFRN_FRAME_DATA. Category
6630 DIFFRN_FRAME_TYPE is renamed to <a href="#DIFFRN_DETECTOR_ELEMENT">DIFFRN_DETECTOR_ELEMENT</a>. The
6631 parent item for '<a href="#_diffrn_frame_data.array_id" >_diffrn_frame_data.array_id</a>' is changed from
6632 '_array_structure_list.array_id' to '_array_structure.id'. Item
6633 '_diffrn_detector.array_id' is deleted.
6634 + Add data item '<a href="#_diffrn_frame_data.binary_id" >_diffrn_frame_data.binary_id</a>' to identify data
6635 groups within a binary section. The formal identification of the
6636 binary section is still fuzzy.
6637 ;
6638
6639
6640 0.1 1997-01-24
6641 ;
6642 First draft of this dictionary in DDL 2.1 compliant format by John
6643 Westbrook (JW). This version is adapted from the Crystallographic
6644 Binary File (CBF) Format Draft Proposal provided by Andy Hammersley
6645 (AH).
6646
6647 Modifications to the CBF draft. (JW)
6648
6649 + In this version the array description has been cast in the categories
6650 <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a> and <a href="#ARRAY_STRUCTURE_LIST">ARRAY_STRUCTURE_LIST</a>. These categories
6651 have been generalized to describe array data of arbitrary dimension.
6652
6653 + Array data in this description are contained in the category
6654 <a href="#ARRAY_DATA">ARRAY_DATA</a>. This departs from the CBF notion of data existing
6655 in some special comment. In this description, data are handled as an
6656 ordinary data item encapsulated in a character data type. Although
6657 data this manner deviates from CIF conventions, it does not violate
6658 any DDL 2.1 rules. DDL 2.1 regular expressions can be used to define
6659 the binary representation which will permit some level of data
6660 validation. In this version, the placeholder type code "any" has
6661 been used. This translates to a regular expression which will match
6662 any pattern.
6663
6664 It should be noted that DDL 2.1 already supports array data objects
6665 although these have not been used in the current mmCIF dictionary.
6666 It may be possible to use the DDL 2.1 ITEM_STRUCTURE and
6667 ITEM_STRUCTURE_LIST categories to provide the information that is
6668 carried in by the <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a> and <a href="#ARRAY_STRUCTURE_LIST">ARRAY_STRUCTURE_LIST</a>. By
6669 moving the array structure to the DDL level it would be possible to
6670 define an array type as well as a regular expression defining the
6671 data format.
6672
6673 + Multiple array sections can be properly handled within a single
6674 datablock.
6675 ;
6676
6677
6678 #-eof-eof-eof-eof-eof-eof-eof-eof-eof-eof-eof-eof-eof-eof-eof-eof-eof-eof-eof
6679 </PRE>
6680 </BODY>
6681 </HTML>