org.openscience.cdk.geometry

Class CrystalGeometryTools

java.lang.Object

org.openscience.cdk.geometry.CrystalGeometryTools

@TestClass(value="org.openscience.cdk.geometry.CrystalGeometryToolsTest")
public class CrystalGeometryTools
extends Object

A set of static methods for working with crystal coordinates.

Author:

Egon Willighagen

Keywords:

fractional coordinates, crystal

Constructor Summary

Constructors

Constructor and Description
CrystalGeometryTools()

Method Summary

Methods

Modifier and Type	Method and Description
static javax.vecmath.Vector3d[]	calcInvertedAxes(javax.vecmath.Vector3d aAxis, javax.vecmath.Vector3d bAxis, javax.vecmath.Vector3d cAxis) Inverts three cell axes.
static javax.vecmath.Point3d	cartesianToFractional(javax.vecmath.Vector3d aAxis, javax.vecmath.Vector3d bAxis, javax.vecmath.Vector3d cAxis, javax.vecmath.Point3d cartPoint)
static double[]	cartesianToNotional(javax.vecmath.Vector3d aAxis, javax.vecmath.Vector3d bAxis, javax.vecmath.Vector3d cAxis)
static void	fractionalToCartesian(ICrystal crystal) Creates cartesian coordinates for all Atoms in the Crystal.
static javax.vecmath.Point3d	fractionalToCartesian(javax.vecmath.Vector3d aAxis, javax.vecmath.Vector3d bAxis, javax.vecmath.Vector3d cAxis, javax.vecmath.Point3d frac)
static boolean	hasCrystalCoordinates(IAtomContainer container) Determines if this model contains fractional (crystal) coordinates.
static javax.vecmath.Vector3d[]	notionalToCartesian(double alength, double blength, double clength, double alpha, double beta, double gamma) Calculates cartesian vectors for unit cell axes from axes lengths and angles between axes.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CrystalGeometryTools

public CrystalGeometryTools()

Method Detail

calcInvertedAxes

@TestMethod(value="testCalcInvertedAxes_Vector3d_Vector3d_Vector3d")
public static javax.vecmath.Vector3d[] calcInvertedAxes(javax.vecmath.Vector3d aAxis,
                                                        javax.vecmath.Vector3d bAxis,
                                                        javax.vecmath.Vector3d cAxis)

Inverts three cell axes.

Returns:

a 3x3 matrix with the three cartesian vectors representing the unit cell axes. The a axis is the first row.

cartesianToFractional

@TestMethod(value="testCartesianToFractional_Vector3d_Vector3d_Vector3d_Point3d")
public static javax.vecmath.Point3d cartesianToFractional(javax.vecmath.Vector3d aAxis,
                                                          javax.vecmath.Vector3d bAxis,
                                                          javax.vecmath.Vector3d cAxis,
                                                          javax.vecmath.Point3d cartPoint)

fractionalToCartesian

@TestMethod(value="testFractionalToCartesian_Vector3d_Vector3d_Vector3d_Point3d")
public static javax.vecmath.Point3d fractionalToCartesian(javax.vecmath.Vector3d aAxis,
                                                          javax.vecmath.Vector3d bAxis,
                                                          javax.vecmath.Vector3d cAxis,
                                                          javax.vecmath.Point3d frac)

notionalToCartesian

@TestMethod(value="testNotionalToCartesian_double_double_double_double_double_double")
public static javax.vecmath.Vector3d[] notionalToCartesian(double alength,
                                                           double blength,
                                                           double clength,
                                                           double alpha,
                                                           double beta,
                                                           double gamma)

Calculates cartesian vectors for unit cell axes from axes lengths and angles between axes.

To calculate cartesian coordinates, it places the a axis on the x axes, the b axis in the xy plane, making an angle gamma with the a axis, and places the c axis to fullfil the remaining constraints. (See also the CCL archive.)

Parameters:

alength - length of the a axis

blength - length of the b axis

clength - length of the c axis

alpha - angle between b and c axes in degrees

beta - angle between a and c axes in degrees

gamma - angle between a and b axes in degrees

Returns:

an array of Vector3d objects with the three cartesian vectors representing the unit cell axes.

Keywords:

notional coordinates

cartesianToNotional

@TestMethod(value="testCartesianToNotional_Vector3d_Vector3d_Vector3d")
public static double[] cartesianToNotional(javax.vecmath.Vector3d aAxis,
                                           javax.vecmath.Vector3d bAxis,
                                           javax.vecmath.Vector3d cAxis)

hasCrystalCoordinates

public static boolean hasCrystalCoordinates(IAtomContainer container)

Determines if this model contains fractional (crystal) coordinates.

Returns:

boolean indication that 3D coordinates are available

fractionalToCartesian

public static void fractionalToCartesian(ICrystal crystal)

Creates cartesian coordinates for all Atoms in the Crystal.