Class FlatData

src/org/opensourcephysics/display2d/FlatData.java:27–549

FlatData stores numeric data for 2d visualizations using a single array. Components are stored in the array in row-major order. Data components can represent almost anything. For example, we store an n by m grid of complex numbers as follows: data=new double [2 n m]<\code> <\pre>

 * @version    1.0
 */
public class FlatData implements GridData {
  protected double[] data;
  protected double left, right, bottom, top;
  protected double dx = 0, dy = 0;
  protected boolean cellData = false;
  protected String[] names;
  int nx, ny, stride;

  /**
   * FlatData constructor.  The data array will contain ncomponents*ix*iy values.
   *
   * @param ix  the number of x values
   * @param iy  the number of y values
   * @param ncomponents the number of components
   */
  public FlatData(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$
    }
    nx = ix;
    ny = iy;
    stride = ncomponents;
    data = new double[ncomponents*ix*iy]; // 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$
    }
  }

  /**
   * 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
public String getComponentName(int i) {
    return names[i];
  }

  /**
   * Gets the number of data components.
   *
   * @return int