Class GridPointData

src/org/opensourcephysics/display2d/GridPointData.java:39–574

GridPointData stores numeric data on a scaled rectangular grid using an array of points. Every grid point contains the x and y coordinates and one or more components. The first component is usually the magnitude of the quantity of interest. Components can represent almost anything. For example, we

 * @version    1.1
 */
public class GridPointData implements GridData {
  protected double[][][] data;
  protected double left, right, bottom, top;
  protected double dx = 0, dy = 0;
  protected boolean cellData = false;
  protected String[] names;

  /**
   * Constructor Data2D
   *
   * @param ix
   * @param iy
   * @param ncomponents
   */
  public GridPointData(int ix, int iy, int ncomponents) {
    if((iy<1)||(ix<1)) {
      throw new IllegalArgumentException("Number of dataset rows and columns must be positive. Your row="+iy+"  col="+ix); //$NON-NLS-1$ //$NON-NLS-2$
    }
    if((ncomponents<1)) {
      throw new IllegalArgumentException("Number of 2d data components must be positive. Your ncomponents="+ncomponents); //$NON-NLS-1$
    }
    data = new double[ix][iy][ncomponents+2]; // x, y, and components
    setScale(0, ix, 0, iy);
    names = new String[ncomponents];
    for(int i = 0; i<ncomponents; i++) {
      names[i] = "Component_"+i; //$NON-NLS-1$
    }
  }

  /**
   * Creates a new GridPointData object with the same grid points and the given number of components.
   *
   * @param ncomponents number of samples dataset.
   * @return the newly created  Data2D
   */
  public GridPointData createGridPointData(int ncomponents) {
    GridPointData data2d = new GridPointData(data.length, data[0].length, ncomponents+2);
    data2d.setScale(left, right, bottom, top);
    return data2d;
  }

  /**
   * Sets the name of the component.
   *
   * @param i int the component index
   * @param name String
   */
  @Override
public void setComponentName(int i, String name) {
    names[i] = name;
  }

  /**
   * Gets the name of the component,
   * @param i int the component index
   * @return String the name
   */
  @Override