jamesrhester
commented
5 years ago Here are some fleshed-out definitions base on an email to the imgCIF mailing list at iucr.org. Summary: An image is located through location_uri + external_path + external_frame. It is processed externally according to the specifications in external_format + external_version, and then can be further interpreted using information in _array_structure and _array_structure_list to result in an array of integers or reals (this array not defined here).
save_array_data.external_format
_definition.id _array_data.external_format
_description.text
;
The format in which raw array data referenced by _array_data.location_uri and
_array_data.external_path can be accessed. The format specification can include
conversions performed within external libraries. Items in _array_structure and
_array_structure_list refer to the data after retrieval from the external libraries.
In combination with _array_data.format_version this should allow external tools
to correctly access external data.
;
loop_
_enumeration_set.state
_enumeration_set.details
CBF
;
The contents of the _array_data.data in a single-frame imgCBF file. Other
datanames in the external file are ignored.
;
SMV
;
An unprocessed sequence of bytes contained in a file conforming to the SMV
format as used by ADSC and other CCD manufacturers.
;
HDF5
;
A decompressed, 2-dimensional array of numbers corresponding to a single frame contained
in an HDF5 file as returned by HDF5 library functions. _array_data.external_path includes
both the directory path and internal HDF5 path.
;
MAR
;
An array of numbers corresponding to a decompressed single frame contained
within a MARCCD file (TIFF format).
;
Bruker
;
An array of numbers corresponding to a decompressed single frame from a
data file generated by Bruker equipment.
;
_name.category_id array_data
_name.object_id external_format
save_
#####
save_array_data.external_version
_definition.id '_array_data.external_version'
_description.text
;
An identifier for the version of the file format described by _array_data.external_format.
;
save_
#####
save_array_data.location_uri
_definition.id '_array_data.location_uri'
_description.text
;
A URI describing the location of an image external to the current data block
;
save_
#####
save_array_data.external_path
_definition.id '_array_data.external_path'
_description.text
;
A path that is used to locate the external image relative to _array_data.location_uri. This may include
both a directory structure and an internal format-dependent path.
;
save_
#####
save_array_data.external_frame
_definition.id '_array_data.external_frame'
_description.text
;
When the combination of _array_data.location_uri and _array_data.external_path
refer to a list of images, _array_data.external_frame is used to identify the image
position within that list, numbering from 1.
;
save_
yayahjb
As a serial format, imgCIF is not suitable for storing large quantities of image data. However, it should be possible to refer to externally-stored data in a way that would allow tools to access that data. Definitions should be developed for doing this.