molstar
Version:
A comprehensive macromolecular library.
77 lines (76 loc) • 3.1 kB
TypeScript
/**
* Copyright (c) 2017 mol* contributors, licensed under MIT, See LICENSE file for more info.
*
* @author David Sehnal <david.sehnal@gmail.com>
*/
import { Mat3 } from '../linear-algebra/3d/mat3';
import { Mat4 } from '../linear-algebra/3d/mat4';
import { Vec3 } from '../linear-algebra/3d/vec3';
interface SymmetryOperator {
readonly name: string;
readonly assembly?: {
/** pointer to `pdbx_struct_assembly.id` or empty string */
readonly id: string;
/** pointers to `pdbx_struct_oper_list.id` or empty list */
readonly operList: string[];
/** (arbitrary) unique id of the operator to be used in suffix */
readonly operId: number;
};
/** pointer to `struct_ncs_oper.id` or -1 */
readonly ncsId: number;
readonly hkl: Vec3;
/** spacegroup symmetry operator index, -1 if not applicable */
readonly spgrOp: number;
readonly matrix: Mat4;
readonly inverse: Mat4;
readonly isIdentity: boolean;
/**
* Suffix based on operator type.
* - Assembly: _assembly.operId
* - Crytal: -op_ijk
* - ncs: _ncsId
*/
readonly suffix: string;
}
declare namespace SymmetryOperator {
const DefaultName = "1_555";
const Default: SymmetryOperator;
const RotationTranslationEpsilon = 0.005;
type CreateInfo = {
assembly?: SymmetryOperator['assembly'];
ncsId?: number;
hkl?: Vec3;
spgrOp?: number;
};
function create(name: string, matrix: Mat4, info?: CreateInfo): SymmetryOperator;
function checkIfRotationAndTranslation(rot: Mat3, offset: Vec3): boolean;
function ofRotationAndOffset(name: string, rot: Mat3, offset: Vec3, ncsId?: number): SymmetryOperator;
function lerpFromIdentity(out: Mat4, op: SymmetryOperator, t: number): Mat4;
function slerp(out: Mat4, src: Mat4, tar: Mat4, t: number): Mat4;
/**
* Apply the 1st and then 2nd operator. ( = second.matrix * first.matrix).
* Keep `name`, `assembly`, `ncsId`, `hkl` and `spgrOpId` properties from second.
*/
function compose(first: SymmetryOperator, second: SymmetryOperator): SymmetryOperator;
interface CoordinateMapper<T extends number> {
(index: T, slot: Vec3): Vec3;
}
interface ArrayMapping<T extends number> {
readonly coordinates: Coordinates;
readonly operator: SymmetryOperator;
readonly invariantPosition: CoordinateMapper<T>;
readonly position: CoordinateMapper<T>;
x(index: T): number;
y(index: T): number;
z(index: T): number;
r(index: T): number;
}
interface Coordinates {
x: ArrayLike<number>;
y: ArrayLike<number>;
z: ArrayLike<number>;
}
function createMapping<T extends number>(operator: SymmetryOperator, coords: Coordinates, radius?: ((index: T) => number)): ArrayMapping<T>;
function createCoordinateMapper<T extends number>(t: SymmetryOperator, coords: Coordinates): CoordinateMapper<T>;
}
export { SymmetryOperator };