//******************************************************************************
//
// File: ArrayXYZSeries.java
// Package: edu.rit.numeric
// Unit: Class edu.rit.numeric.ArrayXYZSeries
//
// This Java source file is copyright (C) 2008 by Alan Kaminsky. All rights
// reserved. For further information, contact the author, Alan Kaminsky, at
// ark@cs.rit.edu.
//
// This Java source file is part of the Parallel Java Library ("PJ"). PJ 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.
//
// PJ 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.
//
// A copy of the GNU General Public License is provided in the file gpl.txt. You
// may also obtain a copy of the GNU General Public License on the World Wide
// Web at http://www.gnu.org/licenses/gpl.html.
//
//******************************************************************************
package edu.rit.numeric;
import java.io.Externalizable;
import java.io.IOException;
import java.io.ObjectInput;
import java.io.ObjectOutput;
/**
* Class ArrayXYZSeries provides an {@linkplain XYZSeries} view of values stored
* in arrays. Changing the contents of the arrays will change the
* ArrayXYZSeries.
*
* @author Alan Kaminsky
* @version 17-Jun-2008
*/
public class ArrayXYZSeries
extends XYZSeries
implements Externalizable
{
// Hidden data members.
private static final long serialVersionUID = 8763124349962266396L;
private double[] xarray;
private double[] yarray;
private double[] zarray;
// Exported constructors.
/**
* Construct a new uninitialized array X-Y-Z series. This constructor is for
* use only by object deserialization.
*/
public ArrayXYZSeries()
{
}
/**
* Construct a new array X-Y-Z series.
*
* @param xarray Array of X values.
* @param yarray Array of Y values.
* @param zarray Array of Z values.
*
* @exception NullPointerException
* (unchecked exception) Thrown if xarray is null,
* yarray is null, or zarray is null.
* @exception IllegalArgumentException
* (unchecked exception) Thrown if xarray, yarray, and
* zarray are not the same length.
*/
public ArrayXYZSeries
(double[] xarray,
double[] yarray,
double[] zarray)
{
if (xarray == null)
{
throw new NullPointerException
("ArrayXYZSeries(): xarray is null");
}
if (yarray == null)
{
throw new NullPointerException
("ArrayXYZSeries(): yarray is null");
}
if (zarray == null)
{
throw new NullPointerException
("ArrayXYZSeries(): zarray is null");
}
if (xarray.length != yarray.length)
{
throw new IllegalArgumentException
("ArrayXYZSeries(): xarray length (= "+xarray.length+
") != yarray length (= "+yarray.length+"), illegal");
}
if (xarray.length != zarray.length)
{
throw new IllegalArgumentException
("ArrayXYZSeries(): xarray length (= "+xarray.length+
") != zarray length (= "+zarray.length+"), illegal");
}
this.xarray = xarray;
this.yarray = yarray;
this.zarray = zarray;
}
// Exported operations.
/**
* Returns the number of values in this series.
*
* @return Length.
*/
public int length()
{
return xarray.length;
}
/**
* Returns the given X value in this series.
*
* @param i Index.
*
* @return The X value in this series at index i.
*
* @exception ArrayIndexOutOfBoundsException
* (unchecked exception) Thrown if i is not in the range
* 0 .. length()-1.
*/
public double x
(int i)
{
return xarray[i];
}
/**
* Returns the given Y value in this series.
*
* @param i Index.
*
* @return The Y value in this series at index i.
*
* @exception ArrayIndexOutOfBoundsException
* (unchecked exception) Thrown if i is not in the range
* 0 .. length()-1.
*/
public double y
(int i)
{
return yarray[i];
}
/**
* Returns the given Z value in this series.
*
* @param i Index.
*
* @return The Z value in this series at index i.
*
* @exception ArrayIndexOutOfBoundsException
* (unchecked exception) Thrown if i is not in the range
* 0 .. length()-1.
*/
public double z
(int i)
{
return zarray[i];
}
/**
* Returns a {@linkplain Series} view of the X values in this XYZ series.
*
* Note: The returned Series object is backed by this XYZ series
* object. Changing the contents of this XYZ series object will change the
* contents of the returned Series object.
*
* @return Series of X values.
*/
public Series xSeries()
{
return new ArraySeries (xarray);
}
/**
* Returns a {@linkplain Series} view of the Y values in this XYZ series.
*
* Note: The returned Series object is backed by this XYZ series
* object. Changing the contents of this XYZ series object will change the
* contents of the returned Series object.
*
* @return Series of Y values.
*/
public Series ySeries()
{
return new ArraySeries (yarray);
}
/**
* Returns a {@linkplain Series} view of the Z values in this XY series.
*
* Note: The returned Series object is backed by this XYZ series
* object. Changing the contents of this XYZ series object will change the
* contents of the returned Series object.
*
* @return Series of Z values.
*/
public Series zSeries()
{
return new ArraySeries (zarray);
}
/**
* Write this X-Y-Z series to the given object output stream.
*
* @param out Object output stream.
*
* @exception IOException
* Thrown if an I/O error occurred.
*/
public void writeExternal
(ObjectOutput out)
throws IOException
{
int n = xarray.length;
out.writeInt (n);
for (int i = 0; i < n; ++ i)
{
out.writeDouble (xarray[i]);
out.writeDouble (yarray[i]);
out.writeDouble (zarray[i]);
}
}
/**
* Read this X-Y-Z series from the given object input stream.
*
* @param in Object input stream.
*
* @exception IOException
* Thrown if an I/O error occurred.
*/
public void readExternal
(ObjectInput in)
throws IOException
{
int n = in.readInt();
xarray = new double [n];
yarray = new double [n];
zarray = new double [n];
for (int i = 0; i < n; ++ i)
{
xarray[i] = in.readDouble();
yarray[i] = in.readDouble();
zarray[i] = in.readDouble();
}
}
}
Ads help maintain this website.