/* * cell.c * * Unit Cell Calculations * * (c) 2006-2010 Thomas White * * Part of CrystFEL - crystallography with a FEL * */ #ifdef HAVE_CONFIG_H #include #endif #include #include #include #include #include #include #include "cell.h" #include "utils.h" #include "image.h" /* Weighting factor of lengths relative to angles */ #define LWEIGHT (10.0e-9) /* Update the cartesian representation from the crystallographic one */ static void cell_update_cartesian(UnitCell *cell) { double tmp, V, cosalphastar, cstar; if ( !cell ) return; /* a in terms of x, y and z * +a (cryst) is defined to lie along +x (cart) */ cell->ax = cell->a; cell->ay = 0.0; cell->az = 0.0; /* b in terms of x, y and z * b (cryst) is defined to lie in the xy (cart) plane */ cell->bx = cell->b*cos(cell->gamma); cell->by = cell->b*sin(cell->gamma); cell->bz = 0.0; tmp = cos(cell->alpha)*cos(cell->alpha) + cos(cell->beta)*cos(cell->beta) + cos(cell->gamma)*cos(cell->gamma) - 2.0*cos(cell->alpha)*cos(cell->beta)*cos(cell->gamma); V = cell->a * cell->b * cell->c * sqrt(1.0 - tmp); cosalphastar = cos(cell->beta)*cos(cell->gamma) - cos(cell->alpha); cosalphastar /= sin(cell->beta)*sin(cell->gamma); cstar = (cell->a * cell->b * sin(cell->gamma))/V; /* c in terms of x, y and z */ cell->cx = cell->c*cos(cell->beta); cell->cy = -cell->c*sin(cell->beta)*cosalphastar; cell->cz = 1.0/cstar; } /* Update the crystallographic representation from the cartesian one */ static void cell_update_crystallographic(UnitCell *cell) { if ( !cell ) return; cell->a = modulus(cell->ax, cell->ay, cell->az); cell->b = modulus(cell->bx, cell->by, cell->bz); cell->c = modulus(cell->cx, cell->cy, cell->cz); cell->alpha = angle_between(cell->bx, cell->by, cell->bz, cell->cx, cell->cy, cell->cz); cell->beta = angle_between(cell->ax, cell->ay, cell->az, cell->cx, cell->cy, cell->cz); cell->gamma = angle_between(cell->ax, cell->ay, cell->az, cell->bx, cell->by, cell->bz); } UnitCell *cell_new() { UnitCell *cell; cell = malloc(sizeof(UnitCell)); if ( !cell ) return NULL; cell->a = 1.0; cell->b = 1.0; cell->c = 1.0; cell->alpha = M_PI_2; cell->beta = M_PI_2; cell->gamma = M_PI_2; cell_update_cartesian(cell); return cell; } void cell_set_parameters(UnitCell *cell, double a, double b, double c, double alpha, double beta, double gamma) { if ( !cell ) return; cell->a = a; cell->b = b; cell->c = c; cell->alpha = alpha; cell->beta = beta; cell->gamma = gamma; cell_update_cartesian(cell); } void cell_get_parameters(UnitCell *cell, double *a, double *b, double *c, double *alpha, double *beta, double *gamma) { if ( !cell ) return; *a = cell->a; *b = cell->b; *c = cell->c; *alpha = cell->alpha; *beta = cell->beta; *gamma = cell->gamma; cell_update_cartesian(cell); } void cell_set_cartesian(UnitCell *cell, double ax, double ay, double az, double bx, double by, double bz, double cx, double cy, double cz) { if ( !cell ) return; cell->ax = ax; cell->ay = ay; cell->az = az; cell->bx = bx; cell->by = by; cell->bz = bz; cell->cx = cx; cell->cy = cy; cell->cz = cz; cell_update_crystallographic(cell); } void cell_set_cartesian_a(UnitCell *cell, double ax, double ay, double az) { if ( !cell ) return; cell->ax = ax; cell->ay = ay; cell->az = az; cell_update_crystallographic(cell); } void cell_set_cartesian_b(UnitCell *cell, double bx, double by, double bz) { if ( !cell ) return; cell->bx = bx; cell->by = by; cell->bz = bz; cell_update_crystallographic(cell); } void cell_set_cartesian_c(UnitCell *cell, double cx, double cy, double cz) { if ( !cell ) return; cell->cx = cx; cell->cy = cy; cell->cz = cz; cell_update_crystallographic(cell); } UnitCell *cell_new_from_parameters(double a, double b, double c, double alpha, double beta, double gamma) { UnitCell *cell; cell = cell_new(); if ( !cell ) return NULL; cell_set_parameters(cell, a, b, c, alpha, beta, gamma); return cell; } static UnitCell *cell_new_from_axes(struct rvec as, struct rvec bs, struct rvec cs) { UnitCell *cell; int s; gsl_matrix *m; gsl_matrix *inv; gsl_permutation *perm; double lengths[3]; double angles[3]; cell = cell_new(); if ( !cell ) return NULL; lengths[0] = modulus(as.u, as.v, as.w); lengths[1] = modulus(bs.u, bs.v, bs.w); lengths[2] = modulus(cs.u, cs.v, cs.w); angles[0] = angle_between(bs.u, bs.v, bs.w, cs.u, cs.v, cs.w); angles[1] = angle_between(as.u, as.v, as.w, cs.u, cs.v, cs.w); angles[2] = angle_between(as.u, as.v, as.w, bs.u, bs.v, bs.w); /* STATUS("as = %9.3e %9.3e %9.3e m^-1\n", as.u, as.v, as.w); STATUS("bs = %9.3e %9.3e %9.3e m^-1\n", bs.u, bs.v, bs.w); STATUS("cs = %9.3e %9.3e %9.3e m^-1\n", cs.u, cs.v, cs.w); STATUS("Creating with %9.3e %9.3e %9.3e m^-1\n", lengths[0], lengths[1], lengths[2]); STATUS("Creating with %5.2f %5.2f %5.2f deg\n", rad2deg(angles[0]), rad2deg(angles[1]), rad2deg(angles[2])); */ m = gsl_matrix_alloc(3, 3); gsl_matrix_set(m, 0, 0, as.u); gsl_matrix_set(m, 0, 1, as.v); gsl_matrix_set(m, 0, 2, as.w); gsl_matrix_set(m, 1, 0, bs.u); gsl_matrix_set(m, 1, 1, bs.v); gsl_matrix_set(m, 1, 2, bs.w); gsl_matrix_set(m, 2, 0, cs.u); gsl_matrix_set(m, 2, 1, cs.v); gsl_matrix_set(m, 2, 2, cs.w); /* Invert */ perm = gsl_permutation_alloc(m->size1); inv = gsl_matrix_alloc(m->size1, m->size2); gsl_linalg_LU_decomp(m, perm, &s); gsl_linalg_LU_invert(m, perm, inv); gsl_permutation_free(perm); gsl_matrix_free(m); /* Transpose */ gsl_matrix_transpose(inv); cell->ax = gsl_matrix_get(inv, 0, 0); cell->ay = gsl_matrix_get(inv, 0, 1); cell->az = gsl_matrix_get(inv, 0, 2); cell->bx = gsl_matrix_get(inv, 1, 0); cell->by = gsl_matrix_get(inv, 1, 1); cell->bz = gsl_matrix_get(inv, 1, 2); cell->cx = gsl_matrix_get(inv, 2, 0); cell->cy = gsl_matrix_get(inv, 2, 1); cell->cz = gsl_matrix_get(inv, 2, 2); cell_update_crystallographic(cell); return cell; } void cell_get_cartesian(UnitCell *cell, double *ax, double *ay, double *az, double *bx, double *by, double *bz, double *cx, double *cy, double *cz) { if ( !cell ) return; *ax = cell->ax; *ay = cell->ay; *az = cell->az; *bx = cell->bx; *by = cell->by; *bz = cell->bz; *cx = cell->cx; *cy = cell->cy; *cz = cell->cz; } void cell_get_reciprocal(UnitCell *cell, double *asx, double *asy, double *asz, double *bsx, double *bsy, double *bsz, double *csx, double *csy, double *csz) { int s; gsl_matrix *m; gsl_matrix *inv; gsl_permutation *perm; m = gsl_matrix_alloc(3, 3); gsl_matrix_set(m, 0, 0, cell->ax); gsl_matrix_set(m, 0, 1, cell->bx); gsl_matrix_set(m, 0, 2, cell->cx); gsl_matrix_set(m, 1, 0, cell->ay); gsl_matrix_set(m, 1, 1, cell->by); gsl_matrix_set(m, 1, 2, cell->cy); gsl_matrix_set(m, 2, 0, cell->az); gsl_matrix_set(m, 2, 1, cell->bz); gsl_matrix_set(m, 2, 2, cell->cz); /* Invert */ perm = gsl_permutation_alloc(m->size1); inv = gsl_matrix_alloc(m->size1, m->size2); gsl_linalg_LU_decomp(m, perm, &s); gsl_linalg_LU_invert(m, perm, inv); gsl_permutation_free(perm); gsl_matrix_free(m); /* Transpose */ gsl_matrix_transpose(inv); *asx = gsl_matrix_get(inv, 0, 0); *bsx = gsl_matrix_get(inv, 0, 1); *csx = gsl_matrix_get(inv, 0, 2); *asy = gsl_matrix_get(inv, 1, 0); *bsy = gsl_matrix_get(inv, 1, 1); *csy = gsl_matrix_get(inv, 1, 2); *asz = gsl_matrix_get(inv, 2, 0); *bsz = gsl_matrix_get(inv, 2, 1); *csz = gsl_matrix_get(inv, 2, 2); } void cell_print(UnitCell *cell) { double asx, asy, asz; double bsx, bsy, bsz; double csx, csy, csz; double angles[3]; STATUS(" a b c alpha beta gamma\n"); STATUS("%5.2f %5.2f %5.2f nm %6.2f %6.2f %6.2f deg\n", cell->a*1e9, cell->b*1e9, cell->c*1e9, rad2deg(cell->alpha), rad2deg(cell->beta), rad2deg(cell->gamma)); cell_get_reciprocal(cell, &asx, &asy, &asz, &bsx, &bsy, &bsz, &csx, &csy, &csz); STATUS("a = %10.3e %10.3e %10.3e m\n", cell->ax, cell->ay, cell->az); STATUS("b = %10.3e %10.3e %10.3e m\n", cell->bx, cell->by, cell->bz); STATUS("c = %10.3e %10.3e %10.3e m\n", cell->cx, cell->cy, cell->cz); STATUS("astar = %10.3e %10.3e %10.3e m^-1 (modulus = %10.3e m^-1)\n", asx, asy, asz, modulus(asx, asy, asz)); STATUS("bstar = %10.3e %10.3e %10.3e m^-1 (modulus = %10.3e m^-1)\n", bsx, bsy, bsz, modulus(bsx, bsy, bsz)); STATUS("cstar = %10.3e %10.3e %10.3e m^-1 (modulus = %10.3e m^-1)\n", csx, csy, csz, modulus(csx, csy, csz)); angles[0] = angle_between(bsx, bsy, bsz, csx, csy, csz); angles[1] = angle_between(asx, asy, asz, csx, csy, csz); angles[2] = angle_between(asx, asy, asz, bsx, bsy, bsz); // STATUS("Checking %5.2f %5.2f %5.2f deg\n", rad2deg(angles[0]), // rad2deg(angles[1]), // rad2deg(angles[2])); } #define MAX_CAND (1024) static int within_tolerance(double a, double b, double percent) { double tol = a * (percent/100.0); if ( fabs(b-a) < tol ) return 1; return 0; } struct cvec { struct rvec vec; float na; float nb; float nc; float fom; }; static int same_vector(struct cvec a, struct cvec b) { if ( a.na != b.na ) return 0; if ( a.nb != b.nb ) return 0; if ( a.nc != b.nc ) return 0; return 1; } /* Attempt to make 'cell' fit into 'template' somehow */ UnitCell *match_cell(UnitCell *cell, UnitCell *template, int verbose) { signed int n1l, n2l, n3l; double asx, asy, asz; double bsx, bsy, bsz; double csx, csy, csz; int i, j; double lengths[3]; double angles[3]; struct cvec *cand[3]; UnitCell *new_cell = NULL; float best_fom = HUGE_VAL; int ncand[3] = {0,0,0}; float ltl = 5.0; /* percent */ float angtol = deg2rad(5.0); if ( verbose ) { STATUS("Matching with this model cell: " "----------------------------\n"); cell_print(template); STATUS("-------------------------------" "----------------------------\n"); } cell_get_reciprocal(template, &asx, &asy, &asz, &bsx, &bsy, &bsz, &csx, &csy, &csz); lengths[0] = modulus(asx, asy, asz); lengths[1] = modulus(bsx, bsy, bsz); lengths[2] = modulus(csx, csy, csz); angles[0] = angle_between(bsx, bsy, bsz, csx, csy, csz); angles[1] = angle_between(asx, asy, asz, csx, csy, csz); angles[2] = angle_between(asx, asy, asz, bsx, bsy, bsz); cand[0] = malloc(MAX_CAND*sizeof(struct cvec)); cand[1] = malloc(MAX_CAND*sizeof(struct cvec)); cand[2] = malloc(MAX_CAND*sizeof(struct cvec)); cell_get_reciprocal(cell, &asx, &asy, &asz, &bsx, &bsy, &bsz, &csx, &csy, &csz); /* Negative values mean 1/n, positive means n, zero means zero */ for ( n1l=-2; n1l<=4; n1l++ ) { for ( n2l=-2; n2l<=4; n2l++ ) { for ( n3l=-2; n3l<=4; n3l++ ) { float n1, n2, n3; signed int b1, b2, b3; n1 = (n1l>=0) ? (n1l) : (1.0/n1l); n2 = (n2l>=0) ? (n2l) : (1.0/n2l); n3 = (n3l>=0) ? (n3l) : (1.0/n3l); /* 'bit' values can be +1 or -1 */ for ( b1=-1; b1<=1; b1+=2 ) { for ( b2=-1; b2<=1; b2+=2 ) { for ( b3=-1; b3<=1; b3+=2 ) { double tx, ty, tz; double tlen; int i; n1 *= b1; n2 *= b2; n3 *= b3; tx = n1*asx + n2*asy + n3*asz; ty = n1*bsx + n2*bsy + n3*bsz; tz = n1*csx + n2*csy + n3*csz; tlen = modulus(tx, ty, tz); /* Test modulus for agreement with moduli of template */ for ( i=0; i<3; i++ ) { if ( !within_tolerance(lengths[i], tlen, ltl) ) continue; cand[i][ncand[i]].vec.u = tx; cand[i][ncand[i]].vec.v = ty; cand[i][ncand[i]].vec.w = tz; cand[i][ncand[i]].na = n1; cand[i][ncand[i]].nb = n2; cand[i][ncand[i]].nc = n3; cand[i][ncand[i]].fom = fabs(lengths[i] - tlen); if ( ncand[i] == MAX_CAND ) { ERROR("Too many candidates\n"); } else { ncand[i]++; } } } } } } } } if ( verbose ) { STATUS("Candidates: %i %i %i\n", ncand[0], ncand[1], ncand[2]); } for ( i=0; i angtol ) continue; fom1 = fabs(ang - angles[2]); for ( k=0; k angtol ) continue; fom2 = fom1 + fabs(ang - angles[1]); /* Finally, the angle between the current candidate for * axis 1 and the kth candidate for axis 2 */ ang = angle_between(cand[1][j].vec.u, cand[1][j].vec.v, cand[1][j].vec.w, cand[2][k].vec.u, cand[2][k].vec.v, cand[2][k].vec.w); /* ... it should be angle 0 ... */ if ( fabs(ang - angles[0]) > angtol ) continue; fom3 = fom2 + fabs(ang - angles[0]); fom3 += LWEIGHT * (cand[0][i].fom + cand[1][j].fom + cand[2][k].fom); if ( fom3 < best_fom ) { if ( new_cell != NULL ) free(new_cell); new_cell = cell_new_from_axes(cand[0][i].vec, cand[1][j].vec, cand[2][k].vec); best_fom = fom3; } } } } if ( new_cell != NULL ) { STATUS("Success! --------------- \n"); cell_print(new_cell); } free(cand[0]); free(cand[1]); free(cand[2]); return new_cell; } /* Return sin(theta)/lambda = 1/2d. Multiply by two if you want 1/d */ double resolution(UnitCell *cell, signed int h, signed int k, signed int l) { const double a = cell->a; const double b = cell->b; const double c = cell->c; const double alpha = cell->alpha; const double beta = cell->beta; const double gamma = cell->gamma; const double Vsq = a*a*b*b*c*c*(1 - cos(alpha)*cos(alpha) - cos(beta)*cos(beta) - cos(gamma)*cos(gamma) + 2*cos(alpha)*cos(beta)*cos(gamma) ); const double S11 = b*b*c*c*sin(alpha)*sin(alpha); const double S22 = a*a*c*c*sin(beta)*sin(beta); const double S33 = a*a*b*b*sin(gamma)*sin(gamma); const double S12 = a*b*c*c*(cos(alpha)*cos(beta) - cos(gamma)); const double S23 = a*a*b*c*(cos(beta)*cos(gamma) - cos(alpha)); const double S13 = a*b*b*c*(cos(gamma)*cos(alpha) - cos(beta)); const double brackets = S11*h*h + S22*k*k + S33*l*l + 2*S12*h*k + 2*S23*k*l + 2*S13*h*l; const double oneoverdsq = brackets / Vsq; const double oneoverd = sqrt(oneoverdsq); return oneoverd / 2; }