/* * cell_tool.c * * Unit cell tool * * Copyright © 2018 Deutsches Elektronen-Synchrotron DESY, * a research centre of the Helmholtz Association. * * Authors: * 2012-2018 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 #include #include #include "cell.h" #include "cell-utils.h" #include "reflist-utils.h" #include "reflist.h" static void show_help(const char *s) { printf("Syntax: %s [options]\n\n", s); printf( "Unit cell manipulation tool.\n" "\n" " -h, --help Display this help message.\n" " -p, --pdb= Get unit cell from (PDB or CrystFEL format).\n" " -o Output unit cell file.\n" "\n" " Actions:\n" " --find-ambi Find indexing ambiguities for the cell.\n" " --uncenter Calculate a primitive cell.\n" " --rings Calculate powder ring positions.\n" " --compare-cell Compare unit cell with cell from .\n" " --cell-choices Calculate all three cell choices for monoclinic C cell.\n" " --transform= Transform unit cell.\n" "\n" " -y Real point group of the structure.\n" " --tolerance= Set the tolerances for cell comparison.\n" " Default: 5,1.5 (axis percentage, angle deg).\n" " --highres=n Resolution limit (Angstroms) for --rings\n" ); } static int comparecells(UnitCell *cell, const char *comparecell, double ltl, double atl) { UnitCell *cell2; RationalMatrix *m; cell2 = load_cell_from_file(comparecell); if ( cell2 == NULL ) { ERROR("Failed to load unit cell from '%s'\n", comparecell); return 1; } if ( validate_cell(cell2) > 1 ) { ERROR("Comparison cell is invalid.\n"); return 1; } STATUS("------------------> The reference unit cell:\n"); cell_print(cell2); STATUS("------------------> The comparison results:\n"); if ( !compare_reindexed_cell_parameters(cell, cell2, ltl, atl, &m) ) { STATUS("No relationship found between lattices.\n"); return 0; } else { UnitCell *trans; STATUS("Relationship found. To become similar to the reference" " cell, the input cell should be transformed by:\n"); rtnl_mtx_print(m); STATUS("Transformed version of input unit cell:\n"); trans = cell_transform_rational(cell, m); cell_print(trans); cell_free(trans); STATUS("NB transformed cell might not really be triclinic, " "it's just that I don't (yet) know how to work out what " "it is.\n"); } rtnl_mtx_free(m); return 0; } struct sortmerefl { signed int h; signed int k; signed int l; double resolution; int multi; }; static int cmpres(const void *av, const void *bv) { const struct sortmerefl *a = av; const struct sortmerefl *b = bv; return a->resolution > b->resolution; } static int all_rings(UnitCell *cell, SymOpList *sym, double mres) { double ax, ay, az; double bx, by, bz; double cx, cy, cz; int hmax, kmax, lmax; signed int h, k, l; RefList *list; int i, n; RefListIterator *iter; Reflection *refl; struct sortmerefl *sortus; cell_get_cartesian(cell, &ax, &ay, &az, &bx, &by, &bz, &cx, &cy, &cz); hmax = mres * modulus(ax, ay, az); kmax = mres * modulus(bx, by, bz); lmax = mres * modulus(cx, cy, cz); list = reflist_new(); for ( h=-hmax; h<=hmax; h++ ) { for ( k=-kmax; k<=kmax; k++ ) { for ( l=-lmax; l<=lmax; l++ ) { signed int ha, ka, la; if ( forbidden_reflection(cell, h, k, l) ) continue; if ( 2.0*resolution(cell, h, k, l) > mres ) continue; if ( sym != NULL ) { Reflection *refl; get_asymm(sym, h, k, l, &ha, &ka, &la); refl = find_refl(list, ha, ka, la); if ( refl == NULL ) { refl = add_refl(list, ha, ka, la); set_redundancy(refl, 1); } else { set_redundancy(refl, get_redundancy(refl)+1); } } else { Reflection *refl; refl = add_refl(list, h, k, l); set_redundancy(refl, 1); } } } } n = num_reflections(list); sortus = malloc(n*sizeof(struct sortmerefl)); i = 0; for ( refl = first_refl(list, &iter); refl != NULL; refl = next_refl(refl, iter) ) { signed int h, k, l; get_indices(refl, &h, &k, &l); sortus[i].h = h; sortus[i].k = k; sortus[i].l = l; sortus[i].resolution = 2.0*resolution(cell, h, k, l); /* one over d */ sortus[i].multi = get_redundancy(refl); i++; } qsort(sortus, n, sizeof(struct sortmerefl), cmpres); STATUS("\nAll powder rings up to %f Ångstrøms.\n", 1e+10/mres); STATUS("Note that screw axis or glide plane absences are not " "omitted from this list.\n"); STATUS("\n d (Å) 1/d (m^-1) h k l multiplicity\n"); STATUS("------------------------------------------------------\n"); for ( i=0; i The primitive unit cell:\n"); cell_print(cnew); STATUS("------------------> The centering transformation:\n"); intmat_print(C); STATUS("------------------> The un-centering transformation:\n"); rtnl_mtx_print(Ci); if ( out_file != NULL ) { FILE *fh = fopen(out_file, "w"); if ( fh == NULL ) { ERROR("Failed to open '%s'\n", out_file); return 1; } write_cell(cnew, fh); fclose(fh); } return 0; } static int transform(UnitCell *cell, const char *trans_str, const char *out_file) { RationalMatrix *trans; UnitCell *nc; trans = parse_cell_transformation(trans_str); if ( trans == NULL ) { ERROR("Invalid cell transformation '%s'\n", trans_str); return 1; } nc = cell_transform_rational(cell, trans); STATUS("------------------> The transformation matrix:\n"); rtnl_mtx_print(trans); STATUS("Determinant = %s\n", rtnl_format(rtnl_mtx_det(trans))); STATUS("------------------> The transformed unit cell:\n"); cell_print(nc); STATUS("NB transformed cell might not really be triclinic, " "it's just that I don't (yet) know how to work out what " "it is.\n"); if ( out_file != NULL ) { FILE *fh = fopen(out_file, "w"); if ( fh == NULL ) { ERROR("Failed to open '%s'\n", out_file); return 1; } write_cell(nc, fh); fclose(fh); } return 0; } static int cell_choices(UnitCell *cell) { if ( cell_get_lattice_type(cell) != L_MONOCLINIC ) { ERROR("Cell must be monoclinic to use --cell-choices\n"); return 1; } if ( cell_get_unique_axis(cell) == 'b' ) { transform(cell, "-a-c,b,a", NULL); transform(cell, "c,b,-a-c", NULL); } else { ERROR("Sorry, --cell-choices only supports unique axis b.\n"); return 1; } return 0; } enum { CT_NOTHING, CT_FINDAMBI, CT_UNCENTER, CT_RINGS, CT_COMPARE, CT_CHOICES, CT_TRANSFORM, }; int main(int argc, char *argv[]) { int c; char *cell_file = NULL; UnitCell *cell; char *toler = NULL; float ltl = 0.05; /* fraction */ float atl = deg2rad(1.5); /* radians */ char *sym_str = NULL; SymOpList *sym = NULL; int mode = CT_NOTHING; char *comparecell = NULL; char *out_file = NULL; float highres; double rmax = 1/(2.0e-10); char *trans_str = NULL; /* Long options */ const struct option longopts[] = { {"help", 0, NULL, 'h'}, {"pdb", 1, NULL, 'p'}, {"tolerance", 1, NULL, 2}, {"output", 1, NULL, 'o'}, /* Modes of operation */ {"find-ambi", 0, &mode, CT_FINDAMBI}, {"uncenter", 0, &mode, CT_UNCENTER}, {"uncentre", 0, &mode, CT_UNCENTER}, {"rings", 0, &mode, CT_RINGS}, {"compare-cell", 1, NULL, 3}, {"cell-choices", 0, &mode, CT_CHOICES}, {"transform", 1, NULL, 4}, {"highres", 1, NULL, 5}, {0, 0, NULL, 0} }; /* Short options */ while ((c = getopt_long(argc, argv, "hp:y:o:", longopts, NULL)) != -1) { switch (c) { case 'h' : show_help(argv[0]); return 0; case 'p' : cell_file = strdup(optarg); break; case 'o' : out_file = strdup(optarg); break; case 'y' : sym_str = strdup(optarg); break; case 2 : toler = strdup(optarg); break; case 3 : comparecell = strdup(optarg); mode = CT_COMPARE; break; case 4 : trans_str = strdup(optarg); mode = CT_TRANSFORM; break; case 5 : if ( sscanf(optarg, "%e", &highres) != 1 ) { ERROR("Invalid value for --highres\n"); return 1; } rmax = 1.0 / (highres/1e10); break; case 0 : break; default : return 1; } } /* If there's a parameter left over, we assume it's the unit cell */ if ( (argc > optind) && (cell_file == NULL) ) { cell_file = strdup(argv[optind++]); } /* If there's STILL a parameter left over, complain*/ if ( argc > optind ) { ERROR("Excess command-line arguments:\n"); do { ERROR("'%s'\n", argv[optind++]); } while ( argc > optind ); return 1; } if ( cell_file == NULL ) { ERROR("You must give a filename for the unit cell PDB file.\n"); return 1; } STATUS("Input unit cell: %s\n", cell_file); cell = load_cell_from_file(cell_file); if ( cell == NULL ) { ERROR("Failed to load cell from '%s'\n", cell_file); return 1; } free(cell_file); if ( toler != NULL ) { int i; int ncomma = 0; size_t l = strlen(toler); for ( i=0; i The input unit cell:\n"); cell_print(cell); if ( validate_cell(cell) > 1 ) { ERROR("Cell is invalid.\n"); return 1; } if ( sym_str != NULL ) { sym = get_pointgroup(sym_str); if ( sym == NULL ) return 1; free(sym_str); } if ( mode == CT_NOTHING ) { ERROR("Please specify mode of operation (see --help)\n"); return 1; } if ( mode == CT_FINDAMBI ) return find_ambi(cell, sym, ltl, atl); if ( mode == CT_UNCENTER ) return uncenter(cell, out_file); if ( mode == CT_RINGS ) return all_rings(cell, sym, rmax); if ( mode == CT_COMPARE ) return comparecells(cell, comparecell, ltl, atl); if ( mode == CT_TRANSFORM ) return transform(cell, trans_str, out_file); if ( mode == CT_CHOICES ) return cell_choices(cell); return 1; }