Class StdDraw3D.Vector3D

java.lang.Object

StdDraw3D.Vector3D

Enclosing class:

StdDraw3D

public static class StdDraw3D.Vector3D
extends java.lang.Object

An immutable three-dimensional vector class with useful vector operations.

Since:

2011.0310

Field Summary

Fields

Modifier and Type	Field and Description
double	x X-coordinate - immutable but directly accessible.
double	y Y-coordinate - immutable but directly accessible.
double	z Z-coordinate - immutable but directly accessible.

Constructor Summary

Constructors

Constructor and Description
StdDraw3D.Vector3D() Initializes to zero vector.
StdDraw3D.Vector3D(double[] c) Initializes to the given coordinates.
StdDraw3D.Vector3D(double x, double y, double z) Initializes to the given coordinates.

Method Summary

Methods

Modifier and Type	Method and Description
double	angle(StdDraw3D.Vector3D that) Returns the smallest angle between this and that vector, in DEGREES.
StdDraw3D.Vector3D	cross(StdDraw3D.Vector3D that) Returns the cross product of this vector with that vector.
StdDraw3D.Vector3D	direction() Returns the unit vector in the direction of this vector.
double	distanceTo(StdDraw3D.Vector3D that) Returns the Euclidian distance between this and that.
double	dot(StdDraw3D.Vector3D that) Returns the dot product of this and that.
void	draw() Draws this vector as a point from the origin to StdDraw3D.
double	mag() Returns the magnitude of this vector.
StdDraw3D.Vector3D	minus(double x, double y, double z)
StdDraw3D.Vector3D	minus(StdDraw3D.Vector3D that) Returns the difference of this and that vector.
StdDraw3D.Vector3D	plus(double x, double y, double z)
StdDraw3D.Vector3D	plus(StdDraw3D.Vector3D that) Returns the sum of this and that vector.
StdDraw3D.Vector3D	proj(StdDraw3D.Vector3D line) Returns the projection of this onto the given line.
StdDraw3D.Vector3D	reflect(StdDraw3D.Vector3D line) Reflects this vector across the direction given by line.
StdDraw3D.Vector3D	times(double k) Returns the product of this vector and the scalar k.
StdDraw3D.Vector3D	times(double a, double b, double c) Returns the result (this.x * a, this.y * b, this.z * c).
java.lang.String	toString() Returns a string representation of this vector.

Methods inherited from class java.lang.Object

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

Field Detail

x

public final double x

X-coordinate - immutable but directly accessible.

y

public final double y

Y-coordinate - immutable but directly accessible.

z

public final double z

Z-coordinate - immutable but directly accessible.

Constructor Detail

StdDraw3D.Vector3D

public StdDraw3D.Vector3D()

Initializes to zero vector.

StdDraw3D.Vector3D

public StdDraw3D.Vector3D(double x,
                  double y,
                  double z)

Initializes to the given coordinates.

Parameters:

x - X-coordinate

y - Y-coordinate

z - Z-coordinate

StdDraw3D.Vector3D

public StdDraw3D.Vector3D(double[] c)

Initializes to the given coordinates.

Parameters:

c - Array length 3 of coordinates (x, y, z,).

Method Detail

dot

public double dot(StdDraw3D.Vector3D that)

Returns the dot product of this and that.

Parameters:

that - Vector to dot with

Returns:

This dot that

mag

public double mag()

Returns the magnitude of this vector.

Returns:

Magnitude of vector

angle

public double angle(StdDraw3D.Vector3D that)

Returns the smallest angle between this and that vector, in DEGREES.

Returns:

Angle between the vectors, in DEGREES

distanceTo

public double distanceTo(StdDraw3D.Vector3D that)

Returns the Euclidian distance between this and that.

Parameters:

that - Vector to compute distance between

Returns:

Distance between this and that

plus

public StdDraw3D.Vector3D plus(StdDraw3D.Vector3D that)

Returns the sum of this and that vector.

Parameters:

that - Vector to compute sum with

Returns:

This plus that

plus

public StdDraw3D.Vector3D plus(double x,
                      double y,
                      double z)

minus

public StdDraw3D.Vector3D minus(StdDraw3D.Vector3D that)

Returns the difference of this and that vector.

Parameters:

that - Vector to compute difference with

Returns:

This minus that

minus

public StdDraw3D.Vector3D minus(double x,
                       double y,
                       double z)

times

public StdDraw3D.Vector3D times(double k)

Returns the product of this vector and the scalar k.

Parameters:

k - Scalar to multiply by

Returns:

(this.x * k, this.y * k, this.z * k)

times

public StdDraw3D.Vector3D times(double a,
                       double b,
                       double c)

Returns the result (this.x * a, this.y * b, this.z * c).

Parameters:

a - Scalar to multiply x by

b - Scalar to multiply y by

c - Scalar to multiply z by

Returns:

(this.x * a, this.y * b, this.z * c)

direction

public StdDraw3D.Vector3D direction()

Returns the unit vector in the direction of this vector.

Returns:

Unit vector with direction of this vector

proj

public StdDraw3D.Vector3D proj(StdDraw3D.Vector3D line)

Returns the projection of this onto the given line.

Parameters:

line - Direction to project this vector onto

Returns:

This projected onto line

cross

public StdDraw3D.Vector3D cross(StdDraw3D.Vector3D that)

Returns the cross product of this vector with that vector.

Returns:

This cross that

reflect

public StdDraw3D.Vector3D reflect(StdDraw3D.Vector3D line)

Reflects this vector across the direction given by line.

Parameters:

line - Direction to reflect this vector over

Returns:

This reflected over line

toString

public java.lang.String toString()

Returns a string representation of this vector.

Overrides:

toString in class java.lang.Object

Returns:

"( this.x, this.y, this.z)"

draw

public void draw()

Draws this vector as a point from the origin to StdDraw3D.