inra.ijpb.geometry

Class Ellipsoid

java.lang.Object

inra.ijpb.geometry.Ellipsoid

public class Ellipsoid
extends Object

An ellipsoid in the 3D space, defined by a center, three radius, and three orientation angles.

Author:

dlegland

Constructor Summary

Constructors

Constructor and Description
Ellipsoid(double xc, double yc, double zc, double r1, double r2, double r3, double phi, double theta, double psi) Creates a new 3D Ellipsoid
Ellipsoid(Point3D center, double r1, double r2, double r3) Creates a new 3D Ellipsoid parallel to the three main axes.
Ellipsoid(Point3D center, double r1, double r2, double r3, double phi, double theta, double psi) Creates a new 3D Ellipsoid

Method Summary

Modifier and Type	Method and Description
Point3D	center()
static Point3D[]	centers(Ellipsoid[] ellipsoids) Initializes center array from ellipsoid array.
static double[][]	elongations(Ellipsoid[] ellipsoids) Computes the three elongation factors for an array of ellipsoids.
double	phi()
double	psi()
double	radius1()
double	radius2()
double	radius3()
double	theta()

Methods inherited from class java.lang.Object

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

Constructor Detail

Ellipsoid

public Ellipsoid(Point3D center,
                 double r1,
                 double r2,
                 double r3)

Creates a new 3D Ellipsoid parallel to the three main axes.

Parameters:

center - the center of the ellipsoid

r1 - the length of the largest semi-axis

r2 - the length of the second largest semi-axis

r3 - the length of the smallest semi-axis

Ellipsoid

public Ellipsoid(Point3D center,
                 double r1,
                 double r2,
                 double r3,
                 double phi,
                 double theta,
                 double psi)

Creates a new 3D Ellipsoid

Parameters:

center - the center of the ellipsoid

r1 - the length of the largest semi-axis

r2 - the length of the second largest semi-axis

r3 - the length of the smallest semi-axis

phi - the azimut of the main axis, in degrees

theta - the elevation of the main axis, in degrees

psi - the roll of the ellipsoid around the main axis, in degrees.

Ellipsoid

public Ellipsoid(double xc,
                 double yc,
                 double zc,
                 double r1,
                 double r2,
                 double r3,
                 double phi,
                 double theta,
                 double psi)

Creates a new 3D Ellipsoid

Parameters:

xc - the x-coordinate of ellipsoid center

yc - the y-coordinate of ellipsoid center

zc - the z-coordinate of ellipsoid center

r1 - the length of the largest semi-axis

r2 - the length of the second largest semi-axis

r3 - the length of the smallest semi-axis

phi - the azimut of the main axis, in degrees

theta - the elevation of the main axis, in degrees

psi - the roll of the ellipsoid around the main axis, in degrees.

Method Detail

centers

public static final Point3D[] centers(Ellipsoid[] ellipsoids)

Initializes center array from ellipsoid array.

Parameters:

ellipsoids - an array of ellipsoids

Returns:

the array of points corresponding to the centers of the ellipsoids.

elongations

public static final double[][] elongations(Ellipsoid[] ellipsoids)

Computes the three elongation factors for an array of ellipsoids.

 ImageStack labelImage = ...
 int[] labels = LabelImages.findAllLabels(image);
 Calibation calib = new Calibration();
 Ellipsoid[] ellipsoids = new EquivalentEllipsoid().analyzeRegions(labelImage, labels, calib);
 double[][] elongations = Ellipsoid.elongations(ellipsoids);
 

Parameters:

ellipsoids - an array of ellipsoids

Returns:

an array of elongation factors. When radii are ordered such that R1 > R2 > R3, the three elongation factors are defined by ratio of R1 by R2, ratio of R1 by R3, and ratio of R2 by R3.

center

public Point3D center()

Returns:

the center of the ellipsoid

radius1

public double radius1()

Returns:

the length of the largest semi-axis

radius2

public double radius2()

Returns:

the length of the second largest semi-axis

radius3

public double radius3()

Returns:

the length of the smallest semi-axis

phi

public double phi()

Returns:

the azimut of the main axis, in degrees

theta

public double theta()

Returns:

the elevation of the main axis, in degrees

psi

public double psi()

Returns:

the roll of the ellipsoid around the main axis, in degrees.