Debian Codegraph @

doc/cif_img_1.5.4_28Jul07.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.4 #
32 # of 2007-07-28 #
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.4
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
775 number of sections for the third-fastest changing dimension of
776 the 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
1555 this 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
1653 set.
1654 ;
1655 _category.id array_structure_list_axis
1656 _category.mandatory_code no
1657 loop_
1658 _category_key.name
1659 '<a href="#_array_structure_list_axis.axis_set_id" >_array_structure_list_axis.axis_set_id</a>'
1660 '<a href="#_array_structure_list_axis.axis_id" >_array_structure_list_axis.axis_id</a>'
1661 loop_
1662 _category_group.id 'inclusive_group'
1663 'array_data_group'
1664 save_
1665
1666
1667 save_<a name="_array_structure_list_axis.axis_id" >_array_structure_list_axis.axis_id</a>
1668 _item_description.description
1669 ; The value of this data item is the identifier of one of
1670 the axes in the set of axes for which settings are being
1671 specified.
1672
1673 Multiple axes may be specified for the same value of
1674 <a href="#_array_structure_list_axis.axis_set_id" >_array_structure_list_axis.axis_set_id</a>.
1675
1676 This item is a pointer to <a href="#_axis.id" >_axis.id</a> in the
1677 <a href="#AXIS">AXIS</a> category.
1678 ;
1679 _item.name '<a href="#_array_structure_list_axis.axis_id" >_array_structure_list_axis.axis_id</a>'
1680 _item.category_id array_structure_list_axis
1681 _item.mandatory_code yes
1682 _item_type.code code
1683 save_
1684
1685
1686 save_<a name="_array_structure_list_axis.axis_set_id" >_array_structure_list_axis.axis_set_id</a>
1687 _item_description.description
1688 ; The value of this data item is the identifier of the
1689 set of axes for which axis settings are being specified.
1690
1691 Multiple axes may be specified for the same value of
1692 <a href="#_array_structure_list_axis.axis_set_id" >_array_structure_list_axis.axis_set_id</a>.
1693
1694 This item is a pointer to
1695 <a href="#_array_structure_list.axis_set_id" >_array_structure_list.axis_set_id</a>
1696 in the <a href="#ARRAY_STRUCTURE_LIST">ARRAY_STRUCTURE_LIST</a> category.
1697
1698 If this item is not specified, it defaults to the corresponding
1699 axis identifier.
1700 ;
1701 _item.name '<a href="#_array_structure_list_axis.axis_set_id" >_array_structure_list_axis.axis_set_id</a>'
1702 _item.category_id array_structure_list_axis
1703 _item.mandatory_code implicit
1704 _item_type.code code
1705 save_
1706
1707
1708 save_<a name="_array_structure_list_axis.angle" >_array_structure_list_axis.angle</a>
1709 _item_description.description
1710 ; The setting of the specified axis in degrees for the first
1711 data point of the array index with the corresponding value
1712 of <a href="#_array_structure_list.axis_set_id">_array_structure_list.axis_set_id</a>. If the index is
1713 specified as 'increasing', this will be the centre of the
1714 pixel with index value 1. If the index is specified as
1715 'decreasing', this will be the centre of the pixel with
1716 maximum index value.
1717 ;
1718 _item.name '<a href="#_array_structure_list_axis.angle" >_array_structure_list_axis.angle</a>'
1719 _item.category_id array_structure_list_axis
1720 _item.mandatory_code no
1721 _item_default.value 0.0
1722 _item_type.code float
1723 _item_units.code 'degrees'
1724 save_
1725
1726
1727 save_<a name="_array_structure_list_axis.angle_increment">_array_structure_list_axis.angle_increment</a>
1728 _item_description.description
1729 ; The pixel-centre-to-pixel-centre increment in the angular
1730 setting of the specified axis in degrees. This is not
1731 meaningful in the case of 'constant velocity' spiral scans
1732 and should not be specified for this case.
1733
1734 See <a href="#_array_structure_list_axis.angular_pitch">_array_structure_list_axis.angular_pitch</a>.
1735
1736 ;
1737 _item.name '<a href="#_array_structure_list_axis.angle_increment">_array_structure_list_axis.angle_increment</a>'
1738 _item.category_id array_structure_list_axis
1739 _item.mandatory_code no
1740 _item_default.value 0.0
1741 _item_type.code float
1742 _item_units.code 'degrees'
1743 save_
1744
1745
1746 save_<a name="_array_structure_list_axis.displacement" >_array_structure_list_axis.displacement</a>
1747 _item_description.description
1748 ; The setting of the specified axis in millimetres for the first
1749 data point of the array index with the corresponding value
1750 of <a href="#_array_structure_list.axis_set_id">_array_structure_list.axis_set_id</a>. If the index is
1751 specified as 'increasing', this will be the centre of the
1752 pixel with index value 1. If the index is specified as
1753 'decreasing', this will be the centre of the pixel with
1754 maximum index value.
1755 ;
1756 _item.name '<a href="#_array_structure_list_axis.displacement" >_array_structure_list_axis.displacement</a>'
1757 _item.category_id array_structure_list_axis
1758 _item.mandatory_code no
1759 _item_default.value 0.0
1760 _item_type.code float
1761 _item_units.code 'millimetres'
1762 save_
1763
1764 save_<a name="_array_structure_list_axis.fract_displacement" >_array_structure_list_axis.fract_displacement</a>
1765 _item_description.description
1766 ; The setting of the specified axis as a decimal fraction of
1767 the axis unit vector for the first data point of the array
1768 index with the corresponding value of
1769 <a href="#_array_structure_list.axis_set_id">_array_structure_list.axis_set_id</a>.
1770 If the index is specified as 'increasing', this will be the
1771 centre of the pixel with index value 1. If the index is
1772 specified as 'decreasing', this will be the centre of the
1773 pixel with maximum index value.
1774 ;
1775 _item.name '<a href="#_array_structure_list_axis.fract_displacement" >_array_structure_list_axis.fract_displacement</a>'
1776 _item.category_id array_structure_list_axis
1777 _item.mandatory_code no
1778 _item_default.value 0.0
1779 _item_type.code float
1780 save_
1781
1782 save_<a name="_array_structure_list_axis.displacement_increment">_array_structure_list_axis.displacement_increment</a>
1783 _item_description.description
1784 ; The pixel-centre-to-pixel-centre increment for the displacement
1785 setting of the specified axis in millimetres.
1786 ;
1787 _item.name
1788 '<a href="#_array_structure_list_axis.displacement_increment">_array_structure_list_axis.displacement_increment</a>'
1789 _item.category_id array_structure_list_axis
1790 _item.mandatory_code no
1791 _item_default.value 0.0
1792 _item_type.code float
1793 _item_units.code 'millimetres'
1794 save_
1795
1796 save_<a name="_array_structure_list_axis.fract_displacement_increment">_array_structure_list_axis.fract_displacement_increment</a>
1797 _item_description.description
1798 ; The pixel-centre-to-pixel-centre increment for the displacement
1799 setting of the specified axis as a decimal fraction of the
1800 axis unit vector.
1801 ;
1802 _item.name
1803 '<a href="#_array_structure_list_axis.fract_displacement_increment">_array_structure_list_axis.fract_displacement_increment</a>'
1804 _item.category_id array_structure_list_axis
1805 _item.mandatory_code no
1806 _item_default.value 0.0
1807 _item_type.code float
1808 _item_units.code 'millimetres'
1809 save_
1810
1811
1812 save_<a name="_array_structure_list_axis.angular_pitch">_array_structure_list_axis.angular_pitch</a>
1813 _item_description.description
1814 ; The pixel-centre-to-pixel-centre distance for a one-step
1815 change in the setting of the specified axis in millimetres.
1816
1817 This is meaningful only for 'constant velocity' spiral scans
1818 or for uncoupled angular scans at a constant radius
1819 (cylindrical scans) and should not be specified for cases
1820 in which the angle between pixels (rather than the distance
1821 between pixels) is uniform.
1822
1823 See <a href="#_array_structure_list_axis.angle_increment">_array_structure_list_axis.angle_increment</a>.
1824 ;
1825 _item.name '<a href="#_array_structure_list_axis.angular_pitch">_array_structure_list_axis.angular_pitch</a>'
1826 _item.category_id array_structure_list_axis
1827 _item.mandatory_code no
1828 _item_default.value 0.0
1829 _item_type.code float
1830 _item_units.code 'millimetres'
1831 save_
1832
1833
1834 save_<a name="_array_structure_list_axis.radial_pitch">_array_structure_list_axis.radial_pitch</a>
1835 _item_description.description
1836 ; The radial distance from one 'cylinder' of pixels to the
1837 next in millimetres. If the scan is a 'constant velocity'
1838 scan with differing angular displacements between pixels,
1839 the value of this item may differ significantly from the
1840 value of <a href="#_array_structure_list_axis.displacement_increment">_array_structure_list_axis.displacement_increment</a>.
1841 ;
1842 _item.name '<a href="#_array_structure_list_axis.radial_pitch">_array_structure_list_axis.radial_pitch</a>'
1843 _item.category_id array_structure_list_axis
1844 _item.mandatory_code no
1845 _item_default.value 0.0
1846 _item_type.code float
1847 _item_units.code 'millimetres'
1848 save_
1849
1850
1851 save_<a name="_array_structure_list_axis.reference_angle">_array_structure_list_axis.reference_angle</a>
1852 _item_description.description
1853 ; The value of _array_structure_list_axis.reference_angle
1854 specifies the setting of the angle of this axis used for
1855 determining a reference beam center and a reference detector
1856 distance. It is normally expected to be identical to the
1857 value of _array_structure_list.angle.
1858
1859 ;
1860 _item.name '<a href="#_array_structure_list_axis.reference_angle">_array_structure_list_axis.reference_angle</a>'
1861 _item.category_id array_structure_list_axis
1862 _item.mandatory_code implicit
1863 _item_type.code float
1864 _item_units.code 'degrees'
1865 save_
1866
1867
1868 save_<a name="_array_structure_list_axis.reference_displacement">_array_structure_list_axis.reference_displacement</a>
1869 _item_description.description
1870 ; The value of _array_structure_list_axis.reference_displacement
1871 specifies the setting of the displacement of this axis used
1872 for determining a reference beam center and a reference detector
1873 distance. It is normally expected to be identical to the value
1874 of _array_structure_list.displacement.
1875
1876 ;
1877 _item.name '<a href="#_array_structure_list_axis.reference_displacement">_array_structure_list_axis.reference_displacement</a>'
1878 _item.category_id array_structure_list_axis
1879 _item.mandatory_code implicit
1880 _item_type.code float
1881 _item_units.code 'millimetres'
1882 save_
1883
1884
1885
1886
1887 ########
1888 # <a name="AXIS">AXIS</a> #
1889 ########
1890
1891 save_AXIS
1892 _category.description
1893 ; Data items in the <a href="#AXIS">AXIS</a> category record the information required
1894 to describe the various goniometer, detector, source and other
1895 axes needed to specify a data collection or the axes defining the
1896 coordinate system of an image.
1897
1898 The location of each axis is specified by two vectors: the axis
1899 itself, given by a unit vector in the direction of the axis, and
1900 an offset to the base of the unit vector.
1901
1902 The vectors defining an axis are referenced to an appropriate
1903 coordinate system. The axis vector, itself, is a dimensionless
1904 unit vector. Where meaningful, the offset vector is given in
1905 millimetres. In coordinate systems not measured in metres,
1906 the offset is not specified and is taken as zero.
1907
1908 The available coordinate systems are:
1909
1910 The imgCIF standard laboratory coordinate system
1911 The direct lattice (fractional atomic coordinates)
1912 The orthogonal Cartesian coordinate system (real space)
1913 The reciprocal lattice
1914 An abstract orthogonal Cartesian coordinate frame
1915
1916 For consistency in this discussion, we call the three coordinate
1917 system axes <b>X</b>, <b>Y</b> and <b>Z</b>. This is appropriate for the imgCIF
1918 standard laboratory coordinate system, and last two Cartesian
1919 coordinate systems, but for the direct lattice, <b>X</b> corresponds
1920 to <b>a</b>, <b>Y</b> to <b>b</b> and <b>Z</b> to <b>c</b>, while for the reciprocal lattice,
1921 <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>.
1922
1923 For purposes of visualization, all the coordinate systems are
1924 taken as right-handed, i.e., using the convention that the extended
1925 thumb of a right hand could point along the first (<b>X</b>) axis, the
1926 straightened pointer finger could point along the second (<b>Y</b>) axis
1927 and the middle finger folded inward could point along the third (<b>Z</b>)
1928 axis.
1929
1930 <b>THE IMGCIF STANDARD LABORATORY COORDINATE SYSTEM</b>
1931
1932 The imgCIF standard laboratory coordinate system is a right-handed
1933 orthogonal coordinate similar to the MOSFLM coordinate system,
1934 but imgCIF puts Z along the X-ray beam, rather than putting X along the
1935 X-ray beam as in MOSFLM.
1936
1937 The vectors for the imgCIF standard laboratory coordinate system
1938 form a right-handed Cartesian coordinate system with its origin
1939 in the sample or specimen. The origin of the axis system should,
1940 if possible, be defined in terms of mechanically stable axes to be
1941 be both in the sample and in the beam. If the sample goniometer or other
1942 sample positioner has two axes the intersection of which defines a
1943 unique point at which the sample should be mounted to be bathed
1944 by the beam, that will be the origin of the axis system. If no such
1945 point is defined, then the midpoint of the line of intersection
1946 between the sample and the center of the beam will define the origin.
1947 For this definition the sample positioning system will be set at
1948 its initial reference position for the experiment.
1949
1950
1951 | <b>Y</b> (to complete right-handed system)
1952 |
1953 |
1954 |
1955 |
1956 |
1957 |________________<b><b>X</b></b>
1958 / principal goniometer axis
1959 /
1960 /
1961 /
1962 /
1963 /<b>Z</b> (to source)
1964
1965
1966
1967
1968 Axis 1 (<b>X</b>): The <b>X</b>-axis is aligned to the mechanical axis pointing from
1969 the sample or specimen along the principal axis of the goniometer or
1970 sample positioning system if the sample positioning system has an axis
1971 that intersects the origin and which form an angle of more than 22.5
1972 degrees with the beam axis.
1973
1974 Axis 2 (<b>Y</b>): The <b>Y</b>-axis completes an orthogonal right-handed system
1975 defined by the <b><b>X</b></b>-axis and the <b>Z</b>-axis (see below).
1976
1977 Axis 3 (<b>Z</b>): The <b>Z</b>-axis is derived from the source axis which goes from
1978 the sample to the source. The <b>Z</b>-axis is the component of the source axis
1979 in the direction of the source orthogonal to the <b>X</b>-axis in the plane
1980 defined by the <b>X</b>-axis and the source axis.
1981
1982 If the conditions for the <b>X</b>-axis can be met, the coordinate system
1983 will be based on the goniometer or other sample positioning system
1984 and the beam and not on the orientation of the detector, gravity etc.
1985 The vectors necessary to specify all other axes are given by sets of
1986 three components in the order (<b>X</b>, <b>Y</b>, <b>Z</b>).
1987 If the axis involved is a rotation axis, it is right-handed, i.e. as
1988 one views the object to be rotated from the origin (the tail) of the
1989 unit vector, the rotation is clockwise. If a translation axis is
1990 specified, the direction of the unit vector specifies the sense of
1991 positive translation.
1992
1993 Note: This choice of coordinate system is similar to but significantly
1994 different from the choice in MOSFLM (Leslie & Powell, 2004). In MOSFLM,
1995 <b>X</b> is along the X-ray beam (the CBF/imgCIF <b>Z</b> axis) and <b>Z</b> is along the
1996 rotation axis.
1997
1998 In some experimental techniques, there is no goniometer or the principal
1999 axis of the goniometer is at a small acute angle with respect to
2000 the source axis. In such cases, other reference axes are needed
2001 to define a useful coordinate system. The order of priority in
2002 defining directions in such cases is to use the detector, then
2003 gravity, then north.
2004
2005
2006 If the <b>X</b>-axis cannot be defined as above, then the
2007 direction (not the origin) of the X-axis should be parallel to the axis
2008 of the primary detector element corresponding to the most rapidly
2009 varying dimension of that detector element's data array, with its
2010 positive sense corresponding to increasing values of the index for
2011 that dimension. If the detector is such that such a direction cannot
2012 be defined (as with a point detector) or that direction forms an
2013 angle of less than 22.5 degrees with respect to the source axis, then
2014 the <b>X</b>-axis should be chosen so that if the <b>Y</b>-axis is chosen
2015 in the direction of gravity, and the <b>Z</b>-axis is chosen to be along
2016 the source axis, a right-handed orthogonal coordinate system is chosen.
2017 In the case of a vertical source axis, as a last resort, the
2018 <b>X</b>-axis should be chosen to point North.
2019
2020 All rotations are given in degrees and all translations are given in mm.
2021
2022 Axes may be dependent on one another. The <b>X</b>-axis is the only goniometer
2023 axis the direction of which is strictly connected to the hardware. All
2024 other axes are specified by the positions they would assume when the
2025 axes upon which they depend are at their zero points.
2026
2027 When specifying detector axes, the axis is given to the beam centre.
2028 The location of the beam centre on the detector should be given in the
2029 <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a> category in distortion-corrected millimetres from
2030 the (0,0) corner of the detector.
2031
2032 It should be noted that many different origins arise in the definition
2033 of an experiment. In particular, as noted above, it is necessary to
2034 specify the location of the beam centre on the detector in terms
2035 of the origin of the detector, which is, of course, not coincident
2036 with the centre of the sample.
2037
2038 The unit cell, reciprocal cell and crystallographic orthogonal
2039 Cartesian coordinate system are defined by the CELL and the matrices
2040 in the ATOM_SITES category.
2041
2042 <b>THE DIRECT LATTICE (FRACTIONAL COORDINATES)</b>
2043
2044 The direct lattice coordinate system is a system of fractional
2045 coordinates aligned to the crystal, rather than to the laboratory.
2046 This is a natural coordinate system for maps and atomic coordinates.
2047 It is the simplest coordinate system in which to apply symmetry.
2048 The axes are determined by the cell edges, and are not necessarily
2049 othogonal. This coordinate system is not uniquely defined and
2050 depends on the cell parameters in the CELL category and the
2051 settings chosen to index the crystal.
2052
2053 Molecules in a crystal studied by X-ray diffracraction are organized
2054 into a repeating regular array of unit cells. Each unit cell is defined
2055 by three vectors, <b>a</b>, <b>b</b> and <b>c</b>. To quote from Drenth,
2056
2057
2058 "The choice of the unit cell is not unique and therefore, guidelines
2059 have been established for selecting the standard basis vectors and
2060 the origin. They are based on symmetry and metric considerations:
2061
2062 "(1) The axial system should be right handed.
2063 (2) The basis vectors should coincide as much as possible with
2064 directions of highest symmetry."
2065 (3) The cell taken should be the smallest one that satisfies
2066 condition (2)
2067 (4) Of all the lattice vectors, none is shorter than <b>a</b>.
2068 (5) Of those not directed along <b>a</b>, none is shorter than <b>b</b>.
2069 (6) Of those not lying in the <b>ab</b> plane, none is shorter than c.
2070 (7) The three angles between the basis vectors <b>a</b>, <b>b</b> and <b>c</b> are
2071 either all acute (&lt;90\%) or all obtuse (&ge;90\%)."
2072
2073 These rules do not produce a unique result that is stable under
2074 the assumption of experimental errors, and the the resulting cell
2075 may not be primitive.
2076
2077 In this coordinate system, the vector (.5, .5, .5) is in the middle
2078 of the given unit cell.
2079
2080 Grid coordinates are an important variation on fractional coordinates
2081 used when working with maps. In imgCIF, the conversion from
2082 fractional to grid coordinates is implicit in the array indexing
2083 specified by _array_structure_list.dimension. Note that this
2084 implicit grid-coordinate scheme is 1-based, not zero-based, i.e.
2085 the origin of the cell for axes along the cell edges with no
2086 specified _array_structure_list_axis.displacement will have
2087 grid coordinates of (1,1,1), i.e. array indices of (1,1,1).
2088
2089 <b>THE ORTHOGONAL CARTESIAN COORDINATE SYSTEM (REAL SPACE)</b>
2090
2091 The orthogonal Cartesian coordinate system is a transformation of
2092 the direct lattice to the actual physical coordinates of atoms in
2093 space. It is similar to the laboratory coordinate system, but
2094 is anchored to and moves with the crystal, rather than being
2095 schored to the laboratory. The transformation from fractional
2096 to orthogonal cartesian coordinates is given by the
2097 _atom_sites.Cartn_transf_matrix[i][j] and
2098 _atom_sites.Cartn_transf_vector[i]
2099 tags. A common choice for the matrix of the transformation is
2100 given in the 1992 PDB format document
2101
2102 | a b cos(\g) c cos(\b) |
2103 | 0 b sin(\g) c (cos(\a) - cos(\b)cos(\g))/sin(\g) |
2104 | 0 0 V/(a b sin(\g)) |
2105
2106 This is a convenient coordinate system in which to do fitting
2107 of models to maps and in which to understand the chemistry of
2108 a molecule.
2109
2110 <b>THE RECIPROCAL LATTICE</b>
2111
2112 The reciprocal lattice coordinate system is used for diffraction
2113 intensitities. It is based on the reciprocal cell, the dual of the cell,
2114 in which reciprocal cell edges are derived from direct cell faces:
2115
2116 a* = bc sin(\a)/V b* = ac sin(\b)/V c* = ab sin(\g)/V
2117 cos(\a*) = (cos(\b) cos(\g) - cos(\a))/(sin(\b) sin(\g))
2118 cos(\b*) = (cos(\a) cos(\g) - cos(\b))/(sin(\a) sin(\g))
2119 cos(\g*) = (cos(\a) cos(\b) - cos(\g))/(sin(\a) sin(\b))
2120 V = abc SQRT(1 - cos(\a)^<sup>2</sup>^
2121 - cos(\b)^<sup>2</sup>^
2122 - cos(\g)^<sup>2</sup>^
2123 + 2 cos(\a) cos(\b) cos(\g) )
2124
2125 In this form the dimensions of the reciprocal lattice are in reciprocal
2126 \%Angstroms (\%A^<sup>-1</sup>^). A dimensionless form can be obtained by
2127 multiplying by the wavelength. Reflections are commonly indexed against
2128 this coordinate system as (h, k, l) triples.
2129
2130
2131 References:
2132
2133 Drenth, J., "Introduction to basic crystallography." chapter
2134 2.1 in Rossmann, M. G. and Arnold, E. "Crystallography of
2135 biological macromolecules", Volume F of the IUCr's "International
2136 tables for crystallography", Kluwer, Dordrecht 2001, pp 44 -- 63
2137
2138 Leslie, A. G. W. and Powell, H. (2004). MOSFLM v6.11.
2139 MRC Laboratory of Molecular Biology, Hills Road, Cambridge, England.
2140 http://www.CCP4.ac.uk/dist/<b>X</b>-windows/Mosflm/.
2141
2142 Stout, G. H. and Jensen, L. H., "X-ray structure determination",
2143 2nd ed., Wiley, New York, 1989, 453 pp.
2144
2145 __, "PROTEIN DATA BANK ATOMIC COORDINATE AND BIBLIOGRAPHIC ENTRY
2146 FORMAT DESCRIPTION," Brookhaven National Laboratory, February 1992.
2147 ;
2148 _category.id axis
2149 _category.mandatory_code no
2150 loop_
2151 _category_key.name '<a href="#_axis.id" >_axis.id</a>'
2152 '_axis.equipment'
2153 loop_
2154 _category_group.id 'inclusive_group'
2155 'axis_group'
2156 'diffrn_group'
2157 loop_
2158 _category_examples.detail
2159 _category_examples.case
2160 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
2161 ; Example 1 -
2162
2163 This example shows the axis specification of the axes of a kappa-
2164 geometry goniometer [see Stout, G. H. & Jensen, L. H. (1989). X-ray
2165 structure determination. A practical
2166 guide, 2nd ed. p. 134. New York: Wiley Interscience].
2167
2168 There are three axes specified, and no offsets. The outermost axis,
2169 omega, is pointed along the <b>X</b> axis. The next innermost axis, kappa,
2170 is at a 50 degree angle to the <b>X</b> axis, pointed away from the source.
2171 The innermost axis, phi, aligns with the <b>X</b> axis when omega and
2172 phi are at their zero points. If T-omega, T-kappa and T-phi
2173 are the transformation matrices derived from the axis settings,
2174 the complete transformation would be:
2175 <b>X</b>' = (T-omega) (T-kappa) (T-phi) <b>X</b>
2176 ;
2177 ;
2178 loop_
2179 <a href="#_axis.id" >_axis.id</a>
2180 <a href="#_axis.type" >_axis.type</a>
2181 <a href="#_axis.equipment" >_axis.equipment</a>
2182 <a href="#_axis.depends_on" >_axis.depends_on</a>
2183 <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>
2184 omega rotation goniometer . 1 0 0
2185 kappa rotation goniometer omega -.64279 0 -.76604
2186 phi rotation goniometer kappa 1 0 0
2187 ;
2188 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
2189 ; Example 2 -
2190
2191 This example shows the axis specification of the axes of a
2192 detector, source and gravity. The order has been changed as a
2193 reminder that the ordering of presentation of tokens is not
2194 significant. The centre of rotation of the detector has been taken
2195 to be 68 millimetres in the direction away from the source.
2196 ;
2197 ;
2198 loop_
2199 <a href="#_axis.id" >_axis.id</a>
2200 <a href="#_axis.type" >_axis.type</a>
2201 <a href="#_axis.equipment" >_axis.equipment</a>
2202 <a href="#_axis.depends_on" >_axis.depends_on</a>
2203 <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>
2204 <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>
2205 source . source . 0 0 1 . . .
2206 gravity . gravity . 0 -1 0 . . .
2207 tranz translation detector rotz 0 0 1 0 0 -68
2208 twotheta rotation detector . 1 0 0 . . .
2209 roty rotation detector twotheta 0 1 0 0 0 -68
2210 rotz rotation detector roty 0 0 1 0 0 -68
2211 ;
2212 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
2213 ; Example 3 -
2214
2215 This example show the axis specification of the axes for a map,
2216 using fractional coordinates. Each cell edge has been divided
2217 into a grid of 50 divisions in the ARRAY_STRUCTURE_LIST_AXIS
2218 category. The map is using only the first octant of the grid
2219 in the ARRAY_STRUCTURE_LIST category.
2220
2221 The fastest changing axis is the gris along A, then along B,
2222 and the slowest is along C.
2223
2224 The map sampling is being done in the middle of each grid
2225 division
2226
2227 ;
2228 ;
2229 loop_
2230 <a href="#_axis.id" >_axis.id</a>
2231 <a href="#_axis.system">_axis.system</a>
2232 <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>
2233 CELL_A_AXIS fractional 1 0 0
2234 CELL_B_AXIS fractional 0 1 0
2235 CELL_C_AXIS fractional 0 0 1
2236
2237 loop_
2238 _array_structure_list.array_id
2239 _array_structure_list.index
2240 _array_structure_list.dimension
2241 _array_structure_list.precedence
2242 _array_structure_list.direction
2243 _array_structure_list.axis_id
2244 MAP 1 25 1 increasing CELL_A_AXIS
2245 MAP 1 25 2 increasing CELL_B_AXIS
2246 MAP 1 25 3 increasing CELL_C_AXIS
2247
2248 loop_
2249 _array_structure_list_axis.axis_id
2250 _array_structure_list_axis.fract_displacement
2251 _array_structure_list_axis.fract_displacement_increment
2252 CELL_A_AXIS 0.01 0.02
2253 CELL_B_AXIS 0.01 0.02
2254 CELL_C_AXIS 0.01 0.02
2255
2256
2257
2258 ;
2259 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
2260 ; Example 4 -
2261
2262 This example show the axis specification of the axes for a map,
2263 this time as orthogonal \%Angstroms, using the same coordinate system
2264 as for the atomic coordinates. The map is sampling every 1.5
2265 \%Angstroms (1.5e-7 millimeters) in a map segment 37.5 \%Angstroms on
2266 a side.
2267
2268 ;
2269 ;
2270 loop_
2271 <a href="#_axis.id" >_axis.id</a>
2272 <a href="#_axis.system">_axis.system</a>
2273 <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>
2274 X orthogonal 1 0 0
2275 Y orthogonal 0 1 0
2276 Z orthogonal 0 0 1
2277
2278 loop_
2279 _array_structure_list.array_id
2280 _array_structure_list.index
2281 _array_structure_list.dimension
2282 _array_structure_list.precedence
2283 _array_structure_list.direction
2284 _array_structure_list.axis_id
2285 MAP 1 25 1 increasing X
2286 MAP 2 25 2 increasing Y
2287 MAP 3 25 3 increasing Z
2288
2289 loop_
2290 _array_structure_list_axis.axis_id
2291 _array_structure_list_axis.displacement
2292 _array_structure_list_axis.displacement_increment
2293 X 7.5e-8 1.5e-7
2294 Y 7.5e-8 1.5e-7
2295 Z 7.5e-8 1.5e-7
2296
2297
2298 ;
2299 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
2300 save_
2301
2302
2303 save_<a name="_axis.depends_on" >_axis.depends_on</a>
2304 _item_description.description
2305 ; The value of <a href="#_axis.depends_on" >_axis.depends_on</a> specifies the next outermost
2306 axis upon which this axis depends.
2307
2308 This item is a pointer to <a href="#_axis.id">_axis.id</a> in the same category.
2309 ;
2310 _item.name '<a href="#_axis.depends_on">_axis.depends_on</a>'
2311 _item.category_id axis
2312 _item.mandatory_code no
2313
2314 save_
2315
2316
2317 save_<a name="_axis.equipment" >_axis.equipment</a>
2318 _item_description.description
2319 ; The value of <a href="#_axis.equipment" >_axis.equipment</a> specifies the type of
2320 equipment using the axis: 'goniometer', 'detector',
2321 'gravity', 'source' or 'general'.
2322 ;
2323 _item.name '<a href="#_axis.equipment">_axis.equipment</a>'
2324 _item.category_id axis
2325 _item.mandatory_code no
2326 _item_type.code ucode
2327 _item_default.value general
2328 loop_
2329 _item_enumeration.value
2330 _item_enumeration.detail goniometer
2331 'equipment used to orient or position samples'
2332 detector
2333 'equipment used to detect reflections'
2334 general
2335 'equipment used for general purposes'
2336 gravity
2337 'axis specifying the downward direction'
2338 source
2339 'axis specifying the direction sample to source'
2340
2341 save_
2342
2343
2344 save_<a name="_axis.offset[1]" >_axis.offset[1]</a>
2345 _item_description.description
2346 ; The [1] element of the three-element vector used to specify
2347 the offset to the base of a rotation or translation axis.
2348
2349 The vector is specified in millimetres.
2350 ;
2351 _item.name '<a href="#_axis.offset[1]">_axis.offset[1]</a>'
2352 _item.category_id axis
2353 _item.mandatory_code no
2354 _item_default.value 0.0
2355 _item_sub_category.id vector
2356 _item_type.code float
2357 _item_units.code millimetres
2358 save_
2359
2360
2361 save_<a name="_axis.offset[2]" >_axis.offset[2]</a>
2362 _item_description.description
2363 ; The [2] element of the three-element vector used to specify
2364 the offset to the base of a rotation or translation axis.
2365
2366 The vector is specified in millimetres.
2367 ;
2368 _item.name '<a href="#_axis.offset[2]">_axis.offset[2]</a>'
2369 _item.category_id axis
2370 _item.mandatory_code no
2371 _item_default.value 0.0
2372 _item_sub_category.id vector
2373 _item_type.code float
2374 _item_units.code millimetres
2375 save_
2376
2377
2378 save_<a name="_axis.offset[3]" >_axis.offset[3]</a>
2379 _item_description.description
2380 ; The [3] element of the three-element vector used to specify
2381 the offset to the base of a rotation or translation axis.
2382
2383 The vector is specified in millimetres.
2384 ;
2385 _item.name '<a href="#_axis.offset[3]">_axis.offset[3]</a>'
2386 _item.category_id axis
2387 _item.mandatory_code no
2388 _item_default.value 0.0
2389 _item_sub_category.id vector
2390 _item_type.code float
2391 _item_units.code millimetres
2392 save_
2393
2394
2395 save_<a name="_axis.id" >_axis.id</a></a>
2396 _item_description.description
2397 ; The value of <a href="#_axis.id" >_axis.id</a> must uniquely identify
2398 each axis relevant to the experiment. Note that multiple
2399 pieces of equipment may share the same axis (e.g. a twotheta
2400 arm), so the category key for <a href="#AXIS">AXIS</a> also includes the
2401 equipment.
2402 ;
2403 loop_
2404 _item.name
2405 _item.category_id
2406 _item.mandatory_code
2407 '<a href="#_axis.id" >_axis.id</a>' axis yes
2408 '<a href="#_array_structure_list_axis.axis_id" >_array_structure_list_axis.axis_id</a>'
2409 array_structure_list_axis
2410 yes
2411 '<a href="#_diffrn_detector_axis.axis_id" >_diffrn_detector_axis.axis_id</a>' diffrn_detector_axis yes
2412 '<a href="#_diffrn_measurement_axis.axis_id" >_diffrn_measurement_axis.axis_id</a>' diffrn_measurement_axis yes
2413 '<a href="#_diffrn_scan_axis.axis_id" >_diffrn_scan_axis.axis_id</a>' diffrn_scan_axis yes
2414 '<a href="#_diffrn_scan_frame_axis.axis_id" >_diffrn_scan_frame_axis.axis_id</a>' diffrn_scan_frame_axis yes
2415
2416 _item_type.code code
2417 loop_
2418 _item_linked.child_name
2419 _item_linked.parent_name
2420 '<a href="#_axis.depends_on" >_axis.depends_on</a>' '<a href="#_axis.id" >_axis.id</a>'
2421 '<a href="#_array_structure_list_axis.axis_id" >_array_structure_list_axis.axis_id</a>' '<a href="#_axis.id" >_axis.id</a>'
2422 '<a href="#_diffrn_detector_axis.axis_id" >_diffrn_detector_axis.axis_id</a>' '<a href="#_axis.id" >_axis.id</a>'
2423 '<a href="#_diffrn_measurement_axis.axis_id" >_diffrn_measurement_axis.axis_id</a>' '<a href="#_axis.id" >_axis.id</a>'
2424 '<a href="#_diffrn_scan_axis.axis_id" >_diffrn_scan_axis.axis_id</a>' '<a href="#_axis.id" >_axis.id</a>'
2425 '<a href="#_diffrn_scan_frame_axis.axis_id" >_diffrn_scan_frame_axis.axis_id</a>' '<a href="#_axis.id" >_axis.id</a>'
2426
2427 save_
2428
2429 save_<a name="_axis.system" >_axis.system</a>
2430 _item_description.description
2431 ; The value of <a href="#_axis.system" >_axis.system</a> specifies the coordinate
2432 system used to define the axis: 'laboratory', 'direct',
2433 'orthogonal', 'reciprocal' or 'abstract'.
2434 ;
2435 _item.name '<a href="#_axis.system">_axis.system</a>'
2436 _item.category_id axis
2437 _item.mandatory_code no
2438 _item_type.code ucode
2439 _item_default.value laboratory
2440 loop_
2441 _item_enumeration.value
2442 _item_enumeration.detail
2443
2444 laboratory
2445 ; the axis is referenced to the imgCIF standard laboratory Cartesian
2446 coordinate system
2447 ;
2448
2449 direct
2450 ; the axis is referenced to the direct lattice
2451 ;
2452
2453 orthogonal
2454 ; the axis is referenced to the cell Cartesian orthogonal coordinates
2455 ;
2456
2457 reciprocal
2458 ; the axis is referenced to the reciprocal lattice
2459 ;
2460
2461 abstract
2462 ; the axis is referenced to abstract Cartesian cooridinate system
2463 ;
2464
2465 save_
2466
2467
2468 save_<a name="_axis.type" >_axis.type</a>
2469 _item_description.description
2470 ; The value of <a href="#_axis.type" >_axis.type</a> specifies the type of
2471 axis: 'rotation' or 'translation' (or 'general' when
2472 the type is not relevant, as for gravity).
2473 ;
2474 _item.name '<a href="#_axis.type">_axis.type</a>'
2475 _item.category_id axis
2476 _item.mandatory_code no
2477 _item_type.code ucode
2478 _item_default.value general
2479 loop_
2480 _item_enumeration.value
2481 _item_enumeration.detail rotation
2482 'right-handed axis of rotation'
2483 translation
2484 'translation in the direction of the axis'
2485 general
2486 'axis for which the type is not relevant'
2487
2488 save_
2489
2490
2491 save_<a name="_axis.vector[1]" >_axis.vector[1]</a>
2492 _item_description.description
2493 ; The [1] element of the three-element vector used to specify
2494 the direction of a rotation or translation axis.
2495 The vector should be normalized to be a unit vector and
2496 is dimensionless.
2497 ;
2498 _item.name '<a href="#_axis.vector[1]" >_axis.vector[1]</a>'
2499 _item.category_id axis
2500 _item.mandatory_code no
2501 _item_default.value 0.0
2502 _item_sub_category.id vector
2503 _item_type.code float
2504 save_
2505
2506 save_<a name="_axis.vector[2]" >_axis.vector[2]</a>
2507 _item_description.description
2508 ; The [2] element of the three-element vector used to specify
2509 the direction of a rotation or translation axis.
2510 The vector should be normalized to be a unit vector and
2511 is dimensionless.
2512 ;
2513 _item.name '<a href="#_axis.vector[2]" >_axis.vector[2]</a>'
2514 _item.category_id axis
2515 _item.mandatory_code no
2516 _item_default.value 0.0
2517 _item_sub_category.id vector
2518 _item_type.code float
2519 save_
2520
2521 save_<a name="_axis.vector[3]" >_axis.vector[3]</a>
2522 _item_description.description
2523 ; The [3] element of the three-element vector used to specify
2524 the direction of a rotation or translation axis.
2525 The vector should be normalized to be a unit vector and
2526 is dimensionless.
2527 ;
2528 _item.name '<a href="#_axis.vector[3]" >_axis.vector[3]</a>'
2529 _item.category_id axis
2530 _item.mandatory_code no
2531 _item_default.value 0.0
2532 _item_sub_category.id vector
2533 _item_type.code float
2534 save_
2535
2536
2537
2538 #####################
2539 # <a name="DIFFRN_DATA_FRAME" >DIFFRN_DATA_FRAME</a> #
2540 #####################
2541
2542
2543 save_DIFFRN_DATA_FRAME
2544 _category.description
2545 ; Data items in the <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a> category record
2546 the details about each frame of data.
2547
2548 The items in this category were previously in a
2549 DIFFRN_FRAME_DATA category, which is now deprecated.
2550 The items from the old category are provided
2551 as aliases but should not be used for new work.
2552 ;
2553 _category.id diffrn_data_frame
2554 _category.mandatory_code no
2555 loop_
2556 _category_key.name '<a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a>'
2557 '<a href="#_diffrn_data_frame.detector_element_id" >_diffrn_data_frame.detector_element_id</a>'
2558 loop_
2559 _category_group.id 'inclusive_group'
2560 'array_data_group'
2561 loop_
2562 _category_examples.detail
2563 _category_examples.case
2564 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
2565 ; Example 1 - A frame containing data from 4 frame elements.
2566 Each frame element has a common array configuration
2567 'array_1' described in <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a> and related
2568 categories. The data for each detector element are
2569 stored in four groups of binary data in the
2570 <a href="#ARRAY_DATA">ARRAY_DATA</a> category, linked by the array_id and
2571 binary_id.
2572 ;
2573 ;
2574 loop_
2575 <a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a>
2576 <a href="#_diffrn_data_frame.detector_element_id" >_diffrn_data_frame.detector_element_id</a>
2577 <a href="#_diffrn_data_frame.array_id" >_diffrn_data_frame.array_id</a>
2578 <a href="#_diffrn_data_frame.binary_id" >_diffrn_data_frame.binary_id</a>
2579 frame_1 d1_ccd_1 array_1 1
2580 frame_1 d1_ccd_2 array_1 2
2581 frame_1 d1_ccd_3 array_1 3
2582 frame_1 d1_ccd_4 array_1 4
2583 ;
2584 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
2585 save_
2586
2587
2588 save_<a name="_diffrn_data_frame.array_id" >_diffrn_data_frame.array_id</a>
2589 _item_description.description
2590 ; This item is a pointer to <a href="#_array_structure.id" >_array_structure.id</a> in the
2591 <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a> category.
2592 ;
2593 _item.name '<a href="#_diffrn_data_frame.array_id" >_diffrn_data_frame.array_id</a>'
2594 _item.category_id diffrn_data_frame
2595 _item.mandatory_code implicit
2596 _item_aliases.alias_name '_diffrn_frame_data.array_id'
2597 _item_aliases.dictionary cif_img.dic
2598 _item_aliases.version 1.0
2599 _item_type.code code
2600 save_
2601
2602
2603 save_<a name="_diffrn_data_frame.binary_id" >_diffrn_data_frame.binary_id</a>
2604 _item_description.description
2605 ; This item is a pointer to <a href="#_array_data.binary_id" >_array_data.binary_id</a> in the
2606 <a href="#ARRAY_DATA">ARRAY_DATA</a> category.
2607 ;
2608 _item.name '<a href="#_diffrn_data_frame.binary_id" >_diffrn_data_frame.binary_id</a>'
2609 _item.category_id diffrn_data_frame
2610 _item.mandatory_code implicit
2611 _item_aliases.alias_name '_diffrn_frame_data.binary_id'
2612 _item_aliases.dictionary cif_img.dic
2613 _item_aliases.version 1.0
2614 _item_type.code int
2615 save_
2616
2617
2618 save_<a name="_diffrn_data_frame.center_fast">_diffrn_data_frame.center_fast</a>
2619 _item_description.description
2620 ; The value of <a href="#_diffrn_data_frame.center_fast">_diffrn_data_frame.center_fast</a> is
2621 the fast index axis beam center position relative to the detector
2622 element face in the units specified in the data item
2623 '<a href="#_diffrn_data_frame.center_units">_diffrn_data_frame.center_units</a>' along the fast
2624 axis of the detector from the center of the first pixel to
2625 the point at which the Z-axis (which should be colinear with the
2626 beam) intersects the face of the detector, if in fact is does.
2627 At the time of the measurement the current setting of detector
2628 positioner given frame are used.
2629
2630 It is important to note that for measurements in millimetres,
2631 the sense of the axis is used, rather than the sign of the
2632 pixel-to-pixel increments.
2633
2634 ;
2635 _item.name '<a href="#_diffrn_data_frame.center_fast">_diffrn_data_frame.center_fast</a>'
2636 _item.category_id diffrn_data_frame
2637 _item.mandatory_code no
2638 _item_type.code float
2639
2640 save_
2641
2642
2643 save_<a name="_diffrn_data_frame.center_slow">_diffrn_data_frame.center_slow</a>
2644 _item_description.description
2645 ; The value of <a href="#_diffrn_data_frame.center_slow">_diffrn_data_frame.center_slow</a> is
2646 the slow index axis beam center position relative to the detector
2647 element face in the units specified in the data item
2648 '<a href="#_diffrn_data_frame.center_units">_diffrn_data_frame.center_units</a>' along the slow
2649 axis of the detector from the center of the first pixel to
2650 the point at which the Z-axis (which should be colinear with the
2651 beam) intersects the face of the detector, if in fact is does.
2652 At the time of the measurement the current setting of detector
2653 positioner given frame are used.
2654
2655 It is important to note that the sense of the axis is used,
2656 rather than the sign of the pixel-to-pixel increments.
2657
2658 ;
2659 _item.name '<a href="#_diffrn_data_frame.center_slow">_diffrn_data_frame.center_slow</a>'
2660 _item.category_id diffrn_data_frame
2661 _item.mandatory_code no
2662 _item_type.code float
2663
2664 save_
2665
2666
2667 save_<a name="_diffrn_data_frame.center_units">_diffrn_data_frame.center_units</a>
2668 _item_description.description
2669 ; The value of <a href="#_diffrn_data_frame.center_units">_diffrn_data_frame.center_units</a>
2670 specifies the units in which the values of
2671 '<a href="#_diffrn_data_frame.center_fast">_diffrn_data_frame.center_fast</a>' and
2672 '<a href="#_diffrn_data_frame.center_slow">_diffrn_data_frame.center_slow</a>'
2673 are presented. The default is 'mm' for millimetres. The
2674 alternatives are 'pixels' and 'bins'. In all cases the
2675 center distances are measured from the center of the
2676 first pixel, i.e. in a 2x2 binning, the measuring origin
2677 is offset from the centers of the bins by one half pixel
2678 towards the first pixel.
2679
2680 If 'bins' is specified, the data in
2681 '<a href="#_array_intensities.pixel_fast_bin_size" >_array_intensities.pixel_fast_bin_size</a>',
2682 '<a href="#_array_intensities.pixel_slow_bin_size" >_array_intensities.pixel_slow_bin_size</a>', and
2683 '<a href="#_array_intensities.pixel_binning_method" >_array_intensities.pixel_binning_method</a>'
2684 is used to define the binning scheme.
2685
2686
2687 ;
2688 _item.name '<a href="#_diffrn_data_frame.center_units">_diffrn_data_frame.center_units</a>'
2689 _item.category_id diffrn_data_frame
2690 _item.mandatory_code no
2691 _item_type.code code
2692 loop_
2693 _item_enumeration.value
2694 _item_enumeration.detail
2695 mm 'millimetres'
2696 pixels 'detector pixels'
2697 bins 'detector bins'
2698
2699 save_
2700
2701
2702
2703
2704 save_<a name="_diffrn_data_frame.detector_element_id" >_diffrn_data_frame.detector_element_id</a>
2705 _item_description.description
2706 ; This item is a pointer to <a href="#_diffrn_detector_element.id">_diffrn_detector_element.id</a>
2707 in the <a href="#DIFFRN_DETECTOR_ELEMENT">DIFFRN_DETECTOR_ELEMENT</a> category.
2708 ;
2709 _item.name '<a href="#_diffrn_data_frame.detector_element_id" >_diffrn_data_frame.detector_element_id</a>'
2710 _item.category_id diffrn_data_frame
2711 _item.mandatory_code yes
2712 _item_aliases.alias_name '_diffrn_frame_data.detector_element_id'
2713 _item_aliases.dictionary cif_img.dic
2714 _item_aliases.version 1.0
2715 _item_type.code code
2716 save_
2717
2718
2719 save_<a name="_diffrn_data_frame.id" >_diffrn_data_frame.id</a>
2720 _item_description.description
2721 ; The value of <a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a> must uniquely identify
2722 each complete frame of data.
2723 ;
2724 loop_
2725 _item.name
2726 _item.category_id
2727 _item.mandatory_code
2728 '<a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a>' diffrn_data_frame yes
2729 '<a href="#_diffrn_refln.frame_id" >_diffrn_refln.frame_id</a>' diffrn_refln yes
2730 '<a href="#_diffrn_scan.frame_id_start" >_diffrn_scan.frame_id_start</a>' diffrn_scan yes
2731 '<a href="#_diffrn_scan.frame_id_end" >_diffrn_scan.frame_id_end</a>' diffrn_scan yes
2732 '<a href="#_diffrn_scan_frame.frame_id" >_diffrn_scan_frame.frame_id</a>' diffrn_scan_frame yes
2733 '<a href="#_diffrn_scan_frame_axis.frame_id" >_diffrn_scan_frame_axis.frame_id</a>'
2734 diffrn_scan_frame_axis
2735 yes
2736 _item_aliases.alias_name '_diffrn_frame_data.id'
2737 _item_aliases.dictionary cif_img.dic
2738 _item_aliases.version 1.0
2739 _item_type.code code
2740 loop_
2741 _item_linked.child_name
2742 _item_linked.parent_name
2743 '<a href="#_diffrn_refln.frame_id" >_diffrn_refln.frame_id</a>' '<a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a>'
2744 '<a href="#_diffrn_scan.frame_id_start" >_diffrn_scan.frame_id_start</a>' '<a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a>'
2745 '<a href="#_diffrn_scan.frame_id_end" >_diffrn_scan.frame_id_end</a>' '<a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a>'
2746 '<a href="#_diffrn_scan_frame.frame_id" >_diffrn_scan_frame.frame_id</a>' '<a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a>'
2747 '<a href="#_diffrn_scan_frame_axis.frame_id" >_diffrn_scan_frame_axis.frame_id</a>'
2748 '<a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a>'
2749 save_
2750
2751
2752 save_<a name="_diffrn_data_frame.details" >_diffrn_data_frame.details</a>
2753 _item_description.description
2754 ; The value of <a href="#_diffrn_data_frame.details" >_diffrn_data_frame.details</a> should give a
2755 description of special aspects of each frame of data.
2756
2757 This is an appropriate location in which to record
2758 information from vendor headers as presented in those
2759 headers, but it should never be used as a substitute
2760 for providing the fully parsed information within
2761 the appropriate imgCIF/CBF categories.
2762
2763 Normally, when a conversion from a miniCBF has been done
2764 the data from '<a href="#_array_data.header_convention">_array_data.header_convention</a>'
2765 should be transferred to this data item and
2766 '<a href="#_array_data.header_convention">_array_data.header_convention</a>'
2767 should be removed.
2768 ;
2769 _item.name '<a name="_diffrn_data_frame.details" >_diffrn_data_frame.details</a>'
2770 _item.category_id diffrn_data_frame
2771 _item.mandatory_code no
2772 _item_aliases.alias_name '_diffrn_frame_data.details'
2773 _item_aliases.dictionary cif_img.dic
2774 _item_aliases.version 1.4
2775 _item_type.code text
2776 loop_
2777 _item_examples.case
2778 _item_examples.detail
2779 ;
2780 HEADER_BYTES = 512;
2781 DIM = 2;
2782 BYTE_ORDER = big_endian;
2783 TYPE = unsigned_short;
2784 SIZE1 = 3072;
2785 SIZE2 = 3072;
2786 PIXEL_SIZE = 0.102588;
2787 BIN = 2x2;
2788 DETECTOR_SN = 901;
2789 TIME = 29.945155;
2790 DISTANCE = 200.000000;
2791 PHI = 85.000000;
2792 OSC_START = 85.000000;
2793 OSC_RANGE = 1.000000;
2794 WAVELENGTH = 0.979381;
2795 BEAM_CENTER_X = 157.500000;
2796 BEAM_CENTER_Y = 157.500000;
2797 PIXEL SIZE = 0.102588;
2798 OSCILLATION RANGE = 1;
2799 EXPOSURE TIME = 29.9452;
2800 TWO THETA = 0;
2801 BEAM CENTRE = 157.5 157.5;
2802 ;
2803 ; Example of header information extracted from an ADSC Quantum
2804 315 detector header by CBFlib_0.7.6. Image provided by Chris
2805 Nielsen of ADSC from a data collection at SSRL beamline 1-5.
2806 ;
2807 save_
2808
2809
2810
2811 ##########################################################################
2812 # The following is a restatement of the mmCIF <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a>, #
2813 # <a href="#DIFFRN_MEASUREMENT">DIFFRN_MEASUREMENT</a> and <a href="#DIFFRN_RADIATION">DIFFRN_RADIATION</a> categories, modified for #
2814 # the CBF/imgCIF extensions #
2815 ##########################################################################
2816
2817 ###################
2818 # <a name="DIFFRN_DETECTOR">DIFFRN_DETECTOR</a> #
2819 ###################
2820
2821
2822 save_DIFFRN_DETECTOR
2823 _category.description
2824 ; Data items in the <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a> category describe the
2825 detector used to measure the scattered radiation, including
2826 any analyser and post-sample collimation.
2827 ;
2828 _category.id diffrn_detector
2829 _category.mandatory_code no
2830 loop_
2831 _category_key.name '<a href="#_diffrn_detector.diffrn_id" >_diffrn_detector.diffrn_id</a>'
2832 '<a href="#_diffrn_detector.id" >_diffrn_detector.id</a>'
2833 loop_
2834 _category_group.id 'inclusive_group'
2835 'diffrn_group'
2836 loop_
2837 _category_examples.detail
2838 _category_examples.case
2839 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
2840 ; Example 1 - based on PDB entry 5HVP and laboratory records for the
2841 structure corresponding to PDB entry 5HVP.
2842 ;
2843 ;
2844 <a href="#_diffrn_detector.diffrn_id" >_diffrn_detector.diffrn_id</a> 'd1'
2845 <a href="#_diffrn_detector.detector" >_diffrn_detector.detector</a> 'multiwire'
2846 <a href="#_diffrn_detector.type" >_diffrn_detector.type</a> 'Siemens'
2847 ;
2848 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
2849 save_
2850
2851
2852 save_<a name="_diffrn_detector.details" >_diffrn_detector.details</a>
2853 _item_description.description
2854 ; A description of special aspects of the radiation detector.
2855 ;
2856 _item.name '<a href="#_diffrn_detector.details" >_diffrn_detector.details</a>'
2857 _item.category_id diffrn_detector
2858 _item.mandatory_code no
2859 _item_aliases.alias_name '_diffrn_detector_details'
2860 _item_aliases.dictionary cif_core.dic
2861 _item_aliases.version 2.0.1
2862 _item_type.code text
2863 _item_examples.case 'slow mode'
2864 save_
2865
2866
2867 save_<a name="_diffrn_detector.detector" >_diffrn_detector.detector</a>
2868 _item_description.description
2869 ; The general class of the radiation detector.
2870 ;
2871 _item.name '<a href="#_diffrn_detector.detector" >_diffrn_detector.detector</a>'
2872 _item.category_id diffrn_detector
2873 _item.mandatory_code no
2874 loop_
2875 _item_aliases.alias_name
2876 _item_aliases.dictionary
2877 _item_aliases.version '_diffrn_radiation_detector'
2878 cifdic.c91
2879 1.0
2880 '_diffrn_detector'
2881 cif_core.dic
2882 2.0
2883 _item_type.code text
2884 loop_
2885 _item_examples.case 'photographic film'
2886 'scintillation counter'
2887 'CCD plate'
2888 'BF~3~ counter'
2889 save_
2890
2891
2892 save_<a name="_diffrn_detector.diffrn_id" >_diffrn_detector.diffrn_id</a>
2893 _item_description.description
2894 ; This data item is a pointer to <a href="#_diffrn.id">_diffrn.id</a> in the DIFFRN
2895 category.
2896
2897 The value of <a href="#_diffrn.id">_diffrn.id</a> uniquely defines a set of
2898 diffraction data.
2899 ;
2900 _item.name '<a href="#_diffrn_detector.diffrn_id" >_diffrn_detector.diffrn_id</a>'
2901 _item.mandatory_code yes
2902 _item_type.code code
2903 save_
2904
2905
2906 save_<a name="_diffrn_detector.dtime" >_diffrn_detector.dtime</a>
2907 _item_description.description
2908 ; The deadtime in microseconds of the detector(s) used to
2909 measure the diffraction intensities.
2910 ;
2911 _item.name '<a href="#_diffrn_detector.dtime" >_diffrn_detector.dtime</a>'
2912 _item.category_id diffrn_detector
2913 _item.mandatory_code no
2914 loop_
2915 _item_aliases.alias_name
2916 _item_aliases.dictionary
2917 _item_aliases.version '_diffrn_radiation_detector_dtime'
2918 cifdic.c91
2919 1.0
2920 '_diffrn_detector_dtime'
2921 cif_core.dic
2922 2.0
2923 loop_
2924 _item_range.maximum
2925 _item_range.minimum . 0.0
2926 0.0 0.0
2927 _item_type.code float
2928 _item_units.code microseconds
2929 save_
2930
2931
2932 save_<a name="_diffrn_detector.id" >_diffrn_detector.id</a>
2933 _item_description.description
2934 ; The value of <a href="#_diffrn_detector.id" >_diffrn_detector.id</a> must uniquely identify
2935 each detector used to collect each diffraction data set.
2936
2937 If the value of <a href="#_diffrn_detector.id" >_diffrn_detector.id</a> is not given, it is
2938 implicitly equal to the value of
2939 <a href="#_diffrn_detector.diffrn_id" >_diffrn_detector.diffrn_id</a>.
2940 ;
2941 loop_
2942 _item.name
2943 _item.category_id
2944 _item.mandatory_code
2945 '<a href="#_diffrn_detector.id" >_diffrn_detector.id</a>' diffrn_detector implicit
2946 '<a href="#_diffrn_detector_axis.detector_id" >_diffrn_detector_axis.detector_id</a>'
2947 diffrn_detector_axis yes
2948 loop_
2949 _item_linked.child_name
2950 _item_linked.parent_name
2951 '<a href="#_diffrn_detector_axis.detector_id" >_diffrn_detector_axis.detector_id</a>'
2952 '_diffrn_detector.id'
2953
2954 _item_type.code code
2955 save_
2956
2957
2958 save_<a name="_diffrn_detector.number_of_axes" >_diffrn_detector.number_of_axes</a>
2959 _item_description.description
2960 ; The value of <a href="#_diffrn_detector.number_of_axes" >_diffrn_detector.number_of_axes</a> gives the
2961 number of axes of the positioner for the detector identified
2962 by <a href="#_diffrn_detector.id" >_diffrn_detector.id</a>.
2963
2964 The word 'positioner' is a general term used in
2965 instrumentation design for devices that are used to change
2966 the positions of portions of apparatus by linear
2967 translation, rotation or combinations of such motions.
2968
2969 Axes which are used to provide a coordinate system for the
2970 face of an area detetctor should not be counted for this
2971 data item.
2972
2973 The description of each axis should be provided by entries
2974 in <a href="#DIFFRN_DETECTOR_AXIS">DIFFRN_DETECTOR_AXIS</a>.
2975 ;
2976 _item.name '<a href="#_diffrn_detector.number_of_axes" >_diffrn_detector.number_of_axes</a>'
2977 _item.category_id diffrn_detector
2978 _item.mandatory_code no
2979 loop_
2980 _item_range.maximum
2981 _item_range.minimum . 1
2982 1 1
2983 _item_type.code int
2984 save_
2985
2986
2987 save_<a name="_diffrn_detector.type" >_diffrn_detector.type</a>
2988 _item_description.description
2989 ; The make, model or name of the detector device used.
2990 ;
2991 _item.name '<a href="#_diffrn_detector.type" >_diffrn_detector.type</a>'
2992 _item.category_id diffrn_detector
2993 _item.mandatory_code no
2994 _item_aliases.alias_name '_diffrn_detector_type'
2995 _item_aliases.dictionary cif_core.dic
2996 _item_aliases.version 2.0.1
2997 _item_type.code text
2998 save_
2999
3000
3001 ########################
3002 # <a name="DIFFRN_DETECTOR_AXIS" >DIFFRN_DETECTOR_AXIS</a> #
3003 ########################
3004
3005
3006 save_DIFFRN_DETECTOR_AXIS
3007 _category.description
3008 ; Data items in the <a href="#DIFFRN_DETECTOR_AXIS">DIFFRN_DETECTOR_AXIS</a> category associate
3009 axes with detectors.
3010 ;
3011 _category.id diffrn_detector_axis
3012 _category.mandatory_code no
3013 loop_
3014 _category_key.name '<a href="#_diffrn_detector_axis.detector_id" >_diffrn_detector_axis.detector_id</a>'
3015 '_diffrn_detector_axis.axis_id'
3016 loop_
3017 _category_group.id 'inclusive_group'
3018 'diffrn_group'
3019 save_
3020
3021
3022 save_<a name="_diffrn_detector_axis.axis_id" >_diffrn_detector_axis.axis_id</a>
3023 _item_description.description
3024 ; This data item is a pointer to <a href="#_axis.id" >_axis.id</a> in
3025 the AXIS category.
3026 ;
3027 _item.name '<a href="#_diffrn_detector_axis.axis_id">_diffrn_detector_axis.axis_id</a>'
3028 _item.category_id diffrn_detector_axis
3029 _item.mandatory_code yes
3030 _item_type.code code
3031 save_
3032
3033
3034 save_<a name="_diffrn_detector_axis.detector_id" >_diffrn_detector_axis.detector_id</a>
3035 _item_description.description
3036 ; This data item is a pointer to <a href="#_diffrn_detector.id" >_diffrn_detector.id</a> in
3037 the <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a> category.
3038
3039 This item was previously named _diffrn_detector_axis.id
3040 which is now a deprecated name. The old name is
3041 provided as an alias but should not be used for new work.
3042 ;
3043 _item.name '<a href="#_diffrn_detector_axis.detector_id" >_diffrn_detector_axis.detector_id</a>'
3044 _item.category_id diffrn_detector_axis
3045 _item.mandatory_code yes
3046 _item_aliases.alias_name '_diffrn_detector_axis.id'
3047 _item_aliases.dictionary cif_img.dic
3048 _item_aliases.version 1.0
3049 _item_type.code code
3050 save_
3051
3052
3053 ###########################
3054 # <a name="DIFFRN_DETECTOR_ELEMENT">DIFFRN_DETECTOR_ELEMENT</a> #
3055 ###########################
3056
3057
3058 save_DIFFRN_DETECTOR_ELEMENT
3059 _category.description
3060 ; Data items in the <a href="#DIFFRN_DETECTOR_ELEMENT">DIFFRN_DETECTOR_ELEMENT</a> category record
3061 the details about spatial layout and other characteristics
3062 of each element of a detector which may have multiple elements.
3063
3064 In most cases, giving more detailed information
3065 in <a href="#ARRAY_STRUCTURE_LIST">ARRAY_STRUCTURE_LIST</a> and <a href="#ARRAY_STRUCTURE_LIST_AXIS">ARRAY_STRUCTURE_LIST_AXIS</a>
3066 is preferable to simply providing the centre of the
3067 detector element.
3068 ;
3069 _category.id diffrn_detector_element
3070 _category.mandatory_code no
3071 loop_
3072 _category_key.name '<a href="#_diffrn_detector_element.id" >_diffrn_detector_element.id</a>'
3073 '<a href="#_diffrn_detector_element.detector_id" >_diffrn_detector_element.detector_id</a>'
3074 loop_
3075 _category_group.id 'inclusive_group'
3076 'array_data_group'
3077 loop_
3078 _category_examples.detail
3079 _category_examples.case
3080 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
3081 ; Example 1 - Detector d1 is composed of four CCD detector elements,
3082 each 200 mm by 200 mm, arranged in a square, in the pattern
3083
3084 1 2
3085 *
3086 3 4
3087
3088 Note that the beam centre is slightly displaced from each of the
3089 detector elements, just beyond the lower right corner of 1,
3090 the lower left corner of 2, the upper right corner of 3 and
3091 the upper left corner of 4. For each element, the detector
3092 face coordiate system, is assumed to have the fast axis
3093 running from left to right and the slow axis running from
3094 top to bottom with the origin at the top left corner.
3095 ;
3096 ;
3097 loop_
3098 <a href="#_diffrn_detector_element.detector_id" >_diffrn_detector_element.detector_id</a>
3099 <a href="#_diffrn_detector_element.id" >_diffrn_detector_element.id</a>
3100 <a href="#_diffrn_data_frame.center_fast" >_diffrn_detector_element.reference_center_fast</a>
3101 <a href="#_diffrn_detector_element.reference_center_slow" >_diffrn_detector_element.reference_center_slow</a>
3102 <a href="#_diffrn_detector_element.reference_center_units" >_diffrn_detector_element.reference_center_units</a>
3103 d1 d1_ccd_1 201.5 201.5 mm
3104 d1 d1_ccd_2 -1.8 201.5 mm
3105 d1 d1_ccd_3 201.6 -1.4 mm
3106 d1 d1_ccd_4 -1.7 -1.5 mm
3107 ;
3108 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
3109 save_
3110
3111
3112
3113 save_<a name="_diffrn_detector_element.id" >_diffrn_detector_element.id</a>
3114 _item_description.description
3115 ; The value of <a href="#_diffrn_detector_element.id" >_diffrn_detector_element.id</a> must uniquely
3116 identify each element of a detector.
3117 ;
3118 loop_
3119 _item.name
3120 _item.category_id
3121 _item.mandatory_code
3122 '<a href="#_diffrn_detector_element.id" >_diffrn_detector_element.id</a>'
3123 diffrn_detector_element
3124 yes
3125 _item_type.code code
3126 loop_
3127 _item_linked.child_name
3128 _item_linked.parent_name
3129 '<a href="#_diffrn_data_frame.detector_element_id" >_diffrn_data_frame.detector_element_id</a>'
3130 '<a href="#_diffrn_detector_element.id" >_diffrn_detector_element.id</a>'
3131
3132 save_
3133
3134
3135 save_<a name="_diffrn_detector_element.detector_id" >_diffrn_detector_element.detector_id</a>
3136 _item_description.description
3137 ; This item is a pointer to <a href="#_diffrn_detector.id" >_diffrn_detector.id</a>
3138 in the <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a> category.
3139 ;
3140 _item.name '<a href="#_diffrn_detector_element.detector_id" >_diffrn_detector_element.detector_id</a>'
3141 _item.category_id diffrn_detector_element
3142 _item.mandatory_code yes
3143 _item_type.code code
3144 save_
3145
3146 save_<a name="_diffrn_detector_element.reference_center_fast">_diffrn_detector_element.reference_center_fast</a>
3147 _item_description.description
3148 ; The value of <a href="#_diffrn_detector_element.reference_center_fast">_diffrn_detector_element.reference_center_fast</a> is
3149 the fast index axis beam center position relative to the detector
3150 element face in the units specified in the data item
3151 '<a href="#_diffrn_detector_element.reference_center_units">_diffrn_detector_element.reference_center_units</a>' along the fast
3152 axis of the detector from the center of the first pixel to
3153 the point at which the Z-axis (which should be colinear with the
3154 beam) intersects the face of the detector, if in fact is does.
3155 At the time of the measurement all settings of the detector
3156 positioner should be at their reference settings. If more than
3157 one reference setting has been used the value given whould be
3158 representive of the beam center as determined from the ensemble
3159 of settings.
3160
3161 It is important to note that for measurements in millimetres,
3162 the sense of the axis is used, rather than the sign of the
3163 pixel-to-pixel increments.
3164
3165 ;
3166 _item.name '<a href="#_diffrn_detector_element.reference_center_fast">_diffrn_detector_element.reference_center_fast</a>'
3167 _item.category_id diffrn_detector_element
3168 _item.mandatory_code no
3169 _item_type.code float
3170
3171 save_
3172
3173
3174 save_<a name="_diffrn_detector_element.reference_center_slow">_diffrn_detector_element.reference_center_slow</a>
3175 _item_description.description
3176 ; The value of <a href="#_diffrn_detector_element.reference_center_slow">_diffrn_detector_element.reference_center_slow</a> is
3177 the slow index axis beam center position relative to the detector
3178 element face in the units specified in the data item
3179 '<a href="#_diffrn_detector_element.reference_center_units">_diffrn_detector_element.reference_center_units</a>' along the slow
3180 axis of the detector from the center of the first pixel to
3181 the point at which the Z-axis (which should be colinear with the
3182 beam) intersects the face of the detector, if in fact is does.
3183 At the time of the measurement all settings of the detector
3184 positioner should be at their reference settings. If more than
3185 one reference setting has been used the value givien whould be
3186 representive of the beam center as determined from the ensemble
3187 of settings.
3188
3189 It is important to note that the sense of the axis is used,
3190 rather than the sign of the pixel-to-pixel increments.
3191
3192 ;
3193 _item.name '<a href="#_diffrn_detector_element.reference_center_slow">_diffrn_detector_element.reference_center_slow</a>'
3194 _item.category_id diffrn_detector_element
3195 _item.mandatory_code no
3196 _item_type.code float
3197
3198 save_
3199
3200
3201 save_<a name="_diffrn_detector_element.reference_center_units">_diffrn_detector_element.reference_center_units</a>
3202 _item_description.description
3203 ; The value of <a href="#_diffrn_detector_element.reference_center_units">_diffrn_detector_element.reference_center_units</a>
3204 specifies the units in which the values of
3205 '<a href="#_diffrn_detector_element.reference_center_fast">_diffrn_detector_element.reference_center_fast</a>' and
3206 '<a href="#_diffrn_detector_element.reference_center_slow">_diffrn_detector_element.reference_center_slow</a>'
3207 are presented. The default is 'mm' for millimetres. The
3208 alternatives are 'pixels' and 'bins'. In all cases the
3209 center distances are measured from the center of the
3210 first pixel, i.e. in a 2x2 binning, the measuring origin
3211 is offset from the centers of the bins by one half pixel
3212 towards the first pixel.
3213
3214 If 'bins' is specified, the data in
3215 '<a href="#_array_intensities.pixel_fast_bin_size" >_array_intensities.pixel_fast_bin_size</a>',
3216 '<a href="#_array_intensities.pixel_slow_bin_size" >_array_intensities.pixel_slow_bin_size</a>', and
3217 '<a href="#_array_intensities.pixel_binning_method" >_array_intensities.pixel_binning_method</a>'
3218 is used to define the binning scheme.
3219
3220
3221 ;
3222 _item.name '<a href="#_diffrn_detector_element.reference_center_units">_diffrn_detector_element.reference_center_units</a>'
3223 _item.category_id diffrn_detector_element
3224 _item.mandatory_code no
3225 _item_type.code code
3226 loop_
3227 _item_enumeration.value
3228 _item_enumeration.detail
3229 mm 'millimetres'
3230 pixels 'detector pixels'
3231 bins 'detector bins'
3232
3233 save_
3234
3235
3236 ########################
3237 ## <a name="DIFFRN_MEASUREMENT" >DIFFRN_MEASUREMENT</a> ##
3238 ########################
3239
3240
3241 save_DIFFRN_MEASUREMENT
3242 _category.description
3243 ; Data items in the <a href="#DIFFRN_MEASUREMENT">DIFFRN_MEASUREMENT</a> category record details
3244 about the device used to orient and/or position the crystal
3245 during data measurement and the manner in which the
3246 diffraction data were measured.
3247 ;
3248 _category.id diffrn_measurement
3249 _category.mandatory_code no
3250 loop_
3251 _category_key.name '<a href="#_diffrn_measurement.device" >_diffrn_measurement.device</a>'
3252 '<a href="#_diffrn_measurement.diffrn_id" >_diffrn_measurement.diffrn_id</a>'
3253 '<a href="#_diffrn_measurement.id" >_diffrn_measurement.id</a>'
3254 loop_
3255 _category_group.id 'inclusive_group'
3256 'diffrn_group'
3257 loop_
3258 _category_examples.detail
3259 _category_examples.case
3260 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
3261 ; Example 1 - based on PDB entry 5HVP and laboratory records for the
3262 structure corresponding to PDB entry 5HVP
3263 ;
3264 ;
3265 <a href="#_diffrn_measurement.diffrn_id" >_diffrn_measurement.diffrn_id</a> 'd1'
3266 <a href="#_diffrn_measurement.device" >_diffrn_measurement.device</a> '3-circle camera'
3267 <a href="#_diffrn_measurement.device_type" >_diffrn_measurement.device_type</a> 'Supper model <b>X</b>'
3268 <a href="#_diffrn_measurement.device_details" >_diffrn_measurement.device_details</a> 'none'
3269 <a href="#_diffrn_measurement.method" >_diffrn_measurement.method</a> 'omega scan'
3270 <a href="#_diffrn_measurement.details" >_diffrn_measurement.details</a>
3271 ; 440 frames, 0.20 degrees, 150 sec, detector distance 12 cm, detector
3272 angle 22.5 degrees
3273 ;
3274 ;
3275 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
3276 ; Example 2 - based on data set TOZ of Willis, Beckwith & Tozer
3277 [Acta Cryst. (1991), C47, 2276-2277].
3278 ;
3279 ;
3280 <a href="#_diffrn_measurement.diffrn_id" >_diffrn_measurement.diffrn_id</a> 's1'
3281 <a href="#_diffrn_measurement.device_type" >_diffrn_measurement.device_type</a> 'Philips PW1100/20 diffractometer'
3282 <a href="#_diffrn_measurement.method" >_diffrn_measurement.method</a> 'theta/2theta (\q/2\q)'
3283 ;
3284 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
3285 save_
3286
3287
3288 save_<a name="_diffrn_measurement.device" >_diffrn_measurement.device</a>
3289 _item_description.description
3290 ; The general class of goniometer or device used to support
3291 and orient the specimen.
3292
3293 If the value of <a href="#_diffrn_measurement.device">_diffrn_measurement.device</a> is not given,
3294 it is implicitly equal to the value of
3295 <a href="#_diffrn_measurement.diffrn_id">_diffrn_measurement.diffrn_id</a>.
3296
3297 Either <a href="#_diffrn_measurement.device">_diffrn_measurement.device</a> or
3298 <a href="#_diffrn_measurement.id">_diffrn_measurement.id</a> may be used to link to other
3299 categories. If the experimental setup admits multiple
3300 devices, then <a href="#_diffrn_measurement.id">_diffrn_measurement.id</a> is used to provide
3301 a unique link.
3302 ;
3303 loop_
3304 _item.name
3305 _item.category_id
3306 _item.mandatory_code
3307 '<a href="#_diffrn_measurement.device">_diffrn_measurement.device</a>' diffrn_measurement implicit
3308 '<a href="#_diffrn_measurement_axis.measurement_device">_diffrn_measurement_axis.measurement_device</a>'
3309 diffrn_measurement_axis implicit
3310 loop_
3311 _item_linked.child_name
3312 _item_linked.parent_name
3313 '<a href="#_diffrn_measurement_axis.measurement_device">_diffrn_measurement_axis.measurement_device</a>'
3314 '_diffrn_measurement.device'
3315 _item_aliases.alias_name '_diffrn_measurement_device'
3316 _item_aliases.dictionary cif_core.dic
3317 _item_aliases.version 2.0.1
3318 _item_type.code text
3319 loop_
3320 _item_examples.case '3-circle camera'
3321 '4-circle camera'
3322 'kappa-geometry camera'
3323 'oscillation camera'
3324 'precession camera'
3325 save_
3326
3327
3328 save_<a name="_diffrn_measurement.device_details" >_diffrn_measurement.device_details</a>
3329 _item_description.description
3330 ; A description of special aspects of the device used to
3331 measure the diffraction intensities.
3332 ;
3333 _item.name '<a href="#_diffrn_measurement.device_details" >_diffrn_measurement.device_details</a>'
3334 _item.category_id diffrn_measurement
3335 _item.mandatory_code no
3336 _item_aliases.alias_name '_diffrn_measurement_device_details'
3337 _item_aliases.dictionary cif_core.dic
3338 _item_aliases.version 2.0.1
3339 _item_type.code text
3340 _item_examples.case
3341 ; commercial goniometer modified locally to
3342 allow for 90\% \t arc
3343 ;
3344 save_
3345
3346
3347 save_<a name="_diffrn_measurement.device_type" >_diffrn_measurement.device_type</a>
3348 _item_description.description
3349 ; The make, model or name of the measurement device
3350 (goniometer) used.
3351 ;
3352 _item.name '<a href="#_diffrn_measurement.device_type" >_diffrn_measurement.device_type</a>'
3353 _item.category_id diffrn_measurement
3354 _item.mandatory_code no
3355 _item_aliases.alias_name '_diffrn_measurement_device_type'
3356 _item_aliases.dictionary cif_core.dic
3357 _item_aliases.version 2.0.1
3358 _item_type.code text
3359 loop_
3360 _item_examples.case 'Supper model q'
3361 'Huber model r'
3362 'Enraf-Nonius model s'
3363 'home-made'
3364 save_
3365
3366
3367 save_<a name="_diffrn_measurement.diffrn_id" >_diffrn_measurement.diffrn_id</a>
3368 _item_description.description
3369 ; This data item is a pointer to <a href="#_diffrn.id">_diffrn.id</a> in the DIFFRN
3370 category.
3371 ;
3372 _item.name '<a href="#_diffrn_measurement.diffrn_id" >_diffrn_measurement.diffrn_id</a>'
3373 _item.mandatory_code yes
3374 _item_type.code code
3375 save_
3376
3377
3378 save_<a name="_diffrn_measurement.details" >_diffrn_measurement.details</a>
3379 _item_description.description
3380 ; A description of special aspects of the intensity
3381 measurement.
3382 ;
3383 _item.name '<a href="#_diffrn_measurement.details" >_diffrn_measurement.details</a>'
3384 _item.category_id diffrn_measurement
3385 _item.mandatory_code no
3386 _item_aliases.alias_name '_diffrn_measurement_details'
3387 _item_aliases.dictionary cif_core.dic
3388 _item_aliases.version 2.0.1
3389 _item_type.code text
3390 _item_examples.case
3391 ; 440 frames, 0.20 degrees, 150 sec, detector
3392 distance 12 cm, detector angle 22.5 degrees
3393 ;
3394 save_
3395
3396
3397 save_<a name="_diffrn_measurement.id" >_diffrn_measurement.id</a>
3398 _item_description.description
3399 ; The value of <a href="#_diffrn_measurement.id" >_diffrn_measurement.id</a> must uniquely identify
3400 the set of mechanical characteristics of the device used to
3401 orient and/or position the sample used during the collection
3402 of each diffraction data set.
3403
3404 If the value of <a href="#_diffrn_measurement.id" >_diffrn_measurement.id</a> is not given, it is
3405 implicitly equal to the value of
3406 <a href="#_diffrn_measurement.diffrn_id" >_diffrn_measurement.diffrn_id</a>.
3407
3408 Either <a href="#_diffrn_measurement.device">_diffrn_measurement.device</a> or
3409 <a href="#_diffrn_measurement.id">_diffrn_measurement.id</a> may be used to link to other
3410 categories. If the experimental setup admits multiple
3411 devices, then <a href="#_diffrn_measurement.id">_diffrn_measurement.id</a> is used to provide
3412 a unique link.
3413 ;
3414 loop_
3415 _item.name
3416 _item.category_id
3417 _item.mandatory_code
3418 '<a href="#_diffrn_measurement.id" >_diffrn_measurement.id</a>' diffrn_measurement implicit
3419 '<a href="#_diffrn_measurement_axis.measurement_id" >_diffrn_measurement_axis.measurement_id</a>'
3420 diffrn_measurement_axis implicit
3421 loop_
3422 _item_linked.child_name
3423 _item_linked.parent_name
3424 '<a href="#_diffrn_measurement_axis.measurement_id" >_diffrn_measurement_axis.measurement_id</a>'
3425 '<a href="#_diffrn_measurement.id" >_diffrn_measurement.id</a>'
3426
3427 _item_type.code code
3428 save_
3429
3430
3431 save_<a name="_diffrn_measurement.method" >_diffrn_measurement.method</a>
3432 _item_description.description
3433 ; Method used to measure intensities.
3434 ;
3435 _item.name '<a href="#_diffrn_measurement.method" >_diffrn_measurement.method</a>'
3436 _item.category_id diffrn_measurement
3437 _item.mandatory_code no
3438 _item_aliases.alias_name '_diffrn_measurement_method'
3439 _item_aliases.dictionary cif_core.dic
3440 _item_aliases.version 2.0.1
3441 _item_type.code text
3442 _item_examples.case
3443 'profile data from theta/2theta (\q/2\q) scans'
3444 save_
3445
3446
3447 save_<a name="_diffrn_measurement.number_of_axes" >_diffrn_measurement.number_of_axes</a>
3448 _item_description.description
3449 ; The value of <a href="#_diffrn_measurement.number_of_axes" >_diffrn_measurement.number_of_axes</a> gives the
3450 number of axes of the positioner for the goniometer or
3451 other sample orientation or positioning device identified
3452 by <a href="#_diffrn_measurement.id" >_diffrn_measurement.id</a>.
3453
3454 The description of the axes should be provided by entries in
3455 <a href="#DIFFRN_MEASUREMENT_AXIS">DIFFRN_MEASUREMENT_AXIS</a>.
3456 ;
3457 _item.name '<a href="#_diffrn_measurement.number_of_axes" >_diffrn_measurement.number_of_axes</a>'
3458 _item.category_id diffrn_measurement
3459 _item.mandatory_code no
3460 loop_
3461 _item_range.maximum
3462 _item_range.minimum . 1
3463 1 1
3464 _item_type.code int
3465 save_
3466
3467
3468 # <a href="#_diffrn_measurement.sample_detector_distance" >_diffrn_measurement.sample_detector_distance</a>
3469 # <a href="#_diffrn_measurement.sample_detector_voffset" >_diffrn_measurement.sample_detector_voffset</a>
3470
3471 save_<a name="_diffrn_measurement.sample_detector_distance" >_diffrn_measurement.sample_detector_distance</a>
3472 _item_description.description
3473 ; The value of <a href="#_diffrn_measurement.sample_detector_distance" >_diffrn_measurement.sample_detector_distance</a> gives
3474 the unsigned distance in millimetres from the sample to the
3475 detector along the beam.
3476 ;
3477 _item.name '<a href="#_diffrn_measurement.sample_detector_distance" >_diffrn_measurement.sample_detector_distance</a>'
3478 _item.category_id diffrn_measurement
3479 _item.mandatory_code no
3480 loop_
3481 _item_range.maximum
3482 _item_range.minimum . 0.0
3483 _item_type.code float
3484 _item_units.code mm
3485 save_
3486
3487 save_<a name="_diffrn_measurement.sample_detector_voffset" >_diffrn_measurement.sample_detector_voffset</a>
3488 _item_description.description
3489 ; The value of <a href="#_diffrn_measurement.sample_detector_voffset" >_diffrn_measurement.sample_detector_voffset</a> gives
3490 the signed distance in millimetres in the vertical
3491 direction (positive for up) from the center of
3492 the beam to the center of the detector.
3493 ;
3494 _item.name '<a href="#_diffrn_measurement.sample_detector_voffset" >_diffrn_measurement.sample_detector_voffset</a>'
3495 _item.category_id diffrn_measurement
3496 _item.mandatory_code no
3497 loop_
3498 _item_range.maximum
3499 _item_range.minimum . .
3500 . .
3501 _item_type.code float
3502 _item_units.code mm
3503 save_
3504
3505
3506 save_<a name="_diffrn_measurement.specimen_support" >_diffrn_measurement.specimen_support</a>
3507 _item_description.description
3508 ; The physical device used to support the crystal during data
3509 collection.
3510 ;
3511 _item.name '<a href="#_diffrn_measurement.specimen_support" >_diffrn_measurement.specimen_support</a>'
3512 _item.category_id diffrn_measurement
3513 _item.mandatory_code no
3514 _item_aliases.alias_name '_diffrn_measurement_specimen_support'
3515 _item_aliases.dictionary cif_core.dic
3516 _item_aliases.version 2.0.1
3517 _item_type.code text
3518 loop_
3519 _item_examples.case 'glass capillary'
3520 'quartz capillary'
3521 'fiber'
3522 'metal loop'
3523 save_
3524
3525
3526 ###########################
3527 # <a name="DIFFRN_MEASUREMENT_AXIS">DIFFRN_MEASUREMENT_AXIS</a> #
3528 ###########################
3529
3530
3531 save_DIFFRN_MEASUREMENT_AXIS
3532 _category.description
3533 ; Data items in the <a href="#DIFFRN_MEASUREMENT_AXIS">DIFFRN_MEASUREMENT_AXIS</a> category associate
3534 axes with goniometers.
3535 ;
3536 _category.id diffrn_measurement_axis
3537 _category.mandatory_code no
3538 loop_
3539 _category_key.name
3540 '<a href="#_diffrn_measurement_axis.measurement_device" >_diffrn_measurement_axis.measurement_device</a>'
3541 '<a href="#_diffrn_measurement_axis.measurement_id" >_diffrn_measurement_axis.measurement_id</a>'
3542 '<a href="#_diffrn_measurement_axis.axis_id" >_diffrn_measurement_axis.axis_id</a>'
3543 loop_
3544 _category_group.id 'inclusive_group'
3545 'diffrn_group'
3546 save_
3547
3548
3549 save_<a name="_diffrn_measurement_axis.axis_id" >_diffrn_measurement_axis.axis_id</a>
3550 _item_description.description
3551 ; This data item is a pointer to <a href="#_axis.id" >_axis.id</a> in
3552 the <a href="#AXIS">AXIS</a> category.
3553 ;
3554 _item.name '<a href="#_diffrn_measurement_axis.axis_id" >_diffrn_measurement_axis.axis_id</a>'
3555 _item.category_id diffrn_measurement_axis
3556 _item.mandatory_code yes
3557 _item_type.code code
3558 save_
3559
3560
3561 save_<A name="_diffrn_measurement_axis.measurement_device">_diffrn_measurement_axis.measurement_device</a>
3562 _item_description.description
3563 ; This data item is a pointer to <a href="#_diffrn_measurement.device">_diffrn_measurement.device</a>
3564 in the <a href="#DIFFRN_MEASUREMENT">DIFFRN_MEASUREMENT</a> category.
3565 ;
3566 _item.name
3567 '<a href="#_diffrn_measurement_axis.measurement_device">_diffrn_measurement_axis.measurement_device</a>'
3568 _item.category_id diffrn_measurement_axis
3569 _item.mandatory_code implicit
3570 _item_type.code text
3571 save_
3572
3573
3574 save_<a name="_diffrn_measurement_axis.measurement_id">_diffrn_measurement_axis.measurement_id</a>
3575 _item_description.description
3576 ; This data item is a pointer to <a href="#_diffrn_measurement.id">_diffrn_measurement.id</a> in
3577 the <a href="#DIFFRN_MEASUREMENT">DIFFRN_MEASUREMENT</a> category.
3578
3579 This item was previously named _diffrn_measurement_axis.id,
3580 which is now a deprecated name. The old name is
3581 provided as an alias but should not be used for new work.
3582 ;
3583 _item.name '<a href="#_diffrn_measurement_axis.measurement_id">_diffrn_measurement_axis.measurement_id</a>'
3584 _item.category_id diffrn_measurement_axis
3585 _item.mandatory_code implicit
3586 _item_aliases.alias_name '_diffrn_measurement_axis.id'
3587 _item_aliases.dictionary cif_img.dic
3588 _item_aliases.version 1.0
3589 _item_type.code code
3590 save_
3591
3592
3593 ####################
3594 # <a name="DIFFRN_RADIATION">DIFFRN_RADIATION</a> #
3595 ####################
3596
3597
3598 save_DIFFRN_RADIATION
3599 _category.description
3600 ; Data items in the <a href="#DIFFRN_RADIATION">DIFFRN_RADIATION</a> category describe
3601 the radiation used for measuring diffraction intensities,
3602 its collimation and monochromatization before the sample.
3603
3604 Post-sample treatment of the beam is described by data
3605 items in the <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a> category.
3606 ;
3607 _category.id diffrn_radiation
3608 _category.mandatory_code no
3609 _category_key.name '<a href="#_diffrn_radiation.diffrn_id">_diffrn_radiation.diffrn_id</a>'
3610 loop_
3611 _category_group.id 'inclusive_group'
3612 'diffrn_group'
3613 loop_
3614 _category_examples.detail
3615 _category_examples.case
3616 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
3617 ; Example 1 - based on PDB entry 5HVP and laboratory records for the
3618 structure corresponding to PDB entry 5HVP
3619 ;
3620 ;
3621 <a href="#_diffrn_radiation.diffrn_id">_diffrn_radiation.diffrn_id</a> 'set1'
3622
3623 <a href="#_diffrn_radiation.collimation">_diffrn_radiation.collimation</a> '0.3 mm double pinhole'
3624 <a href="#_diffrn_radiation.monochromator">_diffrn_radiation.monochromator</a> 'graphite'
3625 <a href="#_diffrn_radiation.type">_diffrn_radiation.type</a> 'Cu K\a'
3626 <a href="#_diffrn_radiation.wavelength_id">_diffrn_radiation.wavelength_id</a> 1
3627 ;
3628 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
3629 ; Example 2 - based on data set TOZ of Willis, Beckwith & Tozer
3630 [Acta Cryst. (1991), C47, 2276-2277].
3631 ;
3632 ;
3633 <a href="#_diffrn_radiation.wavelength_id">_diffrn_radiation.wavelength_id</a> 1
3634 <a href="#_diffrn_radiation.type">_diffrn_radiation.type</a> 'Cu K\a'
3635 <a href="#_diffrn_radiation.monochromator">_diffrn_radiation.monochromator</a> 'graphite'
3636 ;
3637 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
3638 save_
3639
3640 save_<A name="_diffrn_radiation.collimation">_diffrn_radiation.collimation</a>
3641 _item_description.description
3642 ; The collimation or focusing applied to the radiation.
3643 ;
3644 _item.name '<a href="#_diffrn_radiation.collimation">_diffrn_radiation.collimation</a>'
3645 _item.category_id diffrn_radiation
3646 _item.mandatory_code no
3647 _item_aliases.alias_name '_diffrn_radiation_collimation'
3648 _item_aliases.dictionary cif_core.dic
3649 _item_aliases.version 2.0.1
3650 _item_type.code text
3651 loop_
3652 _item_examples.case '0.3 mm double-pinhole'
3653 '0.5 mm'
3654 'focusing mirrors'
3655 save_
3656
3657
3658 save_<A name="_diffrn_radiation.diffrn_id">_diffrn_radiation.diffrn_id</a>
3659 _item_description.description
3660 ; This data item is a pointer to <a href="#_diffrn.id">_diffrn.id</a> in the DIFFRN
3661 category.
3662 ;
3663 _item.name '<a href="#_diffrn_radiation.diffrn_id">_diffrn_radiation.diffrn_id</a>'
3664 _item.mandatory_code yes
3665 _item_type.code code
3666 save_
3667
3668
3669
3670 save_<a name="_diffrn_radiation.div_x_source">_diffrn_radiation.div_x_source</a>
3671 _item_description.description
3672 ; Beam crossfire in degrees parallel to the laboratory <b>X</b> axis
3673 (see <a href="#AXIS">AXIS</a> category).
3674
3675 This is a characteristic of the X-ray beam as it illuminates
3676 the sample (or specimen) after all monochromation and
3677 collimation.
3678
3679 This is the standard uncertainty (e.s.d.) of the directions of
3680 photons in the XZ plane around the mean source beam
3681 direction.
3682
3683 Note that for some synchrotrons this value is specified
3684 in milliradians, in which case a conversion is needed.
3685 To convert a value in milliradians to a value in degrees,
3686 multiply by 0.180 and divide by \p.
3687 ;
3688 _item.name '<a href="#_diffrn_radiation.div_x_source">_diffrn_radiation.div_x_source</a>'
3689 _item.category_id diffrn_radiation
3690 _item.mandatory_code no
3691 _item_type.code float
3692 _item_units.code degrees
3693 save_
3694
3695
3696 save_<A name="_diffrn_radiation.div_y_source">_diffrn_radiation.div_y_source</a>
3697 _item_description.description
3698 ; Beam crossfire in degrees parallel to the laboratory <b>Y</b> axis
3699 (see <a href="#AXIS">AXIS</a> category).
3700
3701 This is a characteristic of the X-ray beam as it illuminates
3702 the sample (or specimen) after all monochromation and
3703 collimation.
3704
3705 This is the standard uncertainty (e.s.d.) of the directions
3706 of photons in the YZ plane around the mean source beam
3707 direction.
3708
3709 Note that for some synchrotrons this value is specified
3710 in milliradians, in which case a conversion is needed.
3711 To convert a value in milliradians to a value in degrees,
3712 multiply by 0.180 and divide by \p.
3713 ;
3714 _item.name '<a href="#_diffrn_radiation.div_y_source">_diffrn_radiation.div_y_source</a>'
3715 _item.category_id diffrn_radiation
3716 _item.mandatory_code no
3717 _item_type.code float
3718 _item_units.code degrees
3719 _item_default.value 0.0
3720 save_
3721
3722
3723 save_<A name="_diffrn_radiation.div_x_y_source">_diffrn_radiation.div_x_y_source</a>
3724 _item_description.description
3725 ; Beam crossfire correlation degrees^<sup>2</sup>^ between the
3726 crossfire laboratory <b>X</b>-axis component and the crossfire
3727 laboratory <b>Y</b>-axis component (see <a href="#AXIS">AXIS</a> category).
3728
3729 This is a characteristic of the X-ray beam as it illuminates
3730 the sample (or specimen) after all monochromation and
3731 collimation.
3732
3733 This is the mean of the products of the deviations of the
3734 direction of each photon in XZ plane times the deviations
3735 of the direction of the same photon in the YZ plane
3736 around the mean source beam direction. This will be zero
3737 for uncorrelated crossfire.
3738
3739 Note that some synchrotrons, this value is specified in
3740 milliradians^<sup>2</sup>^, in which case a conversion would be needed.
3741 To go from a value in milliradians^<sup>2</sup>^ to a value in
3742 degrees^<sup>2</sup>^, multiply by 0.180^<sup>2</sup>^ and divide by \p^<sup>2</sup>^.
3743
3744 ;
3745 _item.name '<a href="#_diffrn_radiation.div_x_y_source">_diffrn_radiation.div_x_y_source</a>'
3746 _item.category_id diffrn_radiation
3747 _item.mandatory_code no
3748 _item_type.code float
3749 _item_units.code degrees_squared
3750 _item_default.value 0.0
3751 save_
3752
3753 save_<A name="_diffrn_radiation.filter_edge">_diffrn_radiation.filter_edge</a>
3754 _item_description.description
3755 ; Absorption edge in \%Angstroms of the radiation filter used.
3756 ;
3757 _item.name '<a href="#_diffrn_radiation.filter_edge">_diffrn_radiation.filter_edge</a>'
3758 _item.category_id diffrn_radiation
3759 _item.mandatory_code no
3760 _item_aliases.alias_name '_diffrn_radiation_filter_edge'
3761 _item_aliases.dictionary cif_core.dic
3762 _item_aliases.version 2.0.1
3763 loop_
3764 _item_range.maximum
3765 _item_range.minimum . 0.0
3766 0.0 0.0
3767 _item_type.code float
3768 _item_units.code angstroms
3769 save_
3770
3771 save_<A name="_diffrn_radiation.inhomogeneity">_diffrn_radiation.inhomogeneity</a>
3772 _item_description.description
3773 ; Half-width in millimetres of the incident beam in the
3774 direction perpendicular to the diffraction plane.
3775 ;
3776 _item.name '<a href="#_diffrn_radiation.inhomogeneity">_diffrn_radiation.inhomogeneity</a>'
3777 _item.category_id diffrn_radiation
3778 _item.mandatory_code no
3779 _item_aliases.alias_name '_diffrn_radiation_inhomogeneity'
3780 _item_aliases.dictionary cif_core.dic
3781 _item_aliases.version 2.0.1
3782 loop_
3783 _item_range.maximum
3784 _item_range.minimum . 0.0
3785 0.0 0.0
3786 _item_type.code float
3787 _item_units.code millimetres
3788 save_
3789
3790 save_<A name="_diffrn_radiation.monochromator">_diffrn_radiation.monochromator</a>
3791 _item_description.description
3792 ; The method used to obtain monochromatic radiation. If a
3793 monochromator crystal is used, the material and the
3794 indices of the Bragg reflection are specified.
3795 ;
3796 _item.name '<a href="#_diffrn_radiation.monochromator">_diffrn_radiation.monochromator</a>'
3797 _item.category_id diffrn_radiation
3798 _item.mandatory_code no
3799 _item_aliases.alias_name '_diffrn_radiation_monochromator'
3800 _item_aliases.dictionary cif_core.dic
3801 _item_aliases.version 2.0.1
3802 _item_type.code text
3803 loop_
3804 _item_examples.case 'Zr filter'
3805 'Ge 220'
3806 'none'
3807 'equatorial mounted graphite'
3808 save_
3809
3810 save_<A name="_diffrn_radiation.polarisn_norm">_diffrn_radiation.polarisn_norm</a>
3811 _item_description.description
3812 ; The angle in degrees, as viewed from the specimen, between the
3813 perpendicular component of the polarization and the diffraction
3814 plane. See _diffrn_radiation_polarisn_ratio.
3815 ;
3816 _item.name '<a href="#_diffrn_radiation.polarisn_norm">_diffrn_radiation.polarisn_norm</a>'
3817 _item.category_id diffrn_radiation
3818 _item.mandatory_code no
3819 _item_aliases.alias_name '_diffrn_radiation_polarisn_norm'
3820 _item_aliases.dictionary cif_core.dic
3821 _item_aliases.version 2.0.1
3822 loop_
3823 _item_range.maximum
3824 _item_range.minimum 90.0 90.0
3825 90.0 -90.0
3826 -90.0 -90.0
3827 _item_type.code float
3828 _item_units.code degrees
3829 save_
3830
3831 save_<A name="_diffrn_radiation.polarisn_ratio">_diffrn_radiation.polarisn_ratio</a>
3832 _item_description.description
3833 ; Polarization ratio of the diffraction beam incident on the
3834 crystal. This is the ratio of the perpendicularly polarized to
3835 the parallel polarized component of the radiation. The
3836 perpendicular component forms an angle of
3837 <a href="#_diffrn_radiation.polarisn_norm">_diffrn_radiation.polarisn_norm</a> to the normal to the
3838 diffraction plane of the sample (i.e. the plane containing
3839 the incident and reflected beams).
3840 ;
3841 _item.name '<a href="#_diffrn_radiation.polarisn_ratio">_diffrn_radiation.polarisn_ratio</a>'
3842 _item.category_id diffrn_radiation
3843 _item.mandatory_code no
3844 _item_aliases.alias_name '_diffrn_radiation_polarisn_ratio'
3845 _item_aliases.dictionary cif_core.dic
3846 _item_aliases.version 2.0.1
3847 loop_
3848 _item_range.maximum
3849 _item_range.minimum . 0.0
3850 0.0 0.0
3851 _item_type.code float
3852 save_
3853
3854
3855
3856 save_<a name="_diffrn_radiation.polarizn_source_norm">_diffrn_radiation.polarizn_source_norm</a>
3857 _item_description.description
3858 ; The angle in degrees, as viewed from the specimen, between
3859 the normal to the polarization plane and the laboratory <b>Y</b>
3860 axis as defined in the <a href="#AXIS">AXIS</a> category.
3861
3862 Note that this is the angle of polarization of the source
3863 photons, either directly from a synchrotron beamline or
3864 from a monochromater.
3865
3866 This differs from the value of
3867 <a href="#_diffrn_radiation.polarisn_norm">_diffrn_radiation.polarisn_norm</a>
3868 in that <a href="#_diffrn_radiation.polarisn_norm">_diffrn_radiation.polarisn_norm</a> refers to
3869 polarization relative to the diffraction plane rather than
3870 to the laboratory axis system.
3871
3872 In the case of an unpolarized beam, or a beam with true
3873 circular polarization, in which no single plane of
3874 polarization can be determined, the plane should be taken
3875 as the XZ plane and the angle as 0.
3876
3877 See <a href="#_diffrn_radiation.polarizn_source_ratio">_diffrn_radiation.polarizn_source_ratio</a>.
3878 ;
3879 _item.name '<a href="#_diffrn_radiation.polarizn_source_norm">_diffrn_radiation.polarizn_source_norm</a>'
3880 _item.category_id diffrn_radiation
3881 _item.mandatory_code no
3882 loop_
3883 _item_range.maximum
3884 _item_range.minimum 90.0 90.0
3885 90.0 -90.0
3886 -90.0 -90.0
3887 _item_type.code float
3888 _item_units.code degrees
3889 _item_default.value 0.0
3890 save_
3891
3892
3893 save_<a name="_diffrn_radiation.polarizn_source_ratio">_diffrn_radiation.polarizn_source_ratio</a>
3894 _item_description.description
3895 ; (Ip-In)/(Ip+In), where Ip is the intensity
3896 (amplitude squared) of the electric vector in the plane of
3897 polarization and In is the intensity (amplitude squared)
3898 of the electric vector in the plane of the normal to the
3899 plane of polarization.
3900
3901 In the case of an unpolarized beam, or a beam with true
3902 circular polarization, in which no single plane of
3903 polarization can be determined, the plane is to be taken
3904 as the XZ plane and the normal is parallel to the <b>Y</b> axis.
3905
3906 Thus, if there was complete polarization in the plane of
3907 polarization, the value of
3908 <a href="#_diffrn_radiation.polarizn_source_ratio">_diffrn_radiation.polarizn_source_ratio</a> would be 1, and
3909 for an unpolarized beam
3910 <a href="#_diffrn_radiation.polarizn_source_ratio">_diffrn_radiation.polarizn_source_ratio</a> would have a
3911 value of 0.
3912
3913 If the <b>X</b> axis has been chosen to lie in the plane of
3914 polarization, this definition will agree with the definition
3915 of 'MONOCHROMATOR' in the Denzo glossary, and values of near
3916 1 should be expected for a bending-magnet source. However,
3917 if the <b>X</b> axis were perpendicular to the polarization plane
3918 (not a common choice), then the Denzo value would be the
3919 negative of <a href="#_diffrn_radiation.polarizn_source_ratio">_diffrn_radiation.polarizn_source_ratio</a>.
3920
3921 See <a href="http://www.hkl-xray.com">http://www.hkl-xray.com</a> for information on Denzo and
3922 Otwinowski & Minor (1997).
3923
3924 This differs both in the choice of ratio and choice of
3925 orientation from <a href="#_diffrn_radiation.polarisn_ratio">_diffrn_radiation.polarisn_ratio</a>, which,
3926 unlike <a href="#_diffrn_radiation.polarizn_source_ratio">_diffrn_radiation.polarizn_source_ratio</a>, is
3927 unbounded.
3928
3929 Reference: Otwinowski, Z. & Minor, W. (1997). 'Processing of
3930 X-ray diffraction data collected in oscillation mode.' Methods
3931 Enzymol. 276, 307-326.
3932 ;
3933 _item.name '<a href="#_diffrn_radiation.polarizn_source_ratio">_diffrn_radiation.polarizn_source_ratio</a>'
3934 _item.category_id diffrn_radiation
3935 _item.mandatory_code no
3936 loop_
3937 _item_range.maximum
3938 _item_range.minimum 1.0 1.0
3939 1.0 -1.0
3940 -1.0 -1.0
3941 _item_type.code float
3942 save_
3943
3944
3945 save_<A name="_diffrn_radiation.probe">_diffrn_radiation.probe</a>
3946 _item_description.description
3947 ; Name of the type of radiation used. It is strongly
3948 recommended that this be given so that the
3949 probe radiation is clearly specified.
3950 ;
3951 _item.name '<a href="#_diffrn_radiation.probe">_diffrn_radiation.probe</a>'
3952 _item.category_id diffrn_radiation
3953 _item.mandatory_code no
3954 _item_aliases.alias_name '_diffrn_radiation_probe'
3955 _item_aliases.dictionary cif_core.dic
3956 _item_aliases.version 2.0.1
3957 _item_type.code line
3958 loop_
3959 _item_enumeration.value 'X-ray'
3960 'neutron'
3961 'electron'
3962 'gamma'
3963 save_
3964
3965 save_<A name="_diffrn_radiation.type">_diffrn_radiation.type</a>
3966 _item_description.description
3967 ; The nature of the radiation. This is typically a description
3968 of the X-ray wavelength in Siegbahn notation.
3969 ;
3970 _item.name '<a href="#_diffrn_radiation.type">_diffrn_radiation.type</a>'
3971 _item.category_id diffrn_radiation
3972 _item.mandatory_code no
3973 _item_aliases.alias_name '_diffrn_radiation_type'
3974 _item_aliases.dictionary cif_core.dic
3975 _item_aliases.version 2.0.1
3976 _item_type.code line
3977 loop_
3978 _item_examples.case 'CuK\a'
3979 'Cu K\a~1~'
3980 'Cu K-L~2,3~'
3981 'white-beam'
3982
3983 save_
3984
3985 save_<A name="_diffrn_radiation.xray_symbol">_diffrn_radiation.xray_symbol</a>
3986 _item_description.description
3987 ; The IUPAC symbol for the X-ray wavelength for the probe
3988 radiation.
3989 ;
3990 _item.name '<a href="#_diffrn_radiation.xray_symbol">_diffrn_radiation.xray_symbol</a>'
3991 _item.category_id diffrn_radiation
3992 _item.mandatory_code no
3993 _item_aliases.alias_name '_diffrn_radiation_xray_symbol'
3994 _item_aliases.dictionary cif_core.dic
3995 _item_aliases.version 2.0.1
3996 _item_type.code line
3997 loop_
3998 _item_enumeration.value
3999 _item_enumeration.detail 'K-L~3~'
4000 'K\a~1~ in older Siegbahn notation'
4001 'K-L~2~'
4002 'K\a~2~ in older Siegbahn notation'
4003 'K-M~3~'
4004 'K\b~1~ in older Siegbahn notation'
4005 'K-L~2,3~'
4006 'use where K-L~3~ and K-L~2~ are not resolved'
4007 save_
4008
4009 save_<A name="_diffrn_radiation.wavelength_id">_diffrn_radiation.wavelength_id</a>
4010 _item_description.description
4011 ; This data item is a pointer to
4012 <a href="#_diffrn_radiation_wavelength.id">_diffrn_radiation_wavelength.id</a> in the
4013 DIFFRN_RADIATION_WAVELENGTH category.
4014 ;
4015 _item.name '<a href="#_diffrn_radiation.wavelength_id">_diffrn_radiation.wavelength_id</a>'
4016 _item.category_id diffrn_radiation
4017 _item.mandatory_code yes
4018 _item_type.code code
4019 save_
4020
4021
4022
4023 ################
4024 # <a name="DIFFRN_REFLN">DIFFRN_REFLN</a> #
4025 ################
4026
4027
4028 save_DIFFRN_REFLN
4029 _category.description
4030 ; This category redefinition has been added to extend the key of
4031 the standard <a href="#DIFFRN_REFLN">DIFFRN_REFLN</a> category.
4032 ;
4033 _category.id diffrn_refln
4034 _category.mandatory_code no
4035 _category_key.name '<a href="#_diffrn_refln.frame_id" >_diffrn_refln.frame_id</a>'
4036 loop_
4037 _category_group.id 'inclusive_group'
4038 'diffrn_group'
4039 save_
4040
4041
4042 save_<a name="_diffrn_refln.frame_id" >_diffrn_refln.frame_id</a>
4043 _item_description.description
4044 ; This item is a pointer to <a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a>
4045 in the <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a> category.
4046 ;
4047 _item.name '<a href="#_diffrn_refln.frame_id" >_diffrn_refln.frame_id</a>'
4048 _item.category_id diffrn_refln
4049 _item.mandatory_code yes
4050 _item_type.code code
4051 save_
4052
4053
4054 ###############
4055 # <a name="DIFFRN_SCAN">DIFFRN_SCAN</a> #
4056 ###############
4057
4058 save_DIFFRN_SCAN
4059 _category.description
4060 ; Data items in the <a href="#DIFFRN_SCAN">DIFFRN_SCAN</a> category describe the parameters of one
4061 or more scans, relating axis positions to frames.
4062
4063 ;
4064 _category.id diffrn_scan
4065 _category.mandatory_code no
4066 _category_key.name '<a href="#_diffrn_scan.id" >_diffrn_scan.id</a>'
4067 loop_
4068 _category_group.id 'inclusive_group'
4069 'diffrn_group'
4070 loop_
4071 _category_examples.detail
4072 _category_examples.case
4073 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
4074 ; Example 1 - derived from a suggestion by R. M. Sweet.
4075
4076 The vector of each axis is not given here, because it is provided in
4077 the <a href="#AXIS">AXIS</a> category. By making <a href="#_diffrn_scan_axis.scan_id" >_diffrn_scan_axis.scan_id</a> and
4078 <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,
4079 an arbitrary number of scanning and fixed axes can be specified for a
4080 scan. In this example, three rotation axes and one translation axis
4081 at nonzero values are specified, with one axis stepping. There is no
4082 reason why more axes could not have been specified to step. Range
4083 information has been specified, but note that it can be calculated from
4084 the number of frames and the increment, so the data item
4085 <a href="#_diffrn_scan_axis.angle_range">_diffrn_scan_axis.angle_range</a> could be dropped.
4086
4087 Both the sweep data and the data for a single frame are specified.
4088
4089 Note that the information on how the axes are stepped is given twice,
4090 once in terms of the overall averages in the value of
4091 <a href="#_diffrn_scan.integration_time" >_diffrn_scan.integration_time</a> and the values for <a href="#DIFFRN_SCAN_AXIS">DIFFRN_SCAN_AXIS</a>,
4092 and precisely for the given frame in the value for
4093 <a href="#_diffrn_scan_frame.integration_time" >_diffrn_scan_frame.integration_time</a> and the values for
4094 <a href="#DIFFRN_SCAN_FRAME_AXIS">DIFFRN_SCAN_FRAME_AXIS</a>. If dose-related adjustments are made to
4095 scan times and nonlinear stepping is done, these values may differ.
4096 Therefore, in interpreting the data for a particular frame it is
4097 important to use the frame-specific data.
4098 ;
4099 ;
4100 <a href="#_diffrn_scan.id">_diffrn_scan.id</a> 1
4101 <a href="#_diffrn_scan.date_start" >_diffrn_scan.date_start</a> '2001-11-18T03:26:42'
4102 <a href="#_diffrn_scan.date_end" >_diffrn_scan.date_end</a> '2001-11-18T03:36:45'
4103 <a href="#_diffrn_scan.integration_time" >_diffrn_scan.integration_time</a> 3.0
4104 <a href="#_diffrn_scan.frame_id_start" >_diffrn_scan.frame_id_start</a> mad_L2_000
4105 <a href="#_diffrn_scan.frame_id_end" >_diffrn_scan.frame_id_end</a> mad_L2_200
4106 <a href="#_diffrn_scan.frames" >_diffrn_scan.frames</a> 201
4107
4108 loop_
4109 <a href="#_diffrn_scan_axis.scan_id" >_diffrn_scan_axis.scan_id</a>
4110 <a href="#_diffrn_scan_axis.axis_id" >_diffrn_scan_axis.axis_id</a>
4111 <a href="#_diffrn_scan_axis.angle_start" >_diffrn_scan_axis.angle_start</a>
4112 <a href="#_diffrn_scan_axis.angle_range" >_diffrn_scan_axis.angle_range</a>
4113 <a href="#_diffrn_scan_axis.angle_increment" >_diffrn_scan_axis.angle_increment</a>
4114 <a href="#_diffrn_scan_axis.displacement_start" >_diffrn_scan_axis.displacement_start</a>
4115 <a href="#_diffrn_scan_axis.displacement_range" >_diffrn_scan_axis.displacement_range</a>
4116 <a href="#_diffrn_scan_axis.displacement_increment" >_diffrn_scan_axis.displacement_increment</a>
4117
4118 1 omega 200.0 20.0 0.1 . . .
4119 1 kappa -40.0 0.0 0.0 . . .
4120 1 phi 127.5 0.0 0.0 . . .
4121 1 tranz . . . 2.3 0.0 0.0
4122
4123 <a href="#_diffrn_scan_frame.scan_id" >_diffrn_scan_frame.scan_id</a> 1
4124 <a href="#_diffrn_scan_frame.date" >_diffrn_scan_frame.date</a> '2001-11-18T03:27:33'
4125 <a href="#_diffrn_scan_frame.integration_time" >_diffrn_scan_frame.integration_time</a> 3.0
4126 <a href="#_diffrn_scan_frame.frame_id" >_diffrn_scan_frame.frame_id</a> mad_L2_018
4127 <a href="#_diffrn_scan_frame.frame_number" >_diffrn_scan_frame.frame_number</a> 18
4128
4129 loop_
4130 <a href="#_diffrn_scan_frame_axis.frame_id" >_diffrn_scan_frame_axis.frame_id</a>
4131 <a href="#_diffrn_scan_frame_axis.axis_id" >_diffrn_scan_frame_axis.axis_id</a>
4132 <a href="#_diffrn_scan_frame_axis.angle">_diffrn_scan_frame_axis.angle</a>
4133 <a href="#_diffrn_scan_frame_axis.angle_increment" >_diffrn_scan_frame_axis.angle_increment</a>
4134 <a href="#_diffrn_scan_frame_axis.displacement" >_diffrn_scan_frame_axis.displacement</a>
4135 <a href="#_diffrn_scan_frame_axis.displacement_increment" >_diffrn_scan_frame_axis.displacement_increment</a>
4136
4137 mad_L2_018 omega 201.8 0.1 . .
4138 mad_L2_018 kappa -40.0 0.0 . .
4139 mad_L2_018 phi 127.5 0.0 . .
4140 mad_L2_018 tranz . . 2.3 0.0
4141 ;
4142
4143 ; Example 2 - a more extensive example (R. M. Sweet, P. J. Ellis &
4144 H. J. Bernstein).
4145
4146 A detector is placed 240 mm along the <b>Z</b> axis from the goniometer.
4147 This leads to a choice: either the axes of
4148 the detector are defined at the origin, and then a Z setting of -240
4149 is entered, or the axes are defined with the necessary Z offset.
4150 In this case, the setting is used and the offset is left as zero.
4151 This axis is called DETECTOR_Z.
4152
4153 The axis for positioning the detector in the <b>Y</b> direction depends
4154 on the detector <b>Z</b> axis. This axis is called DETECTOR_Y.
4155
4156 The axis for positioning the detector in the <b>X</b> direction depends
4157 on the detector <b>Y</b> axis (and therefore on the detector <b>Z</b> axis).
4158 This axis is called DETECTOR_X.
4159
4160 This detector may be rotated around the <b>Y</b> axis. This rotation axis
4161 depends on the three translation axes. It is called DETECTOR_PITCH.
4162
4163 A coordinate system is defined on the face of the detector in terms of
4164 2300 0.150 mm pixels in each direction. The ELEMENT_X axis is used to
4165 index the first array index of the data array and the ELEMENT_Y
4166 axis is used to index the second array index. Because the pixels
4167 are 0.150mm <b>X</b> 0.150mm, the centre of the first pixel is at (0.075,
4168 0.075) in this coordinate system.
4169 ;
4170
4171 ; ###CBF: VERSION 1.1
4172
4173 data_image_1
4174
4175 # category DIFFRN
4176 _diffrn.id P6MB
4177 _diffrn.crystal_id P6MB_CRYSTAL7
4178
4179 # category DIFFRN_SOURCE
4180 loop_
4181 _diffrn_source.diffrn_id
4182 _diffrn_source.source
4183 _diffrn_source.type
4184 P6MB synchrotron 'SSRL beamline 9-1'
4185
4186 # category <a href="#DIFFRN_RADIATION">DIFFRN_RADIATION</a>
4187 loop_
4188 <a href="#_diffrn_radiation.diffrn_id">_diffrn_radiation.diffrn_id</a>
4189 <a href="#_diffrn_radiation.wavelength_id">_diffrn_radiation.wavelength_id</a>
4190 <a href="#_diffrn_radiation.monochromator">_diffrn_radiation.monochromator</a>
4191 <a href="#_diffrn_radiation.polarizn_source_ratio">_diffrn_radiation.polarizn_source_ratio</a>
4192 <a href="#_diffrn_radiation.polarizn_source_norm">_diffrn_radiation.polarizn_source_norm</a>
4193 <a href="#_diffrn_radiation.div_x_source">_diffrn_radiation.div_x_source</a>
4194 <a href="#_diffrn_radiation.div_y_source">_diffrn_radiation.div_y_source</a>
4195 <a href="#_diffrn_radiation.div_x_y_source">_diffrn_radiation.div_x_y_source</a>
4196 P6MB WAVELENGTH1 'Si 111' 0.8 0.0 0.08
4197 0.01 0.00
4198
4199 # category DIFFRN_RADIATION_WAVELENGTH
4200 loop_
4201 _diffrn_radiation_wavelength.id
4202 _diffrn_radiation_wavelength.wavelength
4203 _diffrn_radiation_wavelength.wt
4204 WAVELENGTH1 0.98 1.0
4205
4206 # category <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a>
4207 loop_
4208 <a href="#_diffrn_detector.diffrn_id">_diffrn_detector.diffrn_id</a>
4209 <a href="#_diffrn_detector.id">_diffrn_detector.id</a>
4210 <a href="#_diffrn_detector.type">_diffrn_detector.type</a>
4211 <a href="#_diffrn_detector.number_of_axes">_diffrn_detector.number_of_axes</a>
4212 P6MB MAR345-SN26 'MAR 345' 4
4213
4214 # category <a href="#DIFFRN_DETECTOR_AXIS">DIFFRN_DETECTOR_AXIS</a>
4215 loop_
4216 <a href="#_diffrn_detector_axis.detector_id">_diffrn_detector_axis.detector_id</a>
4217 <a href="#_diffrn_detector_axis.axis_id">_diffrn_detector_axis.axis_id</a>
4218 MAR345-SN26 DETECTOR_X
4219 MAR345-SN26 DETECTOR_Y
4220 MAR345-SN26 DETECTOR_Z
4221 MAR345-SN26 DETECTOR_PITCH
4222
4223 # category <a href="#DIFFRN_DETECTOR_ELEMENT">DIFFRN_DETECTOR_ELEMENT</a>
4224 loop_
4225 <a href="#_diffrn_detector_element.id">_diffrn_detector_element.id</a>
4226 <a href="#_diffrn_detector_element.detector_id#">_diffrn_detector_element.detector_id</a>
4227 ELEMENT1 MAR345-SN26
4228
4229 # category <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a>
4230 loop_
4231 <a href="#_diffrn_data_frame.id">_diffrn_data_frame.id</a>
4232 <a href="#_diffrn_data_frame.detector_element_id">_diffrn_data_frame.detector_element_id</a>
4233 <a href="#_diffrn_data_frame.array_id">_diffrn_data_frame.array_id</a>
4234 <a href="#_diffrn_data_frame.binary_id">_diffrn_data_frame.binary_id</a>
4235 FRAME1 ELEMENT1 ARRAY1 1
4236
4237 # category <a href="#DIFFRN_MEASUREMENT">DIFFRN_MEASUREMENT</a>
4238 loop_
4239 <a href="#_diffrn_measurement.diffrn_id">_diffrn_measurement.diffrn_id</a>
4240 <a href="#_diffrn_measurement.id">_diffrn_measurement.id</a>
4241 <a href="#_diffrn_measurement.number_of_axes">_diffrn_measurement.number_of_axes</a>
4242 <a href="#_diffrn_measurement.method">_diffrn_measurement.method</a>
4243 P6MB GONIOMETER 3 rotation
4244
4245 # category <a href="#DIFFRN_MEASUREMENT_AXIS">DIFFRN_MEASUREMENT_AXIS</a>
4246 loop_
4247 <a href="#_diffrn_measurement_axis.measurement_id">_diffrn_measurement_axis.measurement_id</a>
4248 <a href="#_diffrn_measurement_axis.axis_id">_diffrn_measurement_axis.axis_id</a>
4249 GONIOMETER GONIOMETER_PHI
4250 GONIOMETER GONIOMETER_KAPPA
4251 GONIOMETER GONIOMETER_OMEGA
4252
4253 # category <a href="#DIFFRN_SCAN">DIFFRN_SCAN</a>
4254 loop_
4255 <a href="#_diffrn_scan.id" >_diffrn_scan.id</a>
4256 <a href="#_diffrn_scan.frame_id_start" >_diffrn_scan.frame_id_start</a>
4257 <a href="#_diffrn_scan.frame_id_end" >_diffrn_scan.frame_id_end</a>
4258 <a href="#_diffrn_scan.frames" >_diffrn_scan.frames</a>
4259 SCAN1 FRAME1 FRAME1 1
4260
4261 # category <a href="#DIFFRN_SCAN_AXIS">DIFFRN_SCAN_AXIS</a>
4262 loop_
4263 <a href="#_diffrn_scan_axis.scan_id" >_diffrn_scan_axis.scan_id</a>
4264 <a href="#_diffrn_scan_axis.axis_id" >_diffrn_scan_axis.axis_id</a>
4265 <a href="#_diffrn_scan_axis.angle_start" >_diffrn_scan_axis.angle_start</a>
4266 <a href="#_diffrn_scan_axis.angle_range" >_diffrn_scan_axis.angle_range</a>
4267 <a href="#_diffrn_scan_axis.angle_increment" >_diffrn_scan_axis.angle_increment</a>
4268 <a href="#_diffrn_scan_axis.displacement_start" >_diffrn_scan_axis.displacement_start</a>
4269 <a href="#_diffrn_scan_axis.displacement_range" >_diffrn_scan_axis.displacement_range</a>
4270 <a href="#_diffrn_scan_axis.displacement_increment" >_diffrn_scan_axis.displacement_increment</a>
4271 SCAN1 GONIOMETER_OMEGA 12.0 1.0 1.0 0.0 0.0 0.0
4272 SCAN1 GONIOMETER_KAPPA 23.3 0.0 0.0 0.0 0.0 0.0
4273 SCAN1 GONIOMETER_PHI -165.8 0.0 0.0 0.0 0.0 0.0
4274 SCAN1 DETECTOR_Z 0.0 0.0 0.0 -240.0 0.0 0.0
4275 SCAN1 DETECTOR_Y 0.0 0.0 0.0 0.6 0.0 0.0
4276 SCAN1 DETECTOR_X 0.0 0.0 0.0 -0.5 0.0 0.0
4277 SCAN1 DETECTOR_PITCH 0.0 0.0 0.0 0.0 0.0 0.0
4278
4279 # category <a href="#DIFFRN_SCAN_FRAME">DIFFRN_SCAN_FRAME</a>
4280 loop_
4281 <a href="#_diffrn_scan_frame.frame_id" >_diffrn_scan_frame.frame_id</a>
4282 <a href="#_diffrn_scan_frame.frame_number" >_diffrn_scan_frame.frame_number</a>
4283 <a href="#_diffrn_scan_frame.integration_time" >_diffrn_scan_frame.integration_time</a>
4284 <a href="#_diffrn_scan_frame.scan_id" >_diffrn_scan_frame.scan_id</a>
4285 <a href="#_diffrn_scan_frame.date" >_diffrn_scan_frame.date</a>
4286 FRAME1 1 20.0 SCAN1 1997-12-04T10:23:48
4287
4288 # category <a href="#DIFFRN_SCAN_FRAME_AXIS">DIFFRN_SCAN_FRAME_AXIS</a>
4289 loop_
4290 <a href="#_diffrn_scan_frame_axis.frame_id" >_diffrn_scan_frame_axis.frame_id</a>
4291 <a href="#_diffrn_scan_frame_axis.axis_id" >_diffrn_scan_frame_axis.axis_id</a>
4292 <a href="#_diffrn_scan_frame_axis.angle" >_diffrn_scan_frame_axis.angle</a>
4293 <a href="#_diffrn_scan_frame_axis.displacement" >_diffrn_scan_frame_axis.displacement</a>
4294 FRAME1 GONIOMETER_OMEGA 12.0 0.0
4295 FRAME1 GONIOMETER_KAPPA 23.3 0.0
4296 FRAME1 GONIOMETER_PHI -165.8 0.0
4297 FRAME1 DETECTOR_Z 0.0 -240.0
4298 FRAME1 DETECTOR_Y 0.0 0.6
4299 FRAME1 DETECTOR_X 0.0 -0.5
4300 FRAME1 DETECTOR_PITCH 0.0 0.0
4301
4302 # category <a href="#AXIS">AXIS</a>
4303 loop_
4304 <a href="#_axis.id">_axis.id</a>
4305 <a href="#_axis.type">_axis.type</a>
4306 <a href="#_axis.equipment">_axis.equipment</a>
4307 <a href="#_axis.depends_on">_axis.depends_on</a>
4308 <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>
4309 <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>
4310 GONIOMETER_OMEGA rotation goniometer . 1 0 0 . . .
4311 GONIOMETER_KAPPA rotation goniometer GONIOMETER_OMEGA 0.64279
4312 0 0.76604 . . .
4313 GONIOMETER_PHI rotation goniometer GONIOMETER_KAPPA 1 0 0
4314 . . .
4315 SOURCE general source . 0 0 1 . . .
4316 GRAVITY general gravity . 0 -1 0 . . .
4317 DETECTOR_Z translation detector . 0 0 1 0 0 0
4318 DETECTOR_Y translation detector DETECTOR_Z 0 1 0 0 0 0
4319 DETECTOR_X translation detector DETECTOR_Y 1 0 0 0 0 0
4320 DETECTOR_PITCH rotation detector DETECTOR_X 0 1 0 0 0 0
4321 ELEMENT_X translation detector DETECTOR_PITCH
4322 1 0 0 172.43 -172.43 0
4323 ELEMENT_Y translation detector ELEMENT_X
4324 0 1 0 0 0 0
4325
4326 # category <a href="#ARRAY_STRUCTURE_LIST">ARRAY_STRUCTURE_LIST</a>
4327 loop_
4328 <a href="#_array_structure_list.array_id">_array_structure_list.array_id</a>
4329 <a href="#_array_structure_list.index">_array_structure_list.index</a>
4330 <a href="#_array_structure_list.dimension">_array_structure_list.dimension</a>
4331 <a href="#_array_structure_list.precedence">_array_structure_list.precedence</a>
4332 <a href="#_array_structure_list.direction">_array_structure_list.direction</a>
4333 <a href="#_array_structure_list.axis_set_id">_array_structure_list.axis_set_id</a>
4334 ARRAY1 1 2300 1 increasing ELEMENT_X
4335 ARRAY1 2 2300 2 increasing ELEMENT_Y
4336
4337 # category <a href="#ARRAY_STRUCTURE_LIST_AXIS">ARRAY_STRUCTURE_LIST_AXIS</a>
4338 loop_
4339 <a href="#_array_structure_list_axis.axis_set_id">_array_structure_list_axis.axis_set_id</a>
4340 <a href="#_array_structure_list_axis.axis_id">_array_structure_list_axis.axis_id</a>
4341 <a href="#_array_structure_list_axis.displacement">_array_structure_list_axis.displacement</a>
4342 <a href="#_array_structure_list_axis.displacement_increment">_array_structure_list_axis.displacement_increment</a>
4343 ELEMENT_X ELEMENT_X 0.075 0.150
4344 ELEMENT_Y ELEMENT_Y 0.075 0.150
4345
4346 # category <a href="#ARRAY_ELEMENT_SIZE">ARRAY_ELEMENT_SIZE</a>
4347 loop_
4348 <a href="#_array_element_size.array_id">_array_element_size.array_id</a>
4349 <a href="#_array_element_size.index">_array_element_size.index</a>
4350 <a href="#_array_element_size.index">_array_element_size.size</a>
4351 ARRAY1 1 150e-6
4352 ARRAY1 2 150e-6
4353
4354 # category <a href="#ARRAY_INTENSITIES">ARRAY_INTENSITIES</a>
4355 loop_
4356 <a href="#_array_intensities.array_id">_array_intensities.array_id</a>
4357 <a href="#_array_intensities.binary_id">_array_intensities.binary_id</a>
4358 <a href="#_array_intensities.linearity">_array_intensities.linearity</a>
4359 <a href="#_array_intensities.gain">_array_intensities.gain</a>
4360 <a href="#_array_intensities.gain_esd">_array_intensities.gain_esd</a>
4361 <a href="#_array_intensities.overload">_array_intensities.overload</a>
4362 <a href="#_array_intensities.undefined_value">_array_intensities.undefined_value</a>
4363 ARRAY1 1 linear 1.15 0.2 240000 0
4364
4365 # category <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a>
4366 loop_
4367 <a href="#_array_structure.id">_array_structure.id</a>
4368 <a href="#_array_structure.encoding_type">_array_structure.encoding_type</a>
4369 <a href="#_array_structure.compression_type">_array_structure.compression_type</a>
4370 <a href="#_array_structure.byte_order">_array_structure.byte_order</a>
4371 ARRAY1 "signed 32-bit integer" packed little_endian
4372
4373 # category <a href="#ARRAY_DATA">ARRAY_DATA</a>
4374 loop_
4375 <a href="#_array_data.array_id">_array_data.array_id</a>
4376 <a href="#_array_data.binary_id">_array_data.binary_id</a>
4377 <a href="#_array_data.data">_array_data.data</a>
4378 ARRAY1 1
4379 ;
4380 --CIF-BINARY-FORMAT-SECTION--
4381 Content-Type: application/octet-stream;
4382 conversions="<b>X</b>-CBF_PACKED"
4383 Content-Transfer-Encoding: BASE64
4384 <b>X</b>-Binary-Size: 3801324
4385 <b>X</b>-Binary-ID: 1
4386 <b>X</b>-Binary-Element-Type: "signed 32-bit integer"
4387 Content-MD5: 07lZFvF+aOcW85IN7usl8A==
4388
4389 AABRAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAZBQSr1sKNBOeOe9HITdMdDUnbq7bg
4390 ...
4391 8REo6TtBrxJ1vKqAvx9YDMD6J18Qg83OMr/tgssjMIJMXATDsZobL90AEXc4KigE
4392
4393 --CIF-BINARY-FORMAT-SECTION----
4394 ;
4395 ;
4396
4397 ; Example 3 - Example 2 revised for a spiral scan (R. M. Sweet,
4398 P. J. Ellis & H. J. Bernstein).
4399
4400 A detector is placed 240 mm along the <b>Z</b> axis from the
4401 goniometer, as in Example 2 above, but in this example the
4402 image plate is scanned in a spiral pattern from the outside edge in.
4403
4404 The axis for positioning the detector in the <b>Y</b> direction depends
4405 on the detector <b>Z</b> axis. This axis is called DETECTOR_Y.
4406
4407 The axis for positioning the detector in the <b>X</b> direction depends
4408 on the detector <b>Y</b> axis (and therefore on the detector <b>Z</b> axis).
4409 This axis is called DETECTOR_X.
4410
4411 This detector may be rotated around the <b>Y</b> axis. This rotation axis
4412 depends on the three translation axes. It is called DETECTOR_PITCH.
4413
4414 A coordinate system is defined on the face of the detector in
4415 terms of a coupled rotation axis and radial scan axis to form
4416 a spiral scan. The rotation axis is called ELEMENT_ROT and the
4417 radial axis is called ELEMENT_RAD. A 150 micrometre radial pitch
4418 and a 75 micrometre 'constant velocity' angular pitch are assumed.
4419
4420 Indexing is carried out first on the rotation axis and the radial axis
4421 is made to be dependent on it.
4422
4423 The two axes are coupled to form an axis set ELEMENT_SPIRAL.
4424 ;
4425 ; ###CBF: VERSION 1.1
4426
4427 data_image_1
4428
4429 # category DIFFRN
4430 _diffrn.id P6MB
4431 _diffrn.crystal_id P6MB_CRYSTAL7
4432
4433 # category DIFFRN_SOURCE
4434 loop_
4435 _diffrn_source.diffrn_id
4436 _diffrn_source.source
4437 _diffrn_source.type
4438 P6MB synchrotron 'SSRL beamline 9-1'
4439
4440 # category <a href="#DIFFRN_RADIATION">DIFFRN_RADIATION</a>
4441 loop_
4442 <a href="#_diffrn_radiation.diffrn_id">_diffrn_radiation.diffrn_id</a>
4443 <a href="#_diffrn_radiation.wavelength_id">_diffrn_radiation.wavelength_id</a>
4444 <a href="#_diffrn_radiation.monochromator">_diffrn_radiation.monochromator</a>
4445 <a href="#_diffrn_radiation.polarizn_source_ratio">_diffrn_radiation.polarizn_source_ratio</a>
4446 <a href="#_diffrn_radiation.polarizn_source_norm">_diffrn_radiation.polarizn_source_norm</a>
4447 <a href="#_diffrn_radiation.div_x_source">_diffrn_radiation.div_x_source</a>
4448 <a href="#_diffrn_radiation.div_y_source">_diffrn_radiation.div_y_source</a>
4449 <a href="#_diffrn_radiation.div_x_y_source">_diffrn_radiation.div_x_y_source</a>
4450 P6MB WAVELENGTH1 'Si 111' 0.8 0.0 0.08
4451 0.01 0.00
4452
4453 # category DIFFRN_RADIATION_WAVELENGTH
4454 loop_
4455 _diffrn_radiation_wavelength.id
4456 _diffrn_radiation_wavelength.wavelength
4457 _diffrn_radiation_wavelength.wt
4458 WAVELENGTH1 0.98 1.0
4459
4460 # category <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a>
4461 loop_
4462 <a href="#_diffrn_detector.diffrn_id">_diffrn_detector.diffrn_id</a>
4463 <a href="#_diffrn_detector.id">_diffrn_detector.id</a>
4464 <a href="#_diffrn_detector.type">_diffrn_detector.type</a>
4465 <a href="#_diffrn_detector.number_of_axes">_diffrn_detector.number_of_axes</a>
4466 P6MB MAR345-SN26 'MAR 345' 4
4467
4468 # category <a href="#DIFFRN_DETECTOR_AXIS">DIFFRN_DETECTOR_AXIS</a>
4469 loop_
4470 <a href="#_diffrn_detector_axis.detector_id">_diffrn_detector_axis.detector_id</a>
4471 <a href="#_diffrn_detector_axis.axis_id">_diffrn_detector_axis.axis_id</a>
4472 MAR345-SN26 DETECTOR_X
4473 MAR345-SN26 DETECTOR_Y
4474 MAR345-SN26 DETECTOR_Z
4475 MAR345-SN26 DETECTOR_PITCH
4476
4477 # category <a href="#DIFFRN_DETECTOR_ELEMENT">DIFFRN_DETECTOR_ELEMENT</a>
4478 loop_
4479 <a href="#_diffrn_detector_element.id">_diffrn_detector_element.id</a>
4480 <a href="#_diffrn_detector_element.detector_id#">_diffrn_detector_element.detector_id</a>
4481 ELEMENT1 MAR345-SN26
4482
4483 # category <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a>
4484 loop_
4485 <a href="#_diffrn_data_frame.id">_diffrn_data_frame.id</a>
4486 <a href="#_diffrn_data_frame.detector_element_id">_diffrn_data_frame.detector_element_id</a>
4487 <a href="#_diffrn_data_frame.array_id">_diffrn_data_frame.array_id</a>
4488 <a href="#_diffrn_data_frame.binary_id">_diffrn_data_frame.binary_id</a>
4489 FRAME1 ELEMENT1 ARRAY1 1
4490
4491 # category <a href="#DIFFRN_MEASUREMENT">DIFFRN_MEASUREMENT</a>
4492 loop_
4493 <a href="#_diffrn_measurement.diffrn_id">_diffrn_measurement.diffrn_id</a>
4494 <a href="#_diffrn_measurement.id">_diffrn_measurement.id</a>
4495 <a href="#_diffrn_measurement.number_of_axes">_diffrn_measurement.number_of_axes</a>
4496 <a href="#_diffrn_measurement.method">_diffrn_measurement.method</a>
4497 P6MB GONIOMETER 3 rotation
4498
4499 # category <a href="#DIFFRN_MEASUREMENT_AXIS">DIFFRN_MEASUREMENT_AXIS</a>
4500 loop_
4501 <a href="#_diffrn_measurement_axis.measurement_id">_diffrn_measurement_axis.measurement_id</a>
4502 <a href="#_diffrn_measurement_axis.axis_id">_diffrn_measurement_axis.axis_id</a>
4503 GONIOMETER GONIOMETER_PHI
4504 GONIOMETER GONIOMETER_KAPPA
4505 GONIOMETER GONIOMETER_OMEGA
4506
4507 # category <a href="#DIFFRN_SCAN">DIFFRN_SCAN</a>
4508 loop_
4509 <a href="#_diffrn_scan.id" >_diffrn_scan.id</a>
4510 <a href="#_diffrn_scan.frame_id_start" >_diffrn_scan.frame_id_start</a>
4511 <a href="#_diffrn_scan.frame_id_end" >_diffrn_scan.frame_id_end</a>
4512 <a href="#_diffrn_scan.frames" >_diffrn_scan.frames</a>
4513 SCAN1 FRAME1 FRAME1 1
4514
4515 # category <a href="#DIFFRN_SCAN_AXIS">DIFFRN_SCAN_AXIS</a>
4516 loop_
4517 <a href="#_diffrn_scan_axis.scan_id" >_diffrn_scan_axis.scan_id</a>
4518 <a href="#_diffrn_scan_axis.axis_id" >_diffrn_scan_axis.axis_id</a>
4519 <a href="#_diffrn_scan_axis.angle_start" >_diffrn_scan_axis.angle_start</a>
4520 <a href="#_diffrn_scan_axis.angle_range" >_diffrn_scan_axis.angle_range</a>
4521 <a href="#_diffrn_scan_axis.angle_increment" >_diffrn_scan_axis.angle_increment</a>
4522 <a href="#_diffrn_scan_axis.displacement_start" >_diffrn_scan_axis.displacement_start</a>
4523 <a href="#_diffrn_scan_axis.displacement_range" >_diffrn_scan_axis.displacement_range</a>
4524 <a href="#_diffrn_scan_axis.displacement_increment" >_diffrn_scan_axis.displacement_increment</a>
4525 SCAN1 GONIOMETER_OMEGA 12.0 1.0 1.0 0.0 0.0 0.0
4526 SCAN1 GONIOMETER_KAPPA 23.3 0.0 0.0 0.0 0.0 0.0
4527 SCAN1 GONIOMETER_PHI -165.8 0.0 0.0 0.0 0.0 0.0
4528 SCAN1 DETECTOR_Z 0.0 0.0 0.0 -240.0 0.0 0.0
4529 SCAN1 DETECTOR_Y 0.0 0.0 0.0 0.6 0.0 0.0
4530 SCAN1 DETECTOR_X 0.0 0.0 0.0 -0.5 0.0 0.0
4531 SCAN1 DETECTOR_PITCH 0.0 0.0 0.0 0.0 0.0 0.0
4532
4533 # category <a href="#DIFFRN_SCAN_FRAME">DIFFRN_SCAN_FRAME</a>
4534 loop_
4535 <a href="#_diffrn_scan_frame.frame_id" >_diffrn_scan_frame.frame_id</a>
4536 <a href="#_diffrn_scan_frame.frame_number" >_diffrn_scan_frame.frame_number</a>
4537 <a href="#_diffrn_scan_frame.integration_time" >_diffrn_scan_frame.integration_time</a>
4538 <a href="#_diffrn_scan_frame.scan_id" >_diffrn_scan_frame.scan_id</a>
4539 <a href="#_diffrn_scan_frame.date" >_diffrn_scan_frame.date</a>
4540 FRAME1 1 20.0 SCAN1 1997-12-04T10:23:48
4541
4542 # category <a href="#DIFFRN_SCAN_FRAME_AXIS">DIFFRN_SCAN_FRAME_AXIS</a>
4543 loop_
4544 <a href="#_diffrn_scan_frame_axis.frame_id" >_diffrn_scan_frame_axis.frame_id</a>
4545 <a href="#_diffrn_scan_frame_axis.axis_id" >_diffrn_scan_frame_axis.axis_id</a>
4546 <a href="#_diffrn_scan_frame_axis.angle" >_diffrn_scan_frame_axis.angle</a>
4547 <a href="#_diffrn_scan_frame_axis.displacement" >_diffrn_scan_frame_axis.displacement</a>
4548 FRAME1 GONIOMETER_OMEGA 12.0 0.0
4549 FRAME1 GONIOMETER_KAPPA 23.3 0.0
4550 FRAME1 GONIOMETER_PHI -165.8 0.0
4551 FRAME1 DETECTOR_Z 0.0 -240.0
4552 FRAME1 DETECTOR_Y 0.0 0.6
4553 FRAME1 DETECTOR_X 0.0 -0.5
4554 FRAME1 DETECTOR_PITCH 0.0 0.0
4555
4556 # category <a href="#AXIS">AXIS</a>
4557 loop_
4558 <a href="#_axis.id">_axis.id</a>
4559 <a href="#_axis.type">_axis.type</a>
4560 <a href="#_axis.equipment">_axis.equipment</a>
4561 <a href="#_axis.depends_on">_axis.depends_on</a>
4562 <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>
4563 <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>
4564 GONIOMETER_OMEGA rotation goniometer . 1 0 0 . . .
4565 GONIOMETER_KAPPA rotation goniometer GONIOMETER_OMEGA 0.64279
4566 0 0.76604 . . .
4567 GONIOMETER_PHI rotation goniometer GONIOMETER_KAPPA 1 0 0
4568 . . .
4569 SOURCE general source . 0 0 1 . . .
4570 GRAVITY general gravity . 0 -1 0 . . .
4571 DETECTOR_Z translation detector . 0 0 1 0 0 0
4572 DETECTOR_Y translation detector DETECTOR_Z 0 1 0 0 0 0
4573 DETECTOR_X translation detector DETECTOR_Y 1 0 0 0 0 0
4574 DETECTOR_PITCH rotation detector DETECTOR_X 0 1 0 0 0 0
4575 ELEMENT_ROT translation detector DETECTOR_PITCH 0 0 1 0 0 0
4576 ELEMENT_RAD translation detector ELEMENT_ROT 0 1 0 0 0 0
4577
4578 # category <a href="#ARRAY_STRUCTURE_LIST">ARRAY_STRUCTURE_LIST</a>
4579 loop_
4580 <a href="#_array_structure_list.array_id">_array_structure_list.array_id</a>
4581 <a href="#_array_structure_list.index">_array_structure_list.index</a>
4582 <a href="#_array_structure_list.dimension">_array_structure_list.dimension</a>
4583 <a href="#_array_structure_list.precedence">_array_structure_list.precedence</a>
4584 <a href="#_array_structure_list.direction">_array_structure_list.direction</a>
4585 <a href="#_array_structure_list.axis_set_id">_array_structure_list.axis_set_id</a>
4586 ARRAY1 1 8309900 1 increasing ELEMENT_SPIRAL
4587
4588 # category <a href="#ARRAY_STRUCTURE_LIST_AXIS">ARRAY_STRUCTURE_LIST_AXIS</a>
4589 loop_
4590 <a href="#_array_structure_list_axis.axis_set_id">_array_structure_list_axis.axis_set_id</a>
4591 <a href="#_array_structure_list_axis.axis_id">_array_structure_list_axis.axis_id</a>
4592 <a href="#_array_structure_list_axis.angle">_array_structure_list_axis.angle</a>
4593 <a href="#_array_structure_list_axis.displacement">_array_structure_list_axis.displacement</a>
4594 <a href="#_array_structure_list_axis.angular_pitch">_array_structure_list_axis.angular_pitch</a>
4595 <a href="#_array_structure_list_axis.radial_pitch">_array_structure_list_axis.radial_pitch</a>
4596 ELEMENT_SPIRAL ELEMENT_ROT 0 . 0.075 .
4597 ELEMENT_SPIRAL ELEMENT_RAD . 172.5 . -0.150
4598
4599 # category <a href="#ARRAY_ELEMENT_SIZE">ARRAY_ELEMENT_SIZE</a>
4600 # the actual pixels are 0.075 by 0.150 mm
4601 # We give the coarser dimension here.
4602 loop_
4603 <a href="#_array_element_size.array_id">_array_element_size.array_id</a>
4604 <a href="#_array_element_size.index">_array_element_size.index</a>
4605 <a href="#_array_element_size.index">_array_element_size.size</a>
4606 ARRAY1 1 150e-6
4607
4608 # category <a href="#ARRAY_INTENSITIES">ARRAY_INTENSITIES</a>
4609 loop_
4610 <a href="#_array_intensities.array_id">_array_intensities.array_id</a>
4611 <a href="#_array_intensities.binary_id">_array_intensities.binary_id</a>
4612 <a href="#_array_intensities.linearity">_array_intensities.linearity</a>
4613 <a href="#_array_intensities.gain">_array_intensities.gain</a>
4614 <a href="#_array_intensities.gain_esd">_array_intensities.gain_esd</a>
4615 <a href="#_array_intensities.overload">_array_intensities.overload</a>
4616 <a href="#_array_intensities.undefined_value">_array_intensities.undefined_value</a>
4617 ARRAY1 1 linear 1.15 0.2 240000 0
4618
4619 # category <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a>
4620 loop_
4621 <a href="#_array_structure.id">_array_structure.id</a>
4622 <a href="#_array_structure.encoding_type">_array_structure.encoding_type</a>
4623 <a href="#_array_structure.compression_type">_array_structure.compression_type</a>
4624 <a href="#_array_structure.byte_order">_array_structure.byte_order</a>
4625 ARRAY1 "signed 32-bit integer" packed little_endian
4626
4627 # category <a href="#ARRAY_DATA">ARRAY_DATA</a>
4628 loop_
4629 <a href="#_array_data.array_id">_array_data.array_id</a>
4630 <a href="#_array_data.binary_id">_array_data.binary_id</a>
4631 <a href="#_array_data.data">_array_data.data</a>
4632 ARRAY1 1
4633 ;
4634 --CIF-BINARY-FORMAT-SECTION--
4635 Content-Type: application/octet-stream;
4636 conversions="<b>X</b>-CBF_PACKED"
4637 Content-Transfer-Encoding: BASE64
4638 <b>X</b>-Binary-Size: 3801324
4639 <b>X</b>-Binary-ID: 1
4640 <b>X</b>-Binary-Element-Type: "signed 32-bit integer"
4641 Content-MD5: 07lZFvF+aOcW85IN7usl8A==
4642
4643 AABRAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAZBQSr1sKNBOeOe9HITdMdDUnbq7bg
4644 ...
4645 8REo6TtBrxJ1vKqAvx9YDMD6J18Qg83OMr/tgssjMIJMXATDsZobL90AEXc4KigE
4646
4647 --CIF-BINARY-FORMAT-SECTION----
4648 ;
4649 ;
4650 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
4651 save_
4652
4653
4654 save_<a name="_diffrn_scan.id" >_diffrn_scan.id</a>
4655 _item_description.description
4656 ; The value of <a href="#_diffrn_scan.id" >_diffrn_scan.id</a> uniquely identifies each
4657 scan. The identifier is used to tie together all the
4658 information about the scan.
4659 ;
4660 loop_
4661 _item.name
4662 _item.category_id
4663 _item.mandatory_code
4664 '<a href="#_diffrn_scan.id" >_diffrn_scan.id</a>' diffrn_scan yes
4665 '<a href="#_diffrn_scan_axis.scan_id" >_diffrn_scan_axis.scan_id</a>' diffrn_scan_axis yes
4666 '<a href="#_diffrn_scan_frame.scan_id" >_diffrn_scan_frame.scan_id</a>' diffrn_scan_frame yes
4667 _item_type.code code
4668 loop_
4669 _item_linked.child_name
4670 _item_linked.parent_name
4671 '<a href="#_diffrn_scan_axis.scan_id" >_diffrn_scan_axis.scan_id</a>' '<a href="#_diffrn_scan.id" >_diffrn_scan.id</a>'
4672 '<a href="#_diffrn_scan_frame.scan_id" >_diffrn_scan_frame.scan_id</a>' '<a href="#_diffrn_scan.id" >_diffrn_scan.id</a>'
4673 save_
4674
4675
4676 save_<a name="_diffrn_scan.date_end">_diffrn_scan.date_end</a>
4677 _item_description.description
4678 ; The date and time of the end of the scan. Note that this
4679 may be an estimate generated during the scan, before the
4680 precise time of the end of the scan is known.
4681 ;
4682 _item.name '<a href="#_diffrn_scan.date_end">_diffrn_scan.date_end</a>'
4683 _item.category_id diffrn_scan
4684 _item.mandatory_code no
4685 _item_type.code yyyy-mm-dd
4686 save_
4687
4688
4689 save_<a name="_diffrn_scan.date_start">_diffrn_scan.date_start</a>
4690 _item_description.description
4691 ; The date and time of the start of the scan.
4692 ;
4693 _item.name '<a href="#_diffrn_scan.date_start">_diffrn_scan.date_start</a>'
4694 _item.category_id diffrn_scan
4695 _item.mandatory_code no
4696 _item_type.code yyyy-mm-dd
4697 save_
4698
4699
4700 save_<a name="_diffrn_scan.integration_time" >_diffrn_scan.integration_time</a>
4701 _item_description.description
4702 ; Approximate average time in seconds to integrate each
4703 step of the scan. The precise time for integration
4704 of each particular step must be provided in
4705 <a href="#_diffrn_scan_frame.integration_time" >_diffrn_scan_frame.integration_time</a>, even
4706 if all steps have the same integration time.
4707 ;
4708 _item.name '<a href="#_diffrn_scan.integration_time" >_diffrn_scan.integration_time</a>'
4709 _item.category_id diffrn_scan
4710 _item.mandatory_code no
4711 _item_type.code float
4712 _item_units.code 'seconds'
4713 loop_
4714 _item_range.maximum
4715 _item_range.minimum
4716 . 0.0
4717 save_
4718
4719
4720 save_<a name="_diffrn_scan.frame_id_start" >_diffrn_scan.frame_id_start</a>
4721 _item_description.description
4722 ; The value of this data item is the identifier of the
4723 first frame in the scan.
4724
4725 This item is a pointer to <a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a> in the
4726 <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a> category.
4727 ;
4728 _item.name '<a href="#_diffrn_scan.frame_id_start" >_diffrn_scan.frame_id_start</a>'
4729 _item.category_id diffrn_scan
4730 _item.mandatory_code yes
4731 _item_type.code code
4732 save_
4733
4734
4735 save_<a name="_diffrn_scan.frame_id_end" >_diffrn_scan.frame_id_end</a>
4736 _item_description.description
4737 ; The value of this data item is the identifier of the
4738 last frame in the scan.
4739
4740 This item is a pointer to <a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a> in the
4741 <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a> category.
4742 ;
4743 _item.name '<a href="#_diffrn_scan.frame_id_end" >_diffrn_scan.frame_id_end</a>'
4744 _item.category_id diffrn_scan
4745 _item.mandatory_code yes
4746 _item_type.code code
4747 save_
4748
4749
4750 save_<a name="_diffrn_scan.frames" >_diffrn_scan.frames</a>
4751 _item_description.description
4752 ; The value of this data item is the number of frames in
4753 the scan.
4754 ;
4755 _item.name '<a href="#_diffrn_scan.frames" >_diffrn_scan.frames</a>'
4756 _item.category_id diffrn_scan
4757 _item.mandatory_code no
4758 _item_type.code int
4759 loop_
4760 _item_range.maximum
4761 _item_range.minimum
4762 . 1
4763 1 1
4764 save_
4765
4766
4767 ####################
4768 # <a name="DIFFRN_SCAN_AXIS">DIFFRN_SCAN_AXIS</a> #
4769 ####################
4770
4771 save_DIFFRN_SCAN_AXIS
4772 _category.description
4773 ; Data items in the <a href="#DIFFRN_SCAN_AXIS">DIFFRN_SCAN_AXIS</a> category describe the settings of
4774 axes for particular scans. Unspecified axes are assumed to be at
4775 their zero points.
4776 ;
4777 _category.id diffrn_scan_axis
4778 _category.mandatory_code no
4779 loop_
4780 _category_key.name
4781 '<a href="#_diffrn_scan_axis.scan_id" >_diffrn_scan_axis.scan_id</a>'
4782 '<a href="#_diffrn_scan_axis.axis_id" >_diffrn_scan_axis.axis_id</a>'
4783 loop_
4784 _category_group.id 'inclusive_group'
4785 'diffrn_group'
4786 save_
4787
4788
4789 save_<a name="_diffrn_scan_axis.scan_id" >_diffrn_scan_axis.scan_id</a>
4790 _item_description.description
4791 ; The value of this data item is the identifier of the
4792 scan for which axis settings are being specified.
4793
4794 Multiple axes may be specified for the same value of
4795 <a href="#_diffrn_scan.id" >_diffrn_scan.id</a>.
4796
4797 This item is a pointer to <a href="#_diffrn_scan.id" >_diffrn_scan.id</a> in the
4798 <a href="#DIFFRN_SCAN">DIFFRN_SCAN</a> category.
4799 ;
4800 _item.name '<a href="#_diffrn_scan_axis.scan_id" >_diffrn_scan_axis.scan_id</a>'
4801 _item.category_id diffrn_scan_axis
4802 _item.mandatory_code yes
4803 _item_type.code code
4804 save_
4805
4806
4807 save_<a name="_diffrn_scan_axis.axis_id" >_diffrn_scan_axis.axis_id</a>
4808 _item_description.description
4809 ; The value of this data item is the identifier of one of
4810 the axes for the scan for which settings are being specified.
4811
4812 Multiple axes may be specified for the same value of
4813 <a href="#_diffrn_scan.id" >_diffrn_scan.id</a>.
4814
4815 This item is a pointer to <a href="#_axis.id" >_axis.id</a> in the
4816 AXIS category.
4817 ;
4818 _item.name '<a href="#_diffrn_scan_axis.axis_id" >_diffrn_scan_axis.axis_id</a>'
4819 _item.category_id diffrn_scan_axis
4820 _item.mandatory_code yes
4821 _item_type.code code
4822 save_
4823
4824
4825 save_<a name="_diffrn_scan_axis.angle_start" >_diffrn_scan_axis.angle_start</a>
4826 _item_description.description
4827 ; The starting position for the specified axis in degrees.
4828 ;
4829 _item.name '<a href="#_diffrn_scan_axis.angle_start" >_diffrn_scan_axis.angle_start</a>'
4830 _item.category_id diffrn_scan_axis
4831 _item.mandatory_code no
4832 _item_default.value 0.0
4833 _item_type.code float
4834 _item_units.code 'degrees'
4835 save_
4836
4837
4838 save_<a name="_diffrn_scan_axis.angle_range" >_diffrn_scan_axis.angle_range</a>
4839 _item_description.description
4840 ; The range from the starting position for the specified axis
4841 in degrees.
4842 ;
4843 _item.name '<a href="#_diffrn_scan_axis.angle_range" >_diffrn_scan_axis.angle_range</a>'
4844 _item.category_id diffrn_scan_axis
4845 _item.mandatory_code no
4846 _item_default.value 0.0
4847 _item_type.code float
4848 _item_units.code 'degrees'
4849 save_
4850
4851
4852 save_<a name="_diffrn_scan_axis.angle_increment" >_diffrn_scan_axis.angle_increment</a>
4853 _item_description.description
4854 ; The increment for each step for the specified axis
4855 in degrees. In general, this will agree with
4856 <a href="#_diffrn_scan_frame_axis.angle_increment" >_diffrn_scan_frame_axis.angle_increment</a>. The
4857 sum of the values of <a href="#_diffrn_scan_frame_axis.angle">_diffrn_scan_frame_axis.angle</a> and
4858 <a href="#_diffrn_scan_frame_axis.angle_increment">_diffrn_scan_frame_axis.angle_increment</a> is the
4859 angular setting of the axis at the end of the integration
4860 time for a given frame. If the individual frame values
4861 vary, then the value of
4862 <a href="#_diffrn_scan_axis.angle_increment">_diffrn_scan_axis.angle_increment</a> will be
4863 representative
4864 of the ensemble of values of
4865 <a href="#_diffrn_scan_frame_axis.angle_increment">_diffrn_scan_frame_axis.angle_increment</a> (e.g.
4866 the mean).
4867 ;
4868 _item.name '<a href="#_diffrn_scan_axis.angle_increment" >_diffrn_scan_axis.angle_increment</a>'
4869 _item.category_id diffrn_scan_axis
4870 _item.mandatory_code no
4871 _item_default.value 0.0
4872 _item_type.code float
4873 _item_units.code 'degrees'
4874 save_
4875
4876
4877 save_<a name="_diffrn_scan_axis.angle_rstrt_incr">_diffrn_scan_axis.angle_rstrt_incr</a>
4878 _item_description.description
4879 ; The increment after each step for the specified axis
4880 in degrees. In general, this will agree with
4881 <a href="#_diffrn_scan_frame_axis.angle_rstrt_incr" >_diffrn_scan_frame_axis.angle_rstrt_incr</a>. The
4882 sum of the values of <a href="#_diffrn_scan_frame_axis.angle" >_diffrn_scan_frame_axis.angle</a>,
4883 <a href="#_diffrn_scan_frame_axis.angle_increment" >_diffrn_scan_frame_axis.angle_increment</a>
4884 and <a href="#_diffrn_scan_frame_axis.angle_rstrt_incr" >_diffrn_scan_frame_axis.angle_rstrt_incr</a> is the
4885 angular setting of the axis at the start of the integration
4886 time for the next frame relative to a given frame and
4887 should equal <a href="#_diffrn_scan_frame_axis.angle" >_diffrn_scan_frame_axis.angle</a> for this
4888 next frame. If the individual frame values
4889 vary, then the value of
4890 <a href="#_diffrn_scan_axis.angle_rstrt_incr" >_diffrn_scan_axis.angle_rstrt_incr</a> will be
4891 representative
4892 of the ensemble of values of
4893 <a href="#_diffrn_scan_frame_axis.angle_rstrt_incr" >_diffrn_scan_frame_axis.angle_rstrt_incr</a> (e.g.
4894 the mean).
4895 ;
4896 _item.name '<a href="#_diffrn_scan_axis.angle_rstrt_incr">_diffrn_scan_axis.angle_rstrt_incr</a>'
4897 _item.category_id diffrn_scan_axis
4898 _item.mandatory_code no
4899 _item_default.value 0.0
4900 _item_type.code float
4901 _item_units.code 'degrees'
4902 save_
4903
4904
4905 save_<a name="_diffrn_scan_axis.displacement_start" >_diffrn_scan_axis.displacement_start</a>
4906 _item_description.description
4907 ; The starting position for the specified axis in millimetres.
4908 ;
4909 _item.name '<a href="#_diffrn_scan_axis.displacement_start" >_diffrn_scan_axis.displacement_start</a>'
4910 _item.category_id diffrn_scan_axis
4911 _item.mandatory_code no
4912 _item_default.value 0.0
4913 _item_type.code float
4914 _item_units.code 'millimetres'
4915 save_
4916
4917
4918 save_<a name="_diffrn_scan_axis.displacement_range" >_diffrn_scan_axis.displacement_range</a>
4919 _item_description.description
4920 ; The range from the starting position for the specified axis
4921 in millimetres.
4922 ;
4923 _item.name '<a href="#_diffrn_scan_axis.displacement_range" >_diffrn_scan_axis.displacement_range</a>'
4924 _item.category_id diffrn_scan_axis
4925 _item.mandatory_code no
4926 _item_default.value 0.0
4927 _item_type.code float
4928 _item_units.code 'millimetres'
4929 save_
4930
4931
4932 save_<a name="_diffrn_scan_axis.displacement_increment" >_diffrn_scan_axis.displacement_increment</a>
4933 _item_description.description
4934 ; The increment for each step for the specified axis
4935 in millimetres. In general, this will agree with
4936 <a href="#_diffrn_scan_frame_axis.displacement_increment">_diffrn_scan_frame_axis.displacement_increment</a>.
4937 The sum of the values of
4938 <a href="#_diffrn_scan_frame_axis.displacement" >_diffrn_scan_frame_axis.displacement</a> and
4939 <a href="#_diffrn_scan_frame_axis.displacement_increment" >_diffrn_scan_frame_axis.displacement_increment</a> is the
4940 angular setting of the axis at the end of the integration
4941 time for a given frame. If the individual frame values
4942 vary, then the value of
4943 <a href="#_diffrn_scan_axis.displacement_increment" >_diffrn_scan_axis.displacement_increment</a> will be
4944 representative
4945 of the ensemble of values of
4946 <a href="#_diffrn_scan_frame_axis.displacement_increment" >_diffrn_scan_frame_axis.displacement_increment</a> (e.g.
4947 the mean).
4948 ;
4949 _item.name '<a href="#_diffrn_scan_axis.displacement_increment" >_diffrn_scan_axis.displacement_increment</a>'
4950 _item.category_id diffrn_scan_axis
4951 _item.mandatory_code no
4952 _item_default.value 0.0
4953 _item_type.code float
4954 _item_units.code 'millimetres'
4955 save_
4956
4957
4958 save_<a name="_diffrn_scan_axis.displacement_rstrt_incr">_diffrn_scan_axis.displacement_rstrt_incr</a>
4959 _item_description.description
4960 ; The increment for each step for the specified axis
4961 in millimetres. In general, this will agree with
4962 <a href="#_diffrn_scan_frame_axis.displacement_rstrt_incr">_diffrn_scan_frame_axis.displacement_rstrt_incr</a>.
4963 The sum of the values of
4964 <a href="#_diffrn_scan_frame_axis.displacement" >_diffrn_scan_frame_axis.displacement</a>,
4965 <a href="#_diffrn_scan_frame_axis.displacement_increment" >_diffrn_scan_frame_axis.displacement_increment</a> and
4966 <a href="#_diffrn_scan_frame_axis.displacement_rstrt_incr" >_diffrn_scan_frame_axis.displacement_rstrt_incr</a> is the
4967 angular setting of the axis at the start of the integration
4968 time for the next frame relative to a given frame and
4969 should equal <a href="#_diffrn_scan_frame_axis.displacement" >_diffrn_scan_frame_axis.displacement</a>
4970 for this next frame. If the individual frame values
4971 vary, then the value of
4972 <a href="#_diffrn_scan_axis.displacement_rstrt_incr" >_diffrn_scan_axis.displacement_rstrt_incr</a> will be
4973 representative
4974 of the ensemble of values of
4975 <a href="#_diffrn_scan_frame_axis.displacement_rstrt_incr" >_diffrn_scan_frame_axis.displacement_rstrt_incr</a> (e.g.
4976 the mean).
4977 ;
4978 _item.name '<a href="#_diffrn_scan_axis.displacement_rstrt_incr">_diffrn_scan_axis.displacement_rstrt_incr</a>'
4979 _item.category_id diffrn_scan_axis
4980 _item.mandatory_code no
4981 _item_default.value 0.0
4982 _item_type.code float
4983 _item_units.code 'millimetres'
4984 save_
4985
4986 save_<a name="_diffrn_scan_axis.reference_angle">_diffrn_scan_axis.reference_angle</a>
4987 _item_description.description
4988 ; The setting of the specified axis in degrees
4989 against which measurements of the reference beam center
4990 and reference detector distance should be made.
4991
4992 In general, this will agree with
4993 <a href="#_diffrn_scan_frame_axis.reference_angle">_diffrn_scan_frame_axis.reference_angle</a>.
4994
4995 If the individual frame values vary, then the value of
4996 <a href="#_diffrn_scan_axis.reference_angle">_diffrn_scan_axis.reference_angle</a> will be
4997 representative of the ensemble of values of
4998 <a href="#_diffrn_scan_frame_axis.reference_angle">_diffrn_scan_frame_axis.reference_angle</a> (e.g.
4999 the mean).
5000
5001 If not specified, the value defaults to zero.
5002 ;
5003 _item.name '<a href="#_diffrn_scan_axis.reference_angle">_diffrn_scan_axis.reference_angle</a>'
5004 _item.category_id diffrn_scan_axis
5005 _item.mandatory_code implicit
5006 _item_default.value 0.0
5007 _item_type.code float
5008 _item_units.code 'degrees'
5009 save_
5010
5011
5012 save_<a name="_diffrn_scan_axis.reference_displacement">_diffrn_scan_axis.reference_displacement</a>
5013 _item_description.description
5014 ; The setting of the specified axis in millimetres
5015 against which measurements of the reference beam center
5016 and reference detector distance should be made.
5017
5018 In general, this will agree with
5019 <a href="#_diffrn_scan_frame_axis.reference_displacement">_diffrn_scan_frame_axis.reference_displacement</a>.
5020
5021 If the individual frame values vary, then the value of
5022 <a href="#_diffrn_scan_axis.reference_displacement">_diffrn_scan_axis.reference_displacement</a> will be
5023 representative of the ensemble of values of
5024 <a href="#_diffrn_scan_frame_axis.reference_displacement">_diffrn_scan_frame_axis.reference_displacement</a> (e.g.
5025 the mean).
5026
5027 If not specified, the value defaults to to the value of
5028 <a href="#">_diffrn_scan_axis.displacement</a>.
5029 ;
5030 _item.name '<a href="#_diffrn_scan_axis.reference_displacement">_diffrn_scan_axis.reference_displacement</a>'
5031 _item.category_id diffrn_scan_axis
5032 _item.mandatory_code implicit
5033 _item_type.code float
5034 _item_units.code 'millimetres'
5035 save_
5036
5037
5038
5039 #####################
5040 # <a name="DIFFRN_SCAN_FRAME">DIFFRN_SCAN_FRAME</a> #
5041 #####################
5042
5043 save_DIFFRN_SCAN_FRAME
5044 _category.description
5045 ; Data items in the <a href="#DIFFRN_SCAN_FRAME">DIFFRN_SCAN_FRAME</a> category describe
5046 the relationships of particular frames to scans.
5047 ;
5048 _category.id diffrn_scan_frame
5049 _category.mandatory_code no
5050 loop_
5051 _category_key.name
5052 '<a href="#_diffrn_scan_frame.scan_id" >_diffrn_scan_frame.scan_id</a>'
5053 '<a href="#_diffrn_scan_frame.frame_id" >_diffrn_scan_frame.frame_id</a>'
5054 loop_
5055 _category_group.id 'inclusive_group'
5056 'diffrn_group'
5057 save_
5058
5059
5060 save_<a name="_diffrn_scan_frame.date">_diffrn_scan_frame.date</a>
5061 _item_description.description
5062 ; The date and time of the start of the frame being scanned.
5063 ;
5064 _item.name '<a href="#_diffrn_scan_frame.date">_diffrn_scan_frame.date</a>'
5065 _item.category_id diffrn_scan_frame
5066 _item.mandatory_code no
5067 _item_type.code yyyy-mm-dd
5068 save_
5069
5070
5071 save_<a name="_diffrn_scan_frame.frame_id" >_diffrn_scan_frame.frame_id</a>
5072 _item_description.description
5073 ; The value of this data item is the identifier of the
5074 frame being examined.
5075
5076 This item is a pointer to <a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a> in the
5077 <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a> category.
5078 ;
5079 _item.name '<a href="#_diffrn_scan_frame.frame_id" >_diffrn_scan_frame.frame_id</a>'
5080 _item.category_id diffrn_scan_frame
5081 _item.mandatory_code yes
5082 _item_type.code code
5083 save_
5084
5085
5086 save_<a name="_diffrn_scan_frame.frame_number" >_diffrn_scan_frame.frame_number</a>
5087 _item_description.description
5088 ; The value of this data item is the number of the frame
5089 within the scan, starting with 1. It is not necessarily
5090 the same as the value of <a href="#_diffrn_scan_frame.frame_id">_diffrn_scan_frame.frame_id</a>,
5091 but it may be.
5092
5093 ;
5094 _item.name '<a href="#_diffrn_scan_frame.frame_number" >_diffrn_scan_frame.frame_number</a>'
5095 _item.category_id diffrn_scan_frame
5096 _item.mandatory_code no
5097 _item_type.code int
5098 loop_
5099 _item_range.maximum
5100 _item_range.minimum
5101 . 0
5102 0 0
5103 save_
5104
5105
5106 save_<a name="_diffrn_scan_frame.integration_time">_diffrn_scan_frame.integration_time</a>
5107 _item_description.description
5108 ; The time in seconds to integrate this step of the scan.
5109 This should be the precise time of integration of each
5110 particular frame. The value of this data item should
5111 be given explicitly for each frame and not inferred
5112 from the value of <a href="#_diffrn_scan.integration_time" >_diffrn_scan.integration_time</a>.
5113 ;
5114 _item.name '<a href="#_diffrn_scan_frame.integration_time" >_diffrn_scan_frame.integration_time</a>'
5115 _item.category_id diffrn_scan_frame
5116 _item.mandatory_code yes
5117 _item_type.code float
5118 _item_units.code 'seconds'
5119 loop_
5120 _item_range.maximum
5121 _item_range.minimum
5122 . 0.0
5123 save_
5124
5125
5126 save_<a name="_diffrn_scan_frame.scan_id" >_diffrn_scan_frame.scan_id</a>
5127 _item_description.description
5128 ; The value of <a href="#_diffrn_scan_frame.scan_id" >_diffrn_scan_frame.scan_id</a> identifies the scan
5129 containing this frame.
5130
5131 This item is a pointer to <a href="#_diffrn_scan.id" >_diffrn_scan.id</a> in the
5132 <a href="#DIFFRN_SCAN">DIFFRN_SCAN</a> category.
5133 ;
5134 _item.name '<a href="#_diffrn_scan_frame.scan_id">_diffrn_scan_frame.scan_id</a>'
5135 _item.category_id diffrn_scan_frame
5136 _item.mandatory_code yes
5137 _item_type.code code
5138 save_
5139
5140
5141 ##########################
5142 # <a name="DIFFRN_SCAN_FRAME_AXIS">DIFFRN_SCAN_FRAME_AXIS</a> #
5143 ##########################
5144
5145 save_DIFFRN_SCAN_FRAME_AXIS
5146 _category.description
5147 ; Data items in the <a href="#DIFFRN_SCAN_FRAME_AXIS">DIFFRN_SCAN_FRAME_AXIS</a> category describe the
5148 settings of axes for particular frames. Unspecified axes are
5149 assumed to be at their zero points. If, for any given frame,
5150 nonzero values apply for any of the data items in this category,
5151 those values should be given explicitly in this category and not
5152 simply inferred from values in <a href="#DIFFRN_SCAN_AXIS">DIFFRN_SCAN_AXIS</a>.
5153 ;
5154 _category.id diffrn_scan_frame_axis
5155 _category.mandatory_code no
5156 loop_
5157 _category_key.name
5158 '<a href="#_diffrn_scan_frame_axis.frame_id" >_diffrn_scan_frame_axis.frame_id</a>'
5159 '<a href="#_diffrn_scan_frame_axis.axis_id" >_diffrn_scan_frame_axis.axis_id</a>'
5160 loop_
5161 _category_group.id 'inclusive_group'
5162 'diffrn_group'
5163 save_
5164
5165
5166 save_<a name="_diffrn_scan_frame_axis.axis_id" >_diffrn_scan_frame_axis.axis_id</a>
5167 _item_description.description
5168 ; The value of this data item is the identifier of one of
5169 the axes for the frame for which settings are being specified.
5170
5171 Multiple axes may be specified for the same value of
5172 <a href="#_diffrn_scan_frame.id" >_diffrn_scan_frame.frame_id</a>.
5173
5174 This item is a pointer to <a href="#_axis.id" >_axis.id</a> in the
5175 <a href="#AXIS">AXIS</a> category.
5176 ;
5177 _item.name '<a href="#_diffrn_scan_frame_axis.axis_id" >_diffrn_scan_frame_axis.axis_id</a>'
5178 _item.category_id diffrn_scan_frame_axis
5179 _item.mandatory_code yes
5180 _item_type.code code
5181 save_
5182
5183
5184 save_<a name="_diffrn_scan_frame_axis.angle" >_diffrn_scan_frame_axis.angle</a>
5185 _item_description.description
5186 ; The setting of the specified axis in degrees for this frame.
5187 This is the setting at the start of the integration time.
5188 ;
5189 _item.name '<a href="#_diffrn_scan_frame_axis.angle" >_diffrn_scan_frame_axis.angle</a>'
5190 _item.category_id diffrn_scan_frame_axis
5191 _item.mandatory_code no
5192 _item_default.value 0.0
5193 _item_type.code float
5194 _item_units.code 'degrees'
5195 save_
5196
5197
5198 save_<a name="_diffrn_scan_frame_axis.angle_increment">_diffrn_scan_frame_axis.angle_increment</a>
5199 _item_description.description
5200 ; The increment for this frame for the angular setting of
5201 the specified axis in degrees. The sum of the values
5202 of <a href="#_diffrn_scan_frame_axis.angle">_diffrn_scan_frame_axis.angle</a> and
5203 <a href="#_diffrn_scan_frame_axis.angle_increment">_diffrn_scan_frame_axis.angle_increment</a> is the
5204 angular setting of the axis at the end of the integration
5205 time for this frame.
5206 ;
5207 _item.name '<a href="#_diffrn_scan_frame_axis.angle_increment">_diffrn_scan_frame_axis.angle_increment</a>'
5208 _item.category_id diffrn_scan_frame_axis
5209 _item.mandatory_code no
5210 _item_default.value 0.0
5211 _item_type.code float
5212 _item_units.code 'degrees'
5213 save_
5214
5215
5216 save_<a name="_diffrn_scan_frame_axis.angle_rstrt_incr">_diffrn_scan_frame_axis.angle_rstrt_incr</a>
5217 _item_description.description
5218 ; The increment after this frame for the angular setting of
5219 the specified axis in degrees. The sum of the values
5220 of <a href="#_diffrn_scan_frame_axis.angle">_diffrn_scan_frame_axis.angle</a>,
5221 <a href="#_diffrn_scan_frame_axis.angle_increment">_diffrn_scan_frame_axis.angle_increment</a> and
5222 <a href="#_diffrn_scan_frame_axis.angle_rstrt_incr">_diffrn_scan_frame_axis.angle_rstrt_incr</a> is the
5223 angular setting of the axis at the start of the integration
5224 time for the next frame and should equal
5225 <a href="#_diffrn_scan_frame_axis.angle">_diffrn_scan_frame_axis.angle</a> for this next frame.
5226 ;
5227 _item.name '<a href="#_diffrn_scan_frame_axis.angle_rstrt_incr">_diffrn_scan_frame_axis.angle_rstrt_incr</a>'
5228 _item.category_id diffrn_scan_frame_axis
5229 _item.mandatory_code no
5230 _item_default.value 0.0
5231 _item_type.code float
5232 _item_units.code 'degrees'
5233 save_
5234
5235
5236 save_<a name="_diffrn_scan_frame_axis.displacement" >_diffrn_scan_frame_axis.displacement</a>
5237 _item_description.description
5238 ; The setting of the specified axis in millimetres for this
5239 frame. This is the setting at the start of the integration
5240 time.
5241 ;
5242 _item.name '<a href="#_diffrn_scan_frame_axis.displacement" >_diffrn_scan_frame_axis.displacement</a>'
5243 _item.category_id diffrn_scan_frame_axis
5244 _item.mandatory_code no
5245 _item_default.value 0.0
5246 _item_type.code float
5247 _item_units.code 'millimetres'
5248 save_
5249
5250
5251 save_<a name="_diffrn_scan_frame_axis.displacement_increment">_diffrn_scan_frame_axis.displacement_increment</a>
5252 _item_description.description
5253 ; The increment for this frame for the displacement setting of
5254 the specified axis in millimetres. The sum of the values
5255 of <a href="#_diffrn_scan_frame_axis.displacement">_diffrn_scan_frame_axis.displacement</a> and
5256 <a href="#_diffrn_scan_frame_axis.displacement_increment">_diffrn_scan_frame_axis.displacement_increment</a> is the
5257 angular setting of the axis at the end of the integration
5258 time for this frame.
5259 ;
5260 _item.name '<a href="#_diffrn_scan_frame_axis.displacement_increment">_diffrn_scan_frame_axis.displacement_increment</a>'
5261 _item.category_id diffrn_scan_frame_axis
5262 _item.mandatory_code no
5263 _item_default.value 0.0
5264 _item_type.code float
5265 _item_units.code 'millimetres'
5266 save_
5267
5268
5269 save_<a name="_diffrn_scan_frame_axis.displacement_rstrt_incr">_diffrn_scan_frame_axis.displacement_rstrt_incr</a>
5270 _item_description.description
5271 ; The increment for this frame for the displacement setting of
5272 the specified axis in millimetres. The sum of the values
5273 of <a href="#_diffrn_scan_frame_axis.displacement">_diffrn_scan_frame_axis.displacement</a>,
5274 <a href="#_diffrn_scan_frame_axis.displacement_increment">_diffrn_scan_frame_axis.displacement_increment</a> and
5275 <a href="#_diffrn_scan_frame_axis.displacement_rstrt_incr">_diffrn_scan_frame_axis.displacement_rstrt_incr</a> is the
5276 angular setting of the axis at the start of the integration
5277 time for the next frame and should equal
5278 <a href="#_diffrn_scan_frame_axis.displacement">_diffrn_scan_frame_axis.displacement</a> for this next frame.
5279 ;
5280 _item.name '<a href="#_diffrn_scan_frame_axis.displacement_rstrt_incr">_diffrn_scan_frame_axis.displacement_rstrt_incr</a>'
5281 _item.category_id diffrn_scan_frame_axis
5282 _item.mandatory_code no
5283 _item_default.value 0.0
5284 _item_type.code float
5285 _item_units.code 'millimetres'
5286 save_
5287
5288 save_<a name="_diffrn_scan_frame_axis.frame_id" >_diffrn_scan_frame_axis.frame_id</a>
5289 _item_description.description
5290 ; The value of this data item is the identifier of the
5291 frame for which axis settings are being specified.
5292
5293 Multiple axes may be specified for the same value of
5294 <a href="#_diffrn_scan_frame.frame_id" >_diffrn_scan_frame.frame_id</a>.
5295
5296 This item is a pointer to <a href="#_diffrn_data_frame.id" >_diffrn_data_frame.id</a> in the
5297 <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a> category.
5298 ;
5299 _item.name '<a href="#_diffrn_scan_frame_axis.frame_id" >_diffrn_scan_frame_axis.frame_id</a>'
5300 _item.category_id diffrn_scan_frame_axis
5301 _item.mandatory_code yes
5302 _item_type.code code
5303 save_
5304
5305 save_<a name="_diffrn_scan_frame_axis.reference_angle" >_diffrn_scan_frame_axis.reference_angle</a>
5306 _item_description.description
5307 ; The setting of the specified axis in degrees
5308 against which measurements of the reference beam center
5309 and reference detector distance should be made.
5310
5311 This is normally the same for all frames, but the
5312 option is provided here of making changes when
5313 needed.
5314
5315 If not provided, it is assumed to be zero.
5316 ;
5317 _item.name '<a href="#_diffrn_scan_frame_axis.reference_angle">_diffrn_scan_frame_axis.reference_angle</a>'
5318 _item.category_id diffrn_scan_frame_axis
5319 _item.mandatory_code implicit
5320 _item_default.value 0.0
5321 _item_type.code float
5322 _item_units.code 'degrees'
5323 save_
5324
5325
5326 save_<a name="_diffrn_scan_frame_axis.reference_displacement">_diffrn_scan_frame_axis.reference_displacement</a>
5327 _item_description.description
5328 ; The setting of the specified axis in millimetres for this
5329 frame against which measurements of the reference beam center
5330 and reference detector distance should be made.
5331
5332 This is normally the same for all frames, but the
5333 option is provided here of making changes when
5334 needed.
5335
5336 If not provided, it is assumed to be equal to
5337 <a href="#_diffrn_scan_frame_axis.displacement" >_diffrn_scan_frame_axis.displacement</a>.
5338 ;
5339 _item.name '<a href="#_diffrn_scan_frame_axis.reference_displacement">_diffrn_scan_frame_axis.reference_displacement</a>'
5340 _item.category_id diffrn_scan_frame_axis
5341 _item.mandatory_code implicit
5342 _item_type.code float
5343 _item_units.code 'millimetres'
5344 save_
5345
5346
5347
5348 #######
5349 # <a name="MAP">MAP</a> #
5350 #######
5351
5352 save_MAP
5353 _category.description
5354 ; Data items in the <a href="#MAP">MAP</a> category record
5355 the details of a maps. Maps record values of parameters,
5356 such as density, that are functions of position within
5357 a cell or are functions of orthogonal coordinates in
5358 three space.
5359
5360 A map may is composed of one or more map segments
5361 specified in the MAP_SEGMENT category.
5362
5363 Examples are given in the MAP_SEGMENT category.
5364 ;
5365 _category.id map
5366 _category.mandatory_code no
5367 loop_
5368 _category_key.name '<a href="#_map.id" >_map.id</a>'
5369 '<a href="#_map.diffrn_id" >_map.diffrn_id</a>'
5370 '<a href="#_map.entry_id" >_map.entry_id</a>'
5371 loop_
5372 _category_group.id 'inclusive_group'
5373 'array_data_group'
5374 loop_
5375 _category_examples.detail
5376 _category_examples.case
5377 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
5378 ; Example 1 - Identifying an observed density map
5379 and a calculated density map
5380 ;
5381 ;
5382
5383 loop_
5384 <a href="#_map.id" >_map.id</a>
5385 <a href="#_map.details" >_map.details</a>
5386
5387 rho_calc
5388 ;
5389 density calculated from F_calc derived from the ATOM_SITE list
5390 ;
5391 rho_obs
5392 ;
5393 density combining the observed structure factors with the
5394 calculated phases
5395 ;
5396 ;
5397
5398 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
5399 save_
5400
5401
5402 save_<a name="_map.details" >_map.details</a>
5403 _item_description.description
5404 ; The value of <a href="#_map.details" >_map.details</a> should give a
5405 description of special aspects of each map.
5406
5407 ;
5408 _item.name '<a name="_map.details" >_map.details</a>'
5409 _item.category_id map
5410 _item.mandatory_code no
5411 _item_type.code text
5412 loop_
5413 _item_examples.case
5414 _item_examples.detail
5415 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
5416 ; Example 1 - Identifying an observed density map
5417 and a calculated density map
5418 ;
5419 ;
5420
5421 loop_
5422 <a href="#_map.id" >_map.id</a>
5423 <a href="#_map.details" >_map.details</a>
5424
5425 rho_calc
5426 ;
5427 density calculated from F_calc derived from the ATOM_SITE list
5428 ;
5429 rho_obs
5430 ;
5431 density combining the observed structure factors with the
5432 calculated phases
5433 ;
5434 ;
5435
5436 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
5437 save_
5438
5439 save_<a name="_map.diffrn_id" >_map.diffrn_id</a>
5440 _item_description.description
5441 ; This item is a pointer to <a href="#_diffrn.id" >_diffrn.id</a> in the
5442 <a href="#DIFFRN">DIFFRN</a> category.
5443 ;
5444 _item.name '<a href="#_map.diffrn_id" >_map.diffrn_id</a>'
5445 _item.category_id map
5446 _item.mandatory_code implicit
5447 _item_type.code code
5448 save_
5449
5450 save_<a name="_map.entry_id" >_map.entry_id</a>
5451 _item_description.description
5452 ; This item is a pointer to <a href="#_entry.id" >_entry.id</a> in the
5453 <a href="#ENTRY">ENTRY</a> category.
5454 ;
5455 _item.name '<a href="#_map.entry_id" >_map.entry_id</a>'
5456 _item.category_id map
5457 _item.mandatory_code implicit
5458 _item_type.code code
5459 save_
5460
5461
5462 save_<a name="_map.id" >_map.id</a>
5463 _item_description.description
5464 ; The value of <a href="#_map.id" >_map.id</a> must uniquely identify
5465 each map for the given diffrn.id or entry.id.
5466 ;
5467 loop_
5468 _item.name
5469 _item.category_id
5470 _item.mandatory_code
5471 '<a href="#_map.id" >_map.id</a>' map yes
5472 '<a href="#_map_segment.id" >_map_segment.id</a>' map_segment yes
5473 _item_type.code code
5474 loop_
5475 _item_linked.child_name
5476 _item_linked.parent_name
5477 '<a href="#_map_segment.id" >_map_segment.id</a>' '<a href="#_map.id" >_map.id</a>'
5478 save_
5479
5480
5481
5482
5483 ###########################
5484 # <a name="MAP_SEGMENT">MAP_SEGMENT</a> #
5485 ###########################
5486
5487
5488 save_MAP_SEGMENT
5489 _category.description
5490 ; Data items in the <a href="#MAP_SEGMENT">MAP_SEGMENT</a> category record
5491 the details about each segment (section or brick) of a map.
5492 ;
5493 _category.id map_segment
5494 _category.mandatory_code no
5495 loop_
5496 _category_key.name '<a href="#_map_segment.id" >_map_segment.id</a>'
5497 '<a href="#_map_segment.map_id" >_map_segment.map_id</a>'
5498 loop_
5499 _category_group.id 'inclusive_group'
5500 'array_data_group'
5501 loop_
5502 _category_examples.detail
5503 _category_examples.case
5504 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
5505 ; Example 1 - Identifying an observed density map
5506 and a calculated density map, each consisting of one
5507 segment, both using the same array structure
5508 and mask.
5509 ;
5510 ;
5511
5512 loop_
5513 <a href="#_map.id" >_map.id</a>
5514 <a href="#_map.details" >_map.details</a>
5515
5516 rho_calc
5517 ;
5518 density calculated from F_calc derived from the ATOM_SITE list
5519 ;
5520 rho_obs
5521 ;
5522 density combining the observed structure factors with the
5523 calculated phases
5524 ;
5525
5526 loop_
5527 _map_segment.map_id
5528 _map_segment.id
5529 _map_segment.array_id
5530 _map_segment.binary_id
5531 _map_segment.mask_array_id
5532 _map_segment.mask_binary_id
5533 rho_calc rho_calc map_structure 1 mask_structure 1
5534 rho_obs rho_obs map_structure 2 mask_structure 1
5535 ;
5536
5537 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
5538 save_
5539
5540
5541 save_<a name="_map_segment.array_id" >_map_segment.array_id</a>
5542 _item_description.description
5543 ; The value of _map_segment.array_id identifies the array
5544 structure into which the map is organized.
5545
5546 This item is a pointer to <a href="#_array_structure.id" >_array_structure.id</a> in the
5547 <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a> category.
5548 ;
5549 _item.name '<a href="#_map_segement.array_id" >_map_segment.array_id</a>'
5550 _item.category_id map_segment
5551 _item.mandatory_code implicit
5552 _item_type.code code
5553 save_
5554
5555
5556 save_<a name="_map_segment.binary_id" >_map_segment.binary_id</a>
5557 _item_description.description
5558 ; The value of <a href="#_map_segment.binary_id">_map_segment.binary_id</a> distinguishes the particular
5559 set of data organized according to <a href="#_map_segment.mask_array_id">_map_segment.array_id</a> in
5560 which the data values of the map are stored.
5561
5562 This item is a pointer to <a href="#_array_data.binary_id" >_array_data.binary_id</a> in the
5563 <a href="#ARRAY_DATA">ARRAY_DATA</a> category.
5564 ;
5565 _item.name '<a href="#_map_segment.binary_id" >_map_segment.binary_id</a>'
5566 _item.category_id map_segment
5567 _item.mandatory_code implicit
5568 _item_type.code int
5569 save_
5570
5571 save_<a name="_map_segment.mask_array_id" >_map_segment.mask_array_id</a>
5572 _item_description.description
5573 ; The value of <a href="#_map_segment.mask_array_id">_map_segment.mask_array_id</a>, if given, the array
5574 structure into which the mask for the map is organized. If no
5575 value is given, then all elements of the map are valid. If a
5576 value is given, then only elements of the map for which the
5577 corresponding element of the mask is non-zero are valid. The
5578 value of <a href="#_map_segment.mask_array_id">_map_segment.mask_array_id</a> differs from the value of
5579 <a href="#_map_segment.array_id">_map_segment.array_id</a> in order to permit the mask to be given
5580 as, say, unsigned 8-bit integers, while the map is given as
5581 a data type with more range. However, the two array structures
5582 must be aligned, using the same axes in the same order with the
5583 same displacements and increments
5584
5585 This item is a pointer to <a href="#_array_structure.id" >_array_structure.id</a> in the
5586 <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a> category.
5587 ;
5588 _item.name '<a href="#_map_segment.mask_array_id" >_map_segment.mask_array_id</a>'
5589 _item.category_id map_segment
5590 _item.mandatory_code implicit
5591 _item_type.code code
5592 save_
5593
5594
5595 save_<a name="_map_segment.mask_binary_id" >_map_segment.mask_binary_id</a>
5596 _item_description.description
5597 ; The value of <a href="#_map_segment.mask_binary_id">_map_segment.mask_binary_id</a> identifies the
5598 particular set of data organized according to
5599 _map_segment.mask_array_id specifying the mask for the map.
5600
5601 This item is a pointer to <a href="#_array_data.mask_binary_id" >_array_data.mask_binary_id</a> in the
5602 <a href="#ARRAY_DATA">ARRAY_DATA</a> category.
5603 ;
5604 _item.name '<a href="#_map_segment.mask_binary_id" >_map_segment.mask_binary_id</a>'
5605 _item.category_id map_segment
5606 _item.mandatory_code implicit
5607 _item_type.code int
5608 save_
5609
5610
5611 save_<a name="_map_segment.id" >_map_segment.id</a>
5612 _item_description.description
5613 ; The value of <a href="#_map_segment.id" >_map_segment.id</a> must uniquely
5614 identify each segment of a map.
5615 ;
5616 loop_
5617 _item.name
5618 _item.category_id
5619 _item.mandatory_code
5620 '<a href="#_map_segment.id" >_map_segment.id</a>'
5621 map_segment
5622 yes
5623 _item_type.code code
5624 loop_
5625 _item_linked.child_name
5626 _item_linked.parent_name
5627 '<a href="#_map_data_frame.map_segment_id" >_map_data_frame.map_segment_id</a>'
5628 '<a href="#_map_segment.id" >_map_segment.id</a>'
5629
5630 save_
5631
5632
5633 save_<a name="_map_segment.map_id" >_map_segment.map_id</a>
5634 _item_description.description
5635 ; This item is a pointer to <a href="#_map.id" >_map.id</a>
5636 in the <a href="#MAP">MAP</a> category.
5637 ;
5638 _item.name '<a href="#_map_segment.map_id" >_map_segment.map_id</a>'
5639 _item.category_id map_segment
5640 _item.mandatory_code yes
5641 _item_type.code code
5642 save_
5643
5644 save_<a name="_map_segment.details" >_map_segment.details</a>
5645 _item_description.description
5646 ; The value of <a href="#_map_segment.details" >_map_segment.details</a> should give a
5647 description of special aspects of each segment of a map.
5648
5649 ;
5650 _item.name '<a name="_map_segment.details" >_map_segment.details</a>'
5651 _item.category_id map_segment
5652 _item.mandatory_code no
5653 _item_type.code text
5654 loop_
5655 _item_examples.case
5656 _item_examples.detail
5657 ; Example to be provided
5658 ;
5659 ;
5660
5661 ;
5662 save_
5663
5664
5665 ######################## DEPRECATED DATA ITEMS ########################
5666
5667 save_<a name="_diffrn_detector_axis.id">_diffrn_detector_axis.id</a>
5668 _item_description.description
5669 ; This data item is a pointer to <a href="#_diffrn_detector.id">_diffrn_detector.id</a> in
5670 the <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a> category.
5671
5672 DEPRECATED -- DO NOT USE
5673 ;
5674 _item.name '<a href="#_diffrn_detector_axis.id">_diffrn_detector_axis.id</a>'
5675 _item.category_id diffrn_detector_axis
5676 _item.mandatory_code yes
5677 _item_type.code code
5678 save_
5679
5680 save_<a name="_diffrn_detector_element.center[1]" >_diffrn_detector_element.center[1]</a>
5681 _item_description.description
5682 ; The value of <a href="#_diffrn_detector_element.center[1]" >_diffrn_detector_element.center[1]</a> is the <b>X</b>
5683 component of the distortion-corrected beam centre in
5684 millimetres from the (0, 0) (lower-left) corner of the
5685 detector element viewed from the sample side.
5686
5687 The <b>X</b> and <b>Y</b> axes are the laboratory coordinate system
5688 coordinates defined in the <a href="#AXIS">AXIS category</a> measured
5689 when all positioning axes for the detector are at their zero
5690 settings. If the resulting <b>X</b> or <b>Y</b> axis is then orthogonal to the
5691 detector, the <b>Z</b> axis is used instead of the orthogonal axis.
5692
5693 Because of ambiguity about the setting used to determine this
5694 center, use of this data item is deprecated. The data item
5695 <a href="#_diffrn_data_frame.center_fast">_diffrn_data_frame.center_fast</a>
5696 which is referenced to the detector coordinate system and not
5697 directly to the laboratory coordinate system should be used
5698 instead.
5699
5700 ;
5701 _item.name '<a href="#_diffrn_detector_element.center[1]" >_diffrn_detector_element.center[1]</a>'
5702 _item.category_id diffrn_detector_element
5703 _item.mandatory_code no
5704 _item_default.value 0.0
5705 _item_sub_category.id vector
5706 _item_type.code float
5707 _item_units.code millimetres
5708
5709 save_
5710
5711
5712 save_<a name="_diffrn_detector_element.center[2]" >_diffrn_detector_element.center[2]</a>
5713 _item_description.description
5714 ; The value of <a href="#_diffrn_detector_element.center[2]" >_diffrn_detector_element.center[2]</a> is the <b>Y</b>
5715 component of the distortion-corrected beam centre in
5716 millimetres from the (0, 0) (lower-left) corner of the
5717 detector element viewed from the sample side.
5718
5719 The <b>X</b> and <b>Y</b> axes are the laboratory coordinate system
5720 coordinates defined in the <a href="#AXIS">AXIS category</a> measured
5721 when all positioning axes for the detector are at their zero
5722 settings. If the resulting <b>X</b> or <b>Y</b> axis is then orthogonal to the
5723 detector, the <b>Z</b> axis is used instead of the orthogonal axis.
5724
5725 Because of ambiguity about the setting used to determine this
5726 center, use of this data item is deprecated. The data item
5727 <a href="#_diffrn_data_frame.center_slow">_diffrn_data_frame.center_slow</a>
5728 which is referenced to the detector coordinate system and not
5729 directly to the laboratory coordinate system should be used
5730 instead.
5731
5732 ;
5733 _item.name '<a href="#_diffrn_detector_element.center[2]" >_diffrn_detector_element.center[2]</a>'
5734 _item.category_id diffrn_detector_element
5735 _item.mandatory_code no
5736 _item_default.value 0.0
5737 _item_sub_category.id vector
5738 _item_type.code float
5739 _item_units.code millimetres
5740
5741 save_
5742
5743
5744
5745 save_<a name="_diffrn_measurement_axis.id">_diffrn_measurement_axis.id</a>
5746 _item_description.description
5747 ; This data item is a pointer to <a href="#_diffrn_measurement.id">_diffrn_measurement.id</a> in
5748 the <a href="#DIFFRN_MEASUREMENT">DIFFRN_MEASUREMENT</a> category.
5749
5750 DEPRECATED -- DO NOT USE
5751 ;
5752 _item.name '<a href="#_diffrn_measurement_axis.id">_diffrn_measurement_axis.id</a>'
5753 _item.category_id diffrn_measurement_axis
5754 _item.mandatory_code yes
5755 _item_type.code code
5756 save_
5757
5758 ######################### DEPRECATED CATEGORY #########################
5759 #####################
5760 # <a name="DIFFRN_FRAME_DATA" >DIFFRN_FRAME_DATA</a> #
5761 #####################
5762
5763
5764 save_DIFFRN_FRAME_DATA
5765 _category.description
5766 ; Data items in the DIFFRN_FRAME_DATA category record
5767 the details about each frame of data.
5768
5769 The items in this category are now in the
5770 <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a> category.
5771
5772 The items in the DIFFRN_FRAME_DATA category
5773 are now deprecated. The items from this category
5774 are provided as aliases in the 1.0 dictionary
5775 or, in the case of _diffrn_frame_data.details,
5776 in the 1.4 dictionary. THESE ITEMS SHOULD NOT
5777 BE USED FOR NEW WORK.
5778
5779 The items from the old category are provided
5780 in this dictionary for completeness
5781 but should not be used or cited. To avoid
5782 confusion, the example has been removed
5783 and the redundant parent-child links to other
5784 categories have been removed.
5785 ;
5786 _category.id diffrn_frame_data
5787 _category.mandatory_code no
5788 loop_
5789 _category_key.name '<a href="#_diffrn_frame_data.id" >_diffrn_frame_data.id</a>'
5790 '<a href="#_diffrn_frame_data.detector_element_id" >_diffrn_frame_data.detector_element_id</a>'
5791 loop_
5792 _category_group.id 'inclusive_group'
5793 'array_data_group'
5794 loop_
5795 _category_examples.detail
5796 _category_examples.case
5797 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
5798 ;
5799 THE DIFFRN_FRAME_DATA category is deprecated and should not be used.
5800 ;
5801 ;
5802 # EXAMPLE REMOVED #
5803 ;
5804 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
5805 save_
5806
5807
5808 save_<a name="_diffrn_frame_data.array_id" >_diffrn_frame_data.array_id</a>
5809 _item_description.description
5810 ; This item is a pointer to <a href="#_array_structure.id" >_array_structure.id</a> in the
5811 ARRAY_STRUCTURE category.
5812
5813 DEPRECATED -- DO NOT USE
5814 ;
5815 _item.name '<a href="#_diffrn_frame_data.array_id" >_diffrn_frame_data.array_id</a>'
5816 _item.category_id diffrn_frame_data
5817 _item.mandatory_code implicit
5818 _item_type.code code
5819 save_
5820
5821
5822 save_<a name="_diffrn_frame_data.binary_id" >_diffrn_frame_data.binary_id</a>
5823 _item_description.description
5824 ; This item is a pointer to <a href="#_array_data.binary_id" >_array_data.binary_id</a> in the
5825 ARRAY_STRUCTURE category.
5826
5827 DEPRECATED -- DO NOT USE
5828 ;
5829 _item.name '<a href="#_diffrn_frame_data.binary_id" >_diffrn_frame_data.binary_id</a>'
5830 _item.category_id diffrn_frame_data
5831 _item.mandatory_code implicit
5832 _item_type.code int
5833 save_
5834
5835
5836 save_<a name="_diffrn_frame_data.detector_element_id" >_diffrn_frame_data.detector_element_id</a>
5837 _item_description.description
5838 ; This item is a pointer to <a href="#_diffrn_detector_element.id">_diffrn_detector_element.id</a>
5839 in the DIFFRN_DETECTOR_ELEMENT category.
5840
5841 DEPRECATED -- DO NOT USE
5842 ;
5843 _item.name '<a href="#_diffrn_frame_data.detector_element_id" >_diffrn_frame_data.detector_element_id</a>'
5844 _item.category_id diffrn_frame_data
5845 _item.mandatory_code yes
5846 _item_type.code code
5847 save_
5848
5849
5850 save_<a name="_diffrn_frame_data.id" >_diffrn_frame_data.id</a>
5851 _item_description.description
5852 ; The value of <a href="#_diffrn_frame_data.id" >_diffrn_frame_data.id</a> must uniquely identify
5853 each complete frame of data.
5854
5855 DEPRECATED -- DO NOT USE
5856 ;
5857 loop_
5858 _item.name
5859 _item.category_id
5860 _item.mandatory_code
5861 '<a href="#_diffrn_frame_data.id" >_diffrn_frame_data.id</a>' diffrn_frame_data yes
5862 _item_type.code code
5863 save_
5864
5865 save_<a name="_diffrn_frame_data.details" >_diffrn_frame_data.details</a>
5866 _item_description.description
5867 ; The value of <a href="#_diffrn_data_frame.details" >_diffrn_data_frame.details</a> should give a
5868 description of special aspects of each frame of data.
5869
5870 DEPRECATED -- DO NOT USE
5871 ;
5872 _item.name '<a name="_diffrn_frame_data.details" >_diffrn_frame_data.details</a>'
5873 _item.category_id diffrn_frame_data
5874 _item.mandatory_code no
5875 _item_type.code text
5876 save_
5877
5878 ################ END DEPRECATED SECTION ###########
5879
5880
5881 ####################
5882 ## <a name="ITEM_TYPE_LIST">ITEM_TYPE_LIST</a> ##
5883 ####################
5884 #
5885 #
5886 # The regular expressions defined here are not compliant
5887 # with the POSIX 1003.2 standard as they include the
5888 # '\n' and '\t' special characters. These regular expressions
5889 # have been tested using version 0.12 of Richard Stallman's
5890 # GNU regular expression library in POSIX mode.
5891 # In order to allow presentation of a regular expression
5892 # in a text field concatenate any line ending in a backslash
5893 # with the following line, after discarding the backslash.
5894 #
5895 # A formal definition of the '\n' and '\t' special characters
5896 # is most properly done in the DDL, but for completeness, please
5897 # note that '\n' is the line termination character ('newline')
5898 # and '\t' is the horizontal tab character. There is a formal
5899 # ambiguity in the use of '\n' for line termination, in that
5900 # the intention is that the equivalent machine/OS-dependent line
5901 # termination character sequence should be accepted as a match, e.g.
5902 #
5903 # '\r' (control-M) under MacOS
5904 # '\n' (control-J) under Unix
5905 # '\r\n' (control-M control-J) under DOS and MS Windows
5906 #
5907 loop_
5908 _item_type_list.code
5909 _item_type_list.primitive_code
5910 _item_type_list.construct
5911 _item_type_list.detail
5912 code char
5913 '[_,.;:&quot;&amp;&lt;&gt;()/\{}'`~!@#$%A-Za-z0-9*|+-]*'
5914 ; code item types/single words ...
5915 ;
5916 ucode uchar
5917 '[_,.;:&quot;&amp;&lt;&gt;()/\{}'`~!@#$%A-Za-z0-9*|+-]*'
5918 ; code item types/single words (case insensitive) ...
5919 ;
5920 line char
5921 '[][ \t_(),.;:&quot;&amp;&lt;&gt;/\{}'`~!@#$%?+=*A-Za-z0-9|^-]*'
5922 ; char item types / multi-word items ...
5923 ;
5924 uline uchar
5925 '[][ \t_(),.;:&quot;&amp;&lt;&gt;/\{}'`~!@#$%?+=*A-Za-z0-9|^-]*'
5926 ; char item types / multi-word items (case insensitive)...
5927 ;
5928 text char
5929 '[][ \n\t()_,.;:&quot;&amp;&lt;&gt;/\{}'`~!@#$%?+=*A-Za-z0-9|^-]*'
5930 ; text item types / multi-line text ...
5931 ;
5932 binary char
5933 ;\n--CIF-BINARY-FORMAT-SECTION--\n\
5934 [][ \n\t()_,.;:&quot;&amp;&lt;&gt;/\{}'`~!@#$%?+=*A-Za-z0-9|^-]*\
5935 \n--CIF-BINARY-FORMAT-SECTION----
5936 ;
5937 ; binary items are presented as MIME-like ascii-encoded
5938 sections in an imgCIF. In a CBF, raw octet streams
5939 are used to convey the same information.
5940 ;
5941 int numb
5942 '-?[0-9]+'
5943 ; int item types are the subset of numbers that are the negative
5944 or positive integers.
5945 ;
5946 float numb
5947 '-?(([0-9]+)[.]?|([0-9]*[.][0-9]+))([(][0-9]+[)])?([eE][+-]?[0-9]+)?'
5948 ; float item types are the subset of numbers that are the floating
5949 point numbers.
5950 ;
5951 any char
5952 '.*'
5953 ; A catch all for items that may take any form...
5954 ;
5955 yyyy-mm-dd char
5956 ;\
5957 [0-9]?[0-9]?[0-9][0-9]-[0-9]?[0-9]-[0-9]?[0-9]\
5958 ((T[0-2][0-9](:[0-5][0-9](:[0-5][0-9](.[0-9]+)?)?)?)?\
5959 ([+-][0-5][0-9]:[0-5][0-9]))?
5960 ;
5961 ;
5962 Standard format for CIF date and time strings (see
5963 http://www.iucr.org/iucr-top/cif/spec/datetime.html),
5964 consisting of a yyyy-mm-dd date optionally followed by
5965 the character 'T' followed by a 24-hour clock time,
5966 optionally followed by a signed time-zone offset.
5967
5968 The IUCr standard has been extended to allow for an optional
5969 decimal fraction on the seconds of time.
5970
5971 Time is local time if no time-zone offset is given.
5972
5973 Note that this type extends the mmCIF yyyy-mm-dd type
5974 but does not conform to the mmCIF yyyy-mm-dd:hh:mm
5975 type that uses a ':' in place if the 'T' specified
5976 by the IUCr standard. For reading, both forms should
5977 be accepted, but for writing, only the IUCr form should
5978 be used.
5979
5980 For maximal compatibility, the special time zone
5981 indicator 'Z' (for 'zulu') should be accepted on
5982 reading in place of '+00:00' for GMT.
5983 ;
5984
5985
5986 #####################
5987 ## <a name="ITEM_UNITS_LIST">ITEM_UNITS_LIST</a> ##
5988 #####################
5989
5990 loop_
5991 _item_units_list.code
5992 _item_units_list.detail
5993 #
5994 'metres' 'metres'
5995 'centimetres' 'centimetres (metres * 10^<sup>( -2)</sup>^)'
5996 'millimetres' 'millimetres (metres * 10^<sup>( -3)</sup>^)'
5997 'nanometres' 'nanometres (metres * 10^<sup>( -9)</sup>^)'
5998 'angstroms' '\%Angstroms (metres * 10^<sup>(-10)</sup>^)'
5999 'picometres' 'picometres (metres * 10^<sup>(-12)</sup>^)'
6000 'femtometres' 'femtometres (metres * 10^<sup>(-15)</sup>^)'
6001 #
6002 'reciprocal_metres' 'reciprocal metres (metres^<sup>(-1)</sup>^)'
6003 'reciprocal_centimetres'
6004 'reciprocal centimetres ((metres * 10^<sup>( -2)</sup>^)^<sup>(-1)</sup>^)'
6005 'reciprocal_millimetres'
6006 'reciprocal millimetres ((metres * 10^<sup>( -3)</sup>^)^<sup>(-1)</sup>^)'
6007 'reciprocal_nanometres'
6008 'reciprocal nanometres ((metres * 10^<sup>( -9)</sup>^)^<sup>(-1)</sup>^)'
6009 'reciprocal_angstroms'
6010 'reciprocal \%Angstroms ((metres * 10^<sup>(-10)</sup>^)^<sup>(-1)</sup>^)'
6011 'reciprocal_picometres'
6012 'reciprocal picometres ((metres * 10^<sup>(-12)</sup>^)^<sup>(-1)</sup>^)'
6013 #
6014 'nanometres_squared' 'nanometres squared (metres * 10^<sup>( -9)</sup>^)^<sup>2</sup>^'
6015 'angstroms_squared' '\%Angstroms squared (metres * 10^<sup>(-10)</sup>^)^<sup>2</sup>^'
6016 '8pi2_angstroms_squared'
6017 '8\p^<sup>2</sup>^ * \%Angstroms squared (metres * 10^<sup>(-10)</sup>^)^<sup>2</sup>^'
6018 'picometres_squared' 'picometres squared (metres * 10^<sup>(-12)</sup>^)^<sup>2</sup>^'
6019 #
6020 'nanometres_cubed' 'nanometres cubed (metres * 10^<sup>( -9)</sup>^)^<sup>3</sup>^'
6021 'angstroms_cubed' '\%Angstroms cubed (metres * 10^<sup>(-10)</sup>^)^<sup>3</sup>^'
6022 'picometres_cubed' 'picometres cubed (metres * 10^<sup>(-12)</sup>^)^<sup>3</sup>^'
6023 #
6024 'kilopascals' 'kilopascals'
6025 'gigapascals' 'gigapascals'
6026 #
6027 'hours' 'hours'
6028 'minutes' 'minutes'
6029 'seconds' 'seconds'
6030 'microseconds' 'microseconds'
6031 #
6032 'degrees' 'degrees (of arc)'
6033 'degrees_squared' 'degrees (of arc) squared'
6034 #
6035 'degrees_per_minute' 'degrees (of arc) per minute'
6036 #
6037 'celsius' 'degrees (of temperature) Celsius'
6038 'kelvins' 'degrees (of temperature) Kelvin'
6039 #
6040 'counts' 'counts'
6041 'counts_per_photon' 'counts per photon'
6042 #
6043 'electrons' 'electrons'
6044 #
6045 'electrons_squared' 'electrons squared'
6046 #
6047 'electrons_per_nanometres_cubed'
6048 ; electrons per nanometres cubed (electrons/(metres * 10^<sup>( -9)</sup>^)^<sup>(-3)</sup>^)
6049 ;
6050 'electrons_per_angstroms_cubed'
6051 ; electrons per \%Angstroms cubed (electrons/(metres * 10^<sup>(-10)</sup>^)^<sup>(-3)</sup>^)
6052 ;
6053 'electrons_per_picometres_cubed'
6054 ; electrons per picometres cubed (electrons/(metres * 10^<sup>(-12)</sup>^)^<sup>(-3)</sup>^)
6055 ;
6056 'kilowatts' 'kilowatts'
6057 'milliamperes' 'milliamperes'
6058 'kilovolts' 'kilovolts'
6059 #
6060 'pixels_per_element' '(image) pixels per (array) element'
6061 #
6062 'arbitrary'
6063 ; arbitrary system of units.
6064 ;
6065 #
6066
6067 loop_
6068 _item_units_conversion.from_code
6069 _item_units_conversion.to_code
6070 _item_units_conversion.operator
6071 _item_units_conversion.factor
6072 ###
6073 'metres' 'centimetres' '*' 1.0E+02
6074 'metres' 'millimetres' '*' 1.0E+03
6075 'metres' 'nanometres' '*' 1.0E+09
6076 'metres' 'angstroms' '*' 1.0E+10
6077 'metres' 'picometres' '*' 1.0E+12
6078 'metres' 'femtometres' '*' 1.0E+15
6079 #
6080 'centimetres' 'metres' '*' 1.0E-02
6081 'centimetres' 'millimetres' '*' 1.0E+01
6082 'centimetres' 'nanometres' '*' 1.0E+07
6083 'centimetres' 'angstroms' '*' 1.0E+08
6084 'centimetres' 'picometres' '*' 1.0E+10
6085 'centimetres' 'femtometres' '*' 1.0E+13
6086 #
6087 'millimetres' 'metres' '*' 1.0E-03
6088 'millimetres' 'centimetres' '*' 1.0E-01
6089 'millimetres' 'nanometres' '*' 1.0E+06
6090 'millimetres' 'angstroms' '*' 1.0E+07
6091 'millimetres' 'picometres' '*' 1.0E+09
6092 'millimetres' 'femtometres' '*' 1.0E+12
6093 #
6094 'nanometres' 'metres' '*' 1.0E-09
6095 'nanometres' 'centimetres' '*' 1.0E-07
6096 'nanometres' 'millimetres' '*' 1.0E-06
6097 'nanometres' 'angstroms' '*' 1.0E+01
6098 'nanometres' 'picometres' '*' 1.0E+03
6099 'nanometres' 'femtometres' '*' 1.0E+06
6100 #
6101 'angstroms' 'metres' '*' 1.0E-10
6102 'angstroms' 'centimetres' '*' 1.0E-08
6103 'angstroms' 'millimetres' '*' 1.0E-07
6104 'angstroms' 'nanometres' '*' 1.0E-01
6105 'angstroms' 'picometres' '*' 1.0E+02
6106 'angstroms' 'femtometres' '*' 1.0E+05
6107 #
6108 'picometres' 'metres' '*' 1.0E-12
6109 'picometres' 'centimetres' '*' 1.0E-10
6110 'picometres' 'millimetres' '*' 1.0E-09
6111 'picometres' 'nanometres' '*' 1.0E-03
6112 'picometres' 'angstroms' '*' 1.0E-02
6113 'picometres' 'femtometres' '*' 1.0E+03
6114 #
6115 'femtometres' 'metres' '*' 1.0E-15
6116 'femtometres' 'centimetres' '*' 1.0E-13
6117 'femtometres' 'millimetres' '*' 1.0E-12
6118 'femtometres' 'nanometres' '*' 1.0E-06
6119 'femtometres' 'angstroms' '*' 1.0E-05
6120 'femtometres' 'picometres' '*' 1.0E-03
6121 ###
6122 'reciprocal_centimetres' 'reciprocal_metres' '*' 1.0E+02
6123 'reciprocal_centimetres' 'reciprocal_millimetres' '*' 1.0E-01
6124 'reciprocal_centimetres' 'reciprocal_nanometres' '*' 1.0E-07
6125 'reciprocal_centimetres' 'reciprocal_angstroms' '*' 1.0E-08
6126 'reciprocal_centimetres' 'reciprocal_picometres' '*' 1.0E-10
6127 #
6128 'reciprocal_millimetres' 'reciprocal_metres' '*' 1.0E+03
6129 'reciprocal_millimetres' 'reciprocal_centimetres' '*' 1.0E+01
6130 'reciprocal_millimetres' 'reciprocal_nanometres' '*' 1.0E-06
6131 'reciprocal_millimetres' 'reciprocal_angstroms' '*' 1.0E-07
6132 'reciprocal_millimetres' 'reciprocal_picometres' '*' 1.0E-09
6133 #
6134 'reciprocal_nanometres' 'reciprocal_metres' '*' 1.0E+09
6135 'reciprocal_nanometres' 'reciprocal_centimetres' '*' 1.0E+07
6136 'reciprocal_nanometres' 'reciprocal_millimetres' '*' 1.0E+06
6137 'reciprocal_nanometres' 'reciprocal_angstroms' '*' 1.0E-01
6138 'reciprocal_nanometres' 'reciprocal_picometres' '*' 1.0E-03
6139 #
6140 'reciprocal_angstroms' 'reciprocal_metres' '*' 1.0E+10
6141 'reciprocal_angstroms' 'reciprocal_centimetres' '*' 1.0E+08
6142 'reciprocal_angstroms' 'reciprocal_millimetres' '*' 1.0E+07
6143 'reciprocal_angstroms' 'reciprocal_nanometres' '*' 1.0E+01
6144 'reciprocal_angstroms' 'reciprocal_picometres' '*' 1.0E-02
6145 #
6146 'reciprocal_picometres' 'reciprocal_metres' '*' 1.0E+12
6147 'reciprocal_picometres' 'reciprocal_centimetres' '*' 1.0E+10
6148 'reciprocal_picometres' 'reciprocal_millimetres' '*' 1.0E+09
6149 'reciprocal_picometres' 'reciprocal_nanometres' '*' 1.0E+03
6150 'reciprocal_picometres' 'reciprocal_angstroms' '*' 1.0E+01
6151 ###
6152 'nanometres_squared' 'angstroms_squared' '*' 1.0E+02
6153 'nanometres_squared' 'picometres_squared' '*' 1.0E+06
6154 #
6155 'angstroms_squared' 'nanometres_squared' '*' 1.0E-02
6156 'angstroms_squared' 'picometres_squared' '*' 1.0E+04
6157 'angstroms_squared' '8pi2_angstroms_squared' '*' 78.9568
6158
6159 #
6160 'picometres_squared' 'nanometres_squared' '*' 1.0E-06
6161 'picometres_squared' 'angstroms_squared' '*' 1.0E-04
6162 ###
6163 'nanometres_cubed' 'angstroms_cubed' '*' 1.0E+03
6164 'nanometres_cubed' 'picometres_cubed' '*' 1.0E+09
6165 #
6166 'angstroms_cubed' 'nanometres_cubed' '*' 1.0E-03
6167 'angstroms_cubed' 'picometres_cubed' '*' 1.0E+06
6168 #
6169 'picometres_cubed' 'nanometres_cubed' '*' 1.0E-09
6170 'picometres_cubed' 'angstroms_cubed' '*' 1.0E-06
6171 ###
6172 'kilopascals' 'gigapascals' '*' 1.0E-06
6173 'gigapascals' 'kilopascals' '*' 1.0E+06
6174 ###
6175 'hours' 'minutes' '*' 6.0E+01
6176 'hours' 'seconds' '*' 3.6E+03
6177 'hours' 'microseconds' '*' 3.6E+09
6178 #
6179 'minutes' 'hours' '/' 6.0E+01
6180 'minutes' 'seconds' '*' 6.0E+01
6181 'minutes' 'microseconds' '*' 6.0E+07
6182 #
6183 'seconds' 'hours' '/' 3.6E+03
6184 'seconds' 'minutes' '/' 6.0E+01
6185 'seconds' 'microseconds' '*' 1.0E+06
6186 #
6187 'microseconds' 'hours' '/' 3.6E+09
6188 'microseconds' 'minutes' '/' 6.0E+07
6189 'microseconds' 'seconds' '/' 1.0E+06
6190 ###
6191 'celsius' 'kelvins' '-' 273.0
6192 'kelvins' 'celsius' '+' 273.0
6193 ###
6194 'electrons_per_nanometres_cubed'
6195 'electrons_per_angstroms_cubed' '*' 1.0E+03
6196 'electrons_per_nanometres_cubed'
6197 'electrons_per_picometres_cubed' '*' 1.0E+09
6198 #
6199 'electrons_per_angstroms_cubed'
6200 'electrons_per_nanometres_cubed' '*' 1.0E-03
6201 'electrons_per_angstroms_cubed'
6202 'electrons_per_picometres_cubed' '*' 1.0E+06
6203 #
6204 'electrons_per_picometres_cubed'
6205 'electrons_per_nanometres_cubed' '*' 1.0E-09
6206 'electrons_per_picometres_cubed'
6207 'electrons_per_angstroms_cubed' '*' 1.0E-06
6208 ###
6209
6210 ########################
6211 ## <a name="DICTIONARY_HISTORY">DICTIONARY_HISTORY</a> ##
6212 ########################
6213
6214 loop_
6215 _dictionary_history.version
6216 _dictionary_history.update
6217 _dictionary_history.revision
6218
6219 1.5.4 2007-07-28
6220
6221 ; Typographics corrections (HJB)
6222
6223 + Corrected embedded degree characters to \%
6224 + Corrected embedded Aring to \%A
6225 + Added trailing ^ for a power
6226 + Removed 2 cases of a space after an underscore
6227 in tag name.
6228 ;
6229
6230 1.5.3 2007-07-08
6231
6232 ; Changes to support SLS miniCBF and suggestions
6233 from the 24 May 07 BNL imgCIF workshop (HJB)
6234
6235 + Added new data items
6236 '<a href="#_array_data.header_contents" >_array_data.header_contents</a>',
6237 '<a href="#_array_data.header_convention" >_array_data.header_convention</a>',
6238 '<a href="#_diffrn_data_frame.center_fast" >_diffrn_data_frame.center_fast</a>',
6239 '<a href="#_diffrn_data_frame.center_slow" >_diffrn_data_frame.center_slow</a>',
6240 '<a href="#_diffrn_data_frame.center_units" >_diffrn_data_frame.center_units</a>',
6241 '<a href="#_diffrn_measurement.sample_detector_distance" >_diffrn_measurement.sample_detector_distance</a>',
6242 '<a href="#_diffrn_measurement.sample_detector_voffset" >_diffrn_measurement.sample_detector_voffset</a>
6243 + Deprecated data items
6244 '<a href="#_diffrn_detector_element.center[1]" >_diffrn_detector_element.center[1]</a>',
6245 '<a href="#_diffrn_detector_element.center[2]" >_diffrn_detector_element.center[2]</a>'
6246 + Added comments and example on miniCBF
6247 + Changed all array_id data items to implicit
6248 ;
6249
6250 1.5.2 2007-05-06
6251
6252 ; Further clarifications of the coordinate system. (HJB)
6253 ;
6254
6255 1.5.1 2007-04-26
6256
6257 ; Improve defintion of X-axis to cover the case of no goniometer
6258 and clean up more line folds (HJB)
6259 ;
6260
6261 1.5 2007-07-25
6262
6263 ; This is a cummulative list of the changes proposed since the
6264 imgCIF workshop in Hawaii in July 2006. It is the result
6265 of contributions by H. J. Bernstein, A. Hammersley,
6266 J. Wright and W. Kabsch.
6267
6268 2007-02-19 Consolidated changes (edited by HJB)
6269 + Added new data items
6270 '<a href="#_array_structure.compression_type_flag" >_array_structure.compression_type_flag</a>',
6271 '<a href="#_array_structure_list_axis.fract_displacement">_array_structure_list_axis.fract_displacement</a>',
6272 '<a href="#_array_structure_list_axis.fract_displacement_increment" >_array_structure_list_axis.displacement_increment</a>',
6273 '<a href="#_array_structure_list_axis.reference_angle" >_array_structure_list_axis.reference_angle</a>',
6274 '<a href="#_array_structure_list_axis.reference_displacement" >_array_structure_list_axis.reference_displacement</a>',
6275 '<a href="#_axis.sdystem" >_axis.system</a>',
6276 '<a href="#_diffrn_detector_element.reference_center_fast" >_diffrn_detector_element.reference_center_fast</a>',
6277 '<a href="#_diffrn_detector_element.reference_center_slow" >_diffrn_detector_element.reference_center_slow</a>',
6278 '<a href="#_diffrn_scan_axis.reference_angle" >_diffrn_scan_axis.reference_angle</a>',
6279 '<a href="#_diffrn_scan_axis.reference_displacement" >_diffrn_scan_axis.reference_displacement</a>',
6280 '<a href="#_map.details" >_map.details</a>', '<a href="#_map.diffrn_id" >_map.diffrn_id</a>',
6281 '<a href="#_map.entry_id" >_map.entry_id</a>', '<a name="#_map.id" >_map.id</a>',
6282 '<a href="#_map_segment.array_id" >_map_segment.array_id</a>', '<a href="#_map_segment.binary_id" >_map_segment.binary_id</a>',
6283 '<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>',
6284 '<a href="#_map_segment.id" >_map_segment.id</a>', '<a href="#_map_segment.map_id" >_map_segment.map_id</a>',
6285 '<a href="#_map_segment.details" >_map_segment.details</a>.
6286 + Change type of
6287 '<a href="#_array_structure.byte_order" >_array_structure.byte_order</a>' and
6288 '<a href="#_array_structure.compression_type" >_array_structure.compression_type</a>'
6289 to ucode to make these values case-insensitive
6290 + Add values 'packed_v2' and 'byte_offset' to enumeration of values for
6291 '<a href="#_array_structure.compression_type" >_array_structure.compression_type</a>'
6292 + Add to definitions for the binary data type to handle new compression
6293 types, maps, and a variety of new axis types.
6294 2007-07-25 Cleanup of typos for formal release (HJB)
6295 + Corrected text fields for reference_ tag descriptions that
6296 were off by one column
6297 + Fix typos in comments listing fract_ tags
6298 + Changed name of release from 1.5_DRAFT to 1.5
6299 + Fix unclosed text fields in various map definitions
6300
6301 ;
6302
6303 1.4 2006-07-04
6304
6305 ; This is a change to reintegrate all changes made in the course of
6306 publication of ITVG, by the RCSB from April 2005 through
6307 August 2008 and changes for the 2006 imgCIF workshop in
6308 Hawaii.
6309
6310 2006-07-04 Consolidated changes for the 2006 imgCIF workshop (edited by HJB)
6311 + Correct type of '<a href="#_array_structure_list.direction">_array_structure_list.direction</a>' from 'int' to 'code'.
6312 + Added new data items suggested by CN
6313 '<a href="#_diffrn_data_frame.details">_diffrn_data_frame.details</a>'
6314 '<a href="#_array_intensities.pixel_fast_bin_size" >_array_intensities.pixel_fast_bin_size</a>',
6315 '<a href="#_array_intensities.pixel_slow_bin_size" >_array_intensities.pixel_slow_bin_size</a> and
6316 '<a href="#_array_intensities.pixel_binning_method" >_array_intensities.pixel_binning_method</a>
6317 + Added deprecated item for completeness
6318 '<a href="#_diffrn_frame_data.details">_diffrn_frame_data.details</a>'
6319 + Added entry for missing item in contents list
6320 '<a href="#_array_structure_list_axis.displacement" >_array_structure_list_axis.displacement</a>'
6321 + Added new MIME type <b>X</b>-BASE32K based on work by VL, KM, GD, HJB
6322 + Correct description of MIME boundary delimiter to start in
6323 column 1.
6324 + General cleanup of text fields to conform to changes for ITVG
6325 by removing empty lines at start and finish of text field.
6326 + Amend example for ARRAY_INTENSITIES to include binning.
6327 + Add local copy of type specification (as 'code') for all children
6328 of '<a href="#_diffrn.id">_diffrn.id</a>'.
6329 + For consistency, change all references to 'pi' to '\p' and all
6330 references to 'Angstroms' to '\%Angstroms'.
6331 + Clean up all powers to use IUCr convention of '^power^', as in
6332 '10^3^' for '10**3'.
6333 + Update 'yyyy-mm-dd' type regex to allow truncation from the right
6334 and improve comments to explain handling of related mmCIF
6335 'yyyy-mm-dd:hh:mm' type, and use of 'Z' for GMT time zone.
6336
6337 2005-03-08 and
6338 2004-08-08 fixed cases where _item_units.code used
6339 instead of _item_type.code (JDW)
6340 2004-04-15 fixed item ordering in
6341 _diffrn_measurement_axis.measurement_id
6342 added sub_category 'vector' (JDW)
6343 ;
6344
6345 1.3.2 2005-06-25
6346
6347 ; 2005-06-25 ITEM_TYPE_LIST: code, ucode, line, uline regexps updated
6348 to those of current mmCIF; float modified by allowing integers
6349 terminated by a point as valid. The 'time' part of
6350 yyyy-mm-dd types made optional in the regexp. (BM)
6351
6352 2005-06-17 Minor corrections as for proofs for IT G Chapter 4.6
6353 (NJA)
6354
6355 2005-02-21 Minor corrections to spelling and punctuation
6356 (NJA)
6357
6358 2005-01-08 Changes as per Nicola Ashcroft.
6359 + Updated example 1 for DIFFRN_MEASUREMENT to agree with mmCIF.
6360 + Spelled out "micrometres" for "um" and "millimetres" for "mm".
6361 + Removed phrase "which may be stored" from ARRAY_STRUCTURE
6362 description.
6363 + Removed unused 'byte-offsets' compressions and updated
6364 cites to ITVG for '_array_structure.compression_type'.
6365 (HJB)
6366 ;
6367
6368 1.3.1 2003-08-13
6369 ;
6370 Changes as per Frances C. Bernstein.
6371 + Identify initials.
6372 + Adopt British spelling for centre in text.
6373 + Set \p and \%Angstrom and powers.
6374 + Clean up commas and unclear wordings.
6375 + Clean up tenses in history.
6376 Changes as per Gotzon Madariaga.
6377 + Fix the ARRAY_DATA example to align '_array_data.binary_id'
6378 and <b>X</b>-Binary-ID.
6379 + Add a range to '<a href="#_array_intensities.gain_esd">_array_intensities.gain_esd</a>'.
6380 + In the example of DIFFRN_DETECTOR_ELEMENT,
6381 '<a href="#_diffrn_detector_element.id">_diffrn_detector_element.id</a>' and
6382 '<a href="#_diffrn_detector_element.detector_id">_diffrn_detector_element.detector_id</a>' interchanged.
6383 + Fix typos for direction, detector and axes.
6384 + Clarify description of polarisation.
6385 + Clarify axes in '<a href="#_diffrn_detector_element.center[1]">_diffrn_detector_element.center[1]</a>'
6386 '<a href="#_diffrn_detector_element.center[2]">_diffrn_detector_element.center[2]</a>'.
6387 + Add local item types for items that are pointers.
6388 (HJB)
6389 ;
6390
6391
6392 1.3.0 2003-07-24
6393 ;
6394 Changes as per Brian McMahon.
6395 + Consistently quote tags embedded in text.
6396 + Clean up introductory comments.
6397 + Adjust line lengths to fit in 80 character window.
6398 + Fix several descriptions in AXIS category which
6399 referred to '_axis.type' instead of the current item.
6400 + Fix erroneous use of deprecated item
6401 '_diffrn_detector_axis.id' in examples for
6402 DIFFRN_SCAN_AXIS.
6403 + Add deprecated items '_diffrn_detector_axis.id'
6404 and '_diffrn_measurement_axis.id'.
6405 (HJB)
6406 ;
6407
6408
6409 1.2.4 2003-07-14
6410 ;
6411 Changes as per I. David Brown.
6412 + Enhance descriptions in DIFFRN_SCAN_AXIS to make them less
6413 dependent on the descriptions in DIFFRN_SCAN_FRAME_AXIS.
6414 + Provide a copy of the deprecated DIFFRN_FRAME_DATA
6415 category for completeness.
6416 (HJB)
6417 ;
6418
6419
6420 1.2.3 2003-07-03
6421 ;
6422 Cleanup to conform to ITVG.
6423 + Correct sign error in ..._cubed units.
6424 + Correct '_diffrn_radiation.polarisn_norm' range.
6425 (HJB)
6426 ;
6427
6428
6429 1.2.2 2003-03-10
6430 ;
6431 Correction of typos in various DIFFRN_SCAN_AXIS descriptions.
6432 (HJB)
6433 ;
6434
6435
6436 1.2.1 2003-02-22
6437 ;
6438 Correction of ATOM_ for ARRAY_ typos in various descriptions.
6439 (HJB)
6440 ;
6441
6442
6443 1.2 2003-02-07
6444 ;
6445 Corrections to encodings (remove extraneous hyphens) remove
6446 extraneous underscore in '<a href="#_array_structure.encoding_type">_array_structure.encoding_type</a>'
6447 enumeration. Correct typos in items units list. (HJB)
6448 ;
6449
6450
6451 1.1.3 2001-04-19
6452 ;
6453 Another typo corrections by Wilfred Li, and cleanup by HJB.
6454 ;
6455
6456
6457 1.1.2 2001-03-06
6458 ;
6459 Several typo corrections by Wilfred Li.
6460 ;
6461
6462
6463 1.1.1 2001-02-16
6464 ;
6465 Several typo corrections by JW.
6466 ;
6467
6468
6469 1.1 2001-02-06
6470 ;
6471 Draft resulting from discussions on header for use at NSLS. (HJB)
6472
6473 + Change DIFFRN_FRAME_DATA to <a href="#DIFFRN_DATA_FRAME">DIFFRN_DATA_FRAME</a>.
6474
6475 + Change '_diffrn_detector_axis.id' to '<a href="#_diffrn_detector_axis.detector_id">_diffrn_detector_axis.detector_id</a>'.
6476
6477 + Add '<a href="#_diffrn_measurement_axis.measurement_device">_diffrn_measurement_axis.measurement_device</a>' and change
6478 '_diffrn_measurement_axis.id' to
6479 '<a href="#_diffrn_measurement_axis.measurement_id">_diffrn_measurement_axis.measurement_id</a>'.
6480
6481 + 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>',
6482 '<a href="#_diffrn_radiation.div_x_y_source">_diffrn_radiation.div_x_y_source</a>',
6483 '<a href="#_diffrn_radiation.polarizn_source_norm">_diffrn_radiation.polarizn_source_norm</a>',
6484 '<a href="#_diffrn_radiation.polarizn_source_ratio">_diffrn_radiation.polarizn_source_ratio</a>', '<a href="#_diffrn_scan.date_end">_diffrn_scan.date_end</a>',
6485 '<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>',
6486 '<a href="#_diffrn_scan_axis.displacement_rstrt_incr">_diffrn_scan_axis.displacement_rstrt_incr</a>',
6487 '<a href="#_diffrn_scan_frame_axis.angle_increment">_diffrn_scan_frame_axis.angle_increment</a>',
6488 '<a href="#_diffrn_scan_frame_axis.angle_rstrt_incr">_diffrn_scan_frame_axis.angle_rstrt_incr</a>',
6489 '<a href="#_diffrn_scan_frame_axis.displacement">_diffrn_scan_frame_axis.displacement</a>',
6490 '<a href="#_diffrn_scan_frame_axis.displacement_increment">_diffrn_scan_frame_axis.displacement_increment</a>',and
6491 '<a href="#_diffrn_scan_frame_axis.displacement_rstrt_incr">_diffrn_scan_frame_axis.displacement_rstrt_incr</a>'.
6492
6493 + Add '<a href="#_diffrn_measurement.device">_diffrn_measurement.device</a>' to category key.
6494
6495 + Update yyyy-mm-dd to allow optional time with fractional seconds
6496 for time stamps.
6497
6498 + Fix typos caught by RS.
6499
6500 + Add <a href="#ARRAY_STRUCTURE_LIST_AXIS">ARRAY_STRUCTURE_LIST_AXIS</a> category, and use concept of axis sets to
6501 allow for coupled axes, as in spiral scans.
6502
6503 + Add examples for fairly complete headers thanks to R. Sweet and P.
6504 Ellis.
6505 ;
6506
6507
6508 1.0 2000-12-21
6509 ;
6510 Release version - few typos and tidying up. (BM &amp; HJB)
6511
6512 + Move ITEM_TYPE_LIST, ITEM_UNITS_LIST and DICTIONARY_HISTORY to end
6513 of dictionary.
6514
6515 + Alphabetize dictionary.
6516 ;
6517
6518
6519 0.7.1 2000-09-29
6520 ;
6521 Cleanup fixes. (JW)
6522
6523 + Correct spelling of diffrn_measurement_axis in '<a href="#_axis.id">_axis.id</a>'
6524
6525 + Correct ordering of uses of '_item.mandatory_code' and
6526 '_item_default.value'.
6527 ;
6528
6529
6530 0.7.0 2000-09-09
6531 ;
6532 Respond to comments by I. David Brown. (HJB)
6533
6534 + Add further comments on '\n' and '\t'.
6535
6536 + Update ITEM_UNITS_LIST by taking section from mmCIF dictionary
6537 and adding metres. Change 'meter' to 'metre' throughout.
6538
6539 + Add missing enumerations to '<a href="#_array_structure.compression_type">_array_structure.compression_type</a>'
6540 and make 'none' the default.
6541
6542 + Remove parent-child relationship between
6543 '<a href="#_array_structure_list.index">_array_structure_list.index</a>' and '<a href="#_array_structure_list.precedence">_array_structure_list.precedence</a>'.
6544
6545 + Improve alphabetization.
6546
6547 + Fix '<a href="#_array_intensities.gain_esd">_array_intensities_gain.esd</a>' related function.
6548
6549 + Improve comments in <a href="#AXIS">AXIS</a>.
6550
6551 + Fix DIFFRN_FRAME_DATA example.
6552
6553 + Remove erroneous <a href="#DIFFRN_MEASUREMENT">DIFFRN_MEASUREMENT</a> example.
6554
6555 + Add '<a href="#_diffrn_measurement_axis.id">_diffrn_measurement_axis.id</a>' to the category key.
6556 ;
6557
6558
6559 0.6.0 1999-01-14
6560 ;
6561 Remove redundant information for ENC_NONE data. (HJB)
6562
6563 + After the D5 remove binary section identifier, size and
6564 compression type.
6565
6566 + Add Control-L to header.
6567 ;
6568
6569
6570 0.5.1 1999-01-03
6571 ;
6572 Cleanup of typos and syntax errors. (HJB)
6573
6574 + Cleanup example details for <a href="#DIFFRN_SCAN">DIFFRN_SCAN</a> category.
6575
6576 + Add missing quote marks for '<a href="#_diffrn_scan.id" >_diffrn_scan.id</a>' definition.
6577 ;
6578
6579
6580 0.5 1999-01-01
6581 ;
6582 Modifications for axis definitions and reduction of binary header. (HJB)
6583
6584 + Restore '<a href="#_diffrn_detector.diffrn_id" >_diffrn_detector.diffrn_id</a>' to <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a> KEY.
6585
6586 + Add <a href="#AXIS">AXIS</a> category.
6587
6588 + Bring in complete <a href="#DIFFRN_DETECTOR">DIFFRN_DETECTOR</a> and <a href="#DIFFRN_MEASUREMENT">DIFFRN_MEASUREMENT</a> categories
6589 from cif_mm.dic for clarity.
6590
6591 + Change '<a href="#_array_structure.encoding_type">_array_structure.encoding_type</a>' from type code to uline and
6592 added X-Binary-Element-Type to MIME header.
6593
6594 + Add detector beam centre '<a href="#_diffrn_detector_element.center[1]">_diffrn_detector_element.center[1]</a>' and
6595 '<a href="#_diffrn_detector_element.center[2]">_diffrn_detector_element.center[2]</a>'.
6596
6597 + Correct item name of '<a href="#_diffrn_refln.frame_id">_diffrn_refln.frame_id</a>'.
6598
6599 + Replace reference to '_array_intensities.undefined' by
6600 '_array_intensities.undefined_value'.
6601
6602 + Replace references to '_array_intensity.scaling' with
6603 '_array_intensities.scaling'.
6604
6605 + Add <a href="#DIFFRN_SCAN">DIFFRN_SCAN</a>... categories.
6606 ;
6607
6608
6609 0.4 1998-08-11
6610 ;
6611 Modifications to the 0.3 imgCIF draft. (HJB)
6612
6613 + Reflow comment lines over 80 characters and corrected typos.
6614
6615 + Update examples and descriptions of MIME encoded data.
6616
6617 + Change name to cbfext98.dic.
6618 ;
6619
6620
6621 0.3 1998-07-04
6622 ;
6623 Modifications for imgCIF. (HJB)
6624
6625 + Add binary type, which is a text field containing a variant on
6626 MIME encoded data.
6627
6628 + Change type of '<a href="#_array_data.data" >_array_data.data</a>' to binary and specify internal
6629 structure of raw binary data.
6630
6631 + Add '<a href="#_array_data.binary_id" >_array_data.binary_id</a>', and make
6632 '<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>'
6633 into pointers to this item.
6634 ;
6635
6636
6637 0.2 1997-12-02
6638 ;
6639 Modifications to the CBF draft. (JW)
6640
6641 + Add category hierarchy for describing frame data developed from
6642 discussions at the BNL imgCIF Workshop Oct 1997. The following
6643 changes are made in implementing the workshop draft. Category
6644 DIFFRN_ARRAY_DATA is renamed to DIFFRN_FRAME_DATA. Category
6645 DIFFRN_FRAME_TYPE is renamed to <a href="#DIFFRN_DETECTOR_ELEMENT">DIFFRN_DETECTOR_ELEMENT</a>. The
6646 parent item for '<a href="#_diffrn_frame_data.array_id" >_diffrn_frame_data.array_id</a>' is changed from
6647 '_array_structure_list.array_id' to '_array_structure.id'. Item
6648 '_diffrn_detector.array_id' is deleted.
6649 + Add data item '<a href="#_diffrn_frame_data.binary_id" >_diffrn_frame_data.binary_id</a>' to identify data
6650 groups within a binary section. The formal identification of the
6651 binary section is still fuzzy.
6652 ;
6653
6654
6655 0.1 1997-01-24
6656 ;
6657 First draft of this dictionary in DDL 2.1 compliant format by John
6658 Westbrook (JW). This version is adapted from the Crystallographic
6659 Binary File (CBF) Format Draft Proposal provided by Andy Hammersley
6660 (AH).
6661
6662 Modifications to the CBF draft. (JW)
6663
6664 + In this version the array description has been cast in the categories
6665 <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a> and <a href="#ARRAY_STRUCTURE_LIST">ARRAY_STRUCTURE_LIST</a>. These categories
6666 have been generalized to describe array data of arbitrary dimension.
6667
6668 + Array data in this description are contained in the category
6669 <a href="#ARRAY_DATA">ARRAY_DATA</a>. This departs from the CBF notion of data existing
6670 in some special comment. In this description, data are handled as an
6671 ordinary data item encapsulated in a character data type. Although
6672 data this manner deviates from CIF conventions, it does not violate
6673 any DDL 2.1 rules. DDL 2.1 regular expressions can be used to define
6674 the binary representation which will permit some level of data
6675 validation. In this version, the placeholder type code "any" has
6676 been used. This translates to a regular expression which will match
6677 any pattern.
6678
6679 It should be noted that DDL 2.1 already supports array data objects
6680 although these have not been used in the current mmCIF dictionary.
6681 It may be possible to use the DDL 2.1 ITEM_STRUCTURE and
6682 ITEM_STRUCTURE_LIST categories to provide the information that is
6683 carried in by the <a href="#ARRAY_STRUCTURE">ARRAY_STRUCTURE</a> and <a href="#ARRAY_STRUCTURE_LIST">ARRAY_STRUCTURE_LIST</a>. By
6684 moving the array structure to the DDL level it would be possible to
6685 define an array type as well as a regular expression defining the
6686 data format.
6687
6688 + Multiple array sections can be properly handled within a single
6689 datablock.
6690 ;
6691
6692
6693 #-eof-eof-eof-eof-eof-eof-eof-eof-eof-eof-eof-eof-eof-eof-eof-eof-eof-eof-eof
6694 </PRE>
6695 </BODY>
6696 </HTML>