/* * predict-refine.c * * Prediction refinement * * Copyright © 2012-2015 Deutsches Elektronen-Synchrotron DESY, * a research centre of the Helmholtz Association. * * Authors: * 2010-2015 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 #include #include #include "image.h" #include "geometry.h" #include "cell-utils.h" /* Maximum number of iterations of NLSq to do for each image per macrocycle. */ #define MAX_CYCLES (10) /* Weighting of excitation error term (m^-1) compared to position term (m) */ #define EXC_WEIGHT (4e-20) /* Parameters to refine */ static const enum gparam rv[] = { GPARAM_ASX, GPARAM_ASY, GPARAM_ASZ, GPARAM_BSX, GPARAM_BSY, GPARAM_BSZ, GPARAM_CSX, GPARAM_CSY, GPARAM_CSZ, GPARAM_DETX, GPARAM_DETY, GPARAM_CLEN }; static const int num_params = 12; struct reflpeak { Reflection *refl; struct imagefeature *peak; double Ih; /* normalised */ struct panel *panel; /* panel the reflection appears on * (we assume this never changes) */ }; static void twod_mapping(double fs, double ss, double *px, double *py, struct panel *p) { double xs, ys; xs = fs*p->fsx + ss*p->ssx; ys = fs*p->fsy + ss*p->ssy; *px = (xs + p->cnx) / p->res; *py = (ys + p->cny) / p->res; } static double r_dev(struct reflpeak *rp) { /* Excitation error term */ double rlow, rhigh, p; get_partial(rp->refl, &rlow, &rhigh, &p); return (rlow+rhigh)/2.0; } static double x_dev(struct reflpeak *rp, struct detector *det) { /* Peak position term */ double xpk, ypk, xh, yh; double fsh, ssh; twod_mapping(rp->peak->fs, rp->peak->ss, &xpk, &ypk, rp->panel); get_detector_pos(rp->refl, &fsh, &ssh); twod_mapping(fsh, ssh, &xh, &yh, rp->panel); return xh-xpk; } static double y_dev(struct reflpeak *rp, struct detector *det) { /* Peak position term */ double xpk, ypk, xh, yh; double fsh, ssh; twod_mapping(rp->peak->fs, rp->peak->ss, &xpk, &ypk, rp->panel); get_detector_pos(rp->refl, &fsh, &ssh); twod_mapping(fsh, ssh, &xh, &yh, rp->panel); return yh-ypk; } static void write_pairs(const char *filename, struct reflpeak *rps, int n, struct detector *det) { int i; FILE *fh; fh = fopen(filename, "w"); if ( fh == NULL ) { ERROR("Failed to open '%s'\n", filename); return; } for ( i=0; ifs; ss = rps[i].peak->ss; p = find_panel(det, fs, ss); write_fs = fs - p->min_fs + p->orig_min_fs; write_ss = ss - p->min_ss + p->orig_min_ss; fprintf(fh, "%f %f\n", write_fs, write_ss); } fclose(fh); STATUS("Wrote %i pairs to %s\n", n, filename); } /* Associate a Reflection with each peak in "image" which is close to Bragg. * Reflections will be added to "reflist", which can be NULL if this is not * needed. "rps" must be an array of sufficient size for all the peaks */ static int pair_peaks(struct image *image, Crystal *cr, RefList *reflist, struct reflpeak *rps) { int i; const double min_dist = 0.05; int n_acc = 0; for ( i=0; ifeatures); i++ ) { struct imagefeature *f; double h, k, l, hd, kd, ld; /* Assume all image "features" are genuine peaks */ f = image_get_feature(image->features, i); if ( f == NULL ) continue; double ax, ay, az; double bx, by, bz; double cx, cy, cz; cell_get_cartesian(crystal_get_cell(cr), &ax, &ay, &az, &bx, &by, &bz, &cx, &cy, &cz); /* Decimal and fractional Miller indices of nearest * reciprocal lattice point */ hd = f->rx * ax + f->ry * ay + f->rz * az; kd = f->rx * bx + f->ry * by + f->rz * bz; ld = f->rx * cx + f->ry * cy + f->rz * cz; h = lrint(hd); k = lrint(kd); l = lrint(ld); /* Check distance */ if ( (fabs(h - hd) < min_dist) && (fabs(k - kd) < min_dist) && (fabs(l - ld) < min_dist) ) { Reflection *refl; struct panel *p; refl = reflection_new(h, k, l); if ( refl == NULL ) { ERROR("Failed to create reflection\n"); return 0; } if ( reflist != NULL ) add_refl_to_list(refl, reflist); set_symmetric_indices(refl, h, k, l); /* It doesn't matter if the actual predicted location * doesn't fall on this panel. We're only interested * in how far away it is from the peak location. * The predicted position and excitation errors will be * filled in by update_partialities(). */ p = find_panel(image->det, f->fs, f->ss); set_panel(refl, p); rps[n_acc].refl = refl; rps[n_acc].peak = f; rps[n_acc].panel = p; n_acc++; } } return n_acc; } static int cmpd2(const void *av, const void *bv) { struct reflpeak *a, *b; a = (struct reflpeak *)av; b = (struct reflpeak *)bv; if ( fabs(r_dev(a)) < fabs(r_dev(b)) ) return -1; return 1; } void refine_radius(Crystal *cr, struct image *image) { int n, n_acc; struct reflpeak *rps; RefList *reflist; /* Maximum possible size */ rps = malloc(image_feature_count(image->features) * sizeof(struct reflpeak)); if ( rps == NULL ) return; reflist = reflist_new(); n_acc = pair_peaks(image, cr, reflist, rps); if ( n_acc < 3 ) { ERROR("Too few paired peaks (%i) to determine radius\n", n_acc); free(rps); return; } crystal_set_reflections(cr, reflist); update_partialities(cr, PMODEL_SCSPHERE); crystal_set_reflections(cr, NULL); qsort(rps, n_acc, sizeof(struct reflpeak), cmpd2); n = (n_acc-1) - n_acc/50; if ( n < 2 ) n = 2; /* n_acc is always >= 2 */ crystal_set_profile_radius(cr, fabs(r_dev(&rps[n]))); reflist_free(reflist); free(rps); } /* Returns d(xh-xpk)/dP, where P = any parameter */ static double x_gradient(int param, struct reflpeak *rp, struct detector *det, double lambda, UnitCell *cell) { signed int h, k, l; double xpk, ypk, xh, yh; double fsh, ssh; double tt, clen, azi, azf; twod_mapping(rp->peak->fs, rp->peak->ss, &xpk, &ypk, rp->panel); get_detector_pos(rp->refl, &fsh, &ssh); twod_mapping(fsh, ssh, &xh, &yh, rp->panel); get_indices(rp->refl, &h, &k, &l); tt = asin(lambda * resolution(cell, h, k, l)); clen = rp->panel->clen; azi = atan2(yh, xh); azf = cos(azi); switch ( param ) { case GPARAM_ASX : return h * lambda * clen / cos(tt); case GPARAM_BSX : return k * lambda * clen / cos(tt); case GPARAM_CSX : return l * lambda * clen / cos(tt); case GPARAM_ASY : return 0.0; case GPARAM_BSY : return 0.0; case GPARAM_CSY : return 0.0; case GPARAM_ASZ : return -h * lambda * clen * 2*azf * sin(tt) / (cos(tt)*cos(tt)); case GPARAM_BSZ : return -k * lambda * clen * 2*azf * sin(tt) / (cos(tt)*cos(tt)); case GPARAM_CSZ : return -l * lambda * clen * 2*azf * sin(tt) / (cos(tt)*cos(tt)); case GPARAM_DETX : return -1; case GPARAM_DETY : return 0; case GPARAM_CLEN : return azf * cos(tt); } ERROR("Positional gradient requested for parameter %i?\n", param); abort(); } /* Returns d(yh-ypk)/dP, where P = any parameter */ static double y_gradient(int param, struct reflpeak *rp, struct detector *det, double lambda, UnitCell *cell) { signed int h, k, l; double xpk, ypk, xh, yh; double fsh, ssh; double tt, clen, azi, azf; twod_mapping(rp->peak->fs, rp->peak->ss, &xpk, &ypk, rp->panel); get_detector_pos(rp->refl, &fsh, &ssh); twod_mapping(fsh, ssh, &xh, &yh, rp->panel); get_indices(rp->refl, &h, &k, &l); tt = asin(lambda * resolution(cell, h, k, l)); clen = rp->panel->clen; azi = atan2(yh, xh); azf = sin(azi); switch ( param ) { case GPARAM_ASX : return 0.0; case GPARAM_BSX : return 0.0; case GPARAM_CSX : return 0.0; case GPARAM_ASY : return h * lambda * clen / cos(tt); case GPARAM_BSY : return k * lambda * clen / cos(tt); case GPARAM_CSY : return l * lambda * clen / cos(tt); case GPARAM_ASZ : return -h * lambda * clen * 2*azf * sin(tt) / (cos(tt)*cos(tt)); case GPARAM_BSZ : return -k * lambda * clen * 2*azf * sin(tt) / (cos(tt)*cos(tt)); case GPARAM_CSZ : return -l * lambda * clen * 2*azf * sin(tt) / (cos(tt)*cos(tt)); case GPARAM_DETX : return 0; case GPARAM_DETY : return -1; case GPARAM_CLEN : return azf * cos(tt); } ERROR("Positional gradient requested for parameter %i?\n", param); abort(); } static void update_detector(struct detector *det, double xoffs, double yoffs, double coffs) { int i; for ( i=0; in_panels; i++ ) { struct panel *p = &det->panels[i]; p->cnx += xoffs * p->res; p->cny += yoffs * p->res; p->coffset += coffs; } } static int iterate(struct reflpeak *rps, int n, UnitCell *cell, struct image *image, double *total_x, double *total_y, double *total_z) { int i; gsl_matrix *M; gsl_vector *v; gsl_vector *shifts; double asx, asy, asz; double bsx, bsy, bsz; double csx, csy, csz; /* Number of parameters to refine */ M = gsl_matrix_calloc(num_params, num_params); v = gsl_vector_calloc(num_params); for ( i=0; i k ) continue; M_c = w * gradients[g] * gradients[k]; M_curr = gsl_matrix_get(M, k, g); gsl_matrix_set(M, k, g, M_curr + M_c); gsl_matrix_set(M, g, k, M_curr + M_c); } v_c = w * r_dev(&rps[i]); v_c *= -gradients[k]; v_curr = gsl_vector_get(v, k); gsl_vector_set(v, k, v_curr + v_c); } /* Positional x terms */ for ( k=0; kdet, image->lambda, cell); } for ( k=0; k k ) continue; M_c = gradients[g] * gradients[k]; M_curr = gsl_matrix_get(M, k, g); gsl_matrix_set(M, k, g, M_curr + M_c); gsl_matrix_set(M, g, k, M_curr + M_c); } v_c = x_dev(&rps[i], image->det); v_c *= -gradients[k]; v_curr = gsl_vector_get(v, k); gsl_vector_set(v, k, v_curr + v_c); } /* Positional y terms */ for ( k=0; kdet, image->lambda, cell); } for ( k=0; k k ) continue; M_c = gradients[g] * gradients[k]; M_curr = gsl_matrix_get(M, k, g); gsl_matrix_set(M, k, g, M_curr + M_c); gsl_matrix_set(M, g, k, M_curr + M_c); } v_c = y_dev(&rps[i], image->det); v_c *= -gradients[k]; v_curr = gsl_vector_get(v, k); gsl_vector_set(v, k, v_curr + v_c); } } //show_matrix_eqn(M, v); shifts = solve_svd(v, M, NULL, 0); if ( shifts == NULL ) { ERROR("Failed to solve equations.\n"); gsl_matrix_free(M); gsl_vector_free(v); return 1; } for ( i=0; idet, gsl_vector_get(shifts, 9), gsl_vector_get(shifts, 10), gsl_vector_get(shifts, 11)); *total_x += gsl_vector_get(shifts, 9); *total_y += gsl_vector_get(shifts, 10); *total_z += gsl_vector_get(shifts, 11); cell_set_reciprocal(cell, asx, asy, asz, bsx, bsy, bsz, csx, csy, csz); gsl_vector_free(shifts); gsl_matrix_free(M); gsl_vector_free(v); return 0; } static double residual(struct reflpeak *rps, int n, struct detector *det) { int i; double res = 0.0; double r; r = 0.0; for ( i=0; ifeatures) * sizeof(struct reflpeak)); if ( rps == NULL ) return 1; reflist = reflist_new(); n = pair_peaks(image, cr, reflist, rps); if ( n < 10 ) { ERROR("Too few paired peaks (%i) to refine orientation.\n", n); free(rps); reflist_free(reflist); return 1; } crystal_set_reflections(cr, reflist); //write_pairs("pairs.lst", rps, n, image->det); /* Normalise the intensities to max 1 */ max_I = -INFINITY; for ( i=0; iintensity; if ( cur_I > max_I ) max_I = cur_I; } if ( max_I <= 0.0 ) { ERROR("All peaks negative?\n"); free(rps); return 1; } for ( i=0; iintensity / max_I; } /* Refine */ for ( i=0; i