/* * datatemplate.c * * Data template structure * * Copyright © 2019 Deutsches Elektronen-Synchrotron DESY, * a research centre of the Helmholtz Association. * * Authors: * 2019 Thomas White * * This file is part of CrystFEL. * * CrystFEL is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * CrystFEL is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with CrystFEL. If not, see . * */ #ifdef HAVE_CONFIG_H #include #endif #include #include "datatemplate.h" /** * \file datatemplate.h */ enum adu_per_unit { ADU_PER_PHOTON, ADU_PER_EV }; /** * Represents one panel of a detector */ struct panel_template { /** Text name for panel (fixed length array) */ char name[1024]; /** \name Location of corner in units of the pixel size of this panel */ /**@{*/ double cnx; double cny; /**@}*/ /** Location to get \ref cnz from, e.g. from HDF5 file */ char *cnz_from; /** The offset to be applied from \ref clen */ double coffset; /** Location of mask data */ char *mask; /** Filename for mask data */ char *mask_file; /** Location of per-pixel saturation map */ char *satmap; /** Filename for saturation map */ char *satmap_file; /** Resolution in pixels per metre */ double pixel_pitch; /** Readout direction (for filtering out clusters of peaks) * ('x' or 'y') */ char badrow; /** Number of detector intensity units per photon, or eV */ double adu_scale; enum adu_per_unit adu_scale_unit; /** Treat pixel as unreliable if higher than this */ double max_adu; /** Location of data in file */ char *data; /** Dimension structure */ struct dim_structure *dim_structure; /** \name Transformation matrix from pixel coordinates to lab frame */ /*@{*/ double fsx; double fsy; double fsz; double ssx; double ssy; double ssz; /*@}*/ /** \name Rail direction */ /*@{*/ double rail_x; double rail_y; double rail_z; /*@}*/ /* Value of clen (without coffset) at which beam is centered */ double clen_for_centering; /** \name Position of the panel in the data block in the file. */ /*@{*/ int orig_min_fs; int orig_max_fs; int orig_min_ss; int orig_max_ss; /*@}*/ }; struct _datatemplate { struct panel_template *panels; int n_panels; struct badregion *bad; int n_bad; unsigned int mask_bad; unsigned int mask_good; struct rigid_group **rigid_groups; int n_rigid_groups; struct rg_collection **rigid_group_collections; int n_rg_collections; int path_dim; int dim_dim; struct panel_template defaults; }; DataTemplate *data_template_new_from_file(const char *filename) { return NULL; } void data_template_free(DataTemplate *dt) { }