Package com.digitizer.core

Class Dataset

java.lang.Object
com.digitizer.core.Dataset
public class Dataset extends Object
Represents a dataset with a name, color and a mutable collection of Points.

Each dataset contains a user-visible name and a CSS hex color string. The color is cached as a Color for efficient rendering on the CanvasPanel. While datasets may be modified at runtime, callers should generally avoid changing internal lists directly unless intentionally editing the dataset state.

  • Constructor Details

    • Dataset

      public Dataset(String name, String hexColor)
      Constructs a new Dataset with the given name and hex color.
      Parameters:
      name - the dataset name (user-visible label)
      hexColor - the color as a hex string (e.g., "#0072B2")

    • Dataset

      public Dataset(Dataset other)
      Copy constructor for creating a new instance with the same data.
      Parameters:
      other - the dataset to copy

  • Method Details

    • isVisible

      public boolean isVisible()
      Returns whether the dataset is visible on the canvas.
      Returns:
      true if visible

    • setVisible

      public void setVisible(boolean visible)
      Sets the dataset visibility.
      Parameters:
      visible - true to show the dataset

    • getName

      public String getName()
      Gets the dataset name (label shown in the UI).
      Returns:
      the dataset name

    • setName

      public void setName(String name)
      Sets the dataset name.
      Parameters:
      name - the new dataset name (must not be null)

    • getHexColor

      public String getHexColor()
      Gets the dataset color expressed as a hex string (e.g. "#0072B2").
      Returns:
      the hex color string

    • setHexColor

      public void setHexColor(String hexColor)
      Sets the dataset hex color and updates the cached Color.
      Parameters:
      hexColor - the hex color string (must not be null)

    • getColor

      public javafx.scene.paint.Color getColor()
      Gets the cached Color used for rendering.
      Returns:
      the JavaFX Color for this dataset

    • isUseSecondaryYAxis

      public boolean isUseSecondaryYAxis()
      Returns whether this dataset should be plotted against the secondary Y axis.
      Returns:
      true if using the secondary Y axis

    • setUseSecondaryYAxis

      public void setUseSecondaryYAxis(boolean useSecondaryYAxis)
      Sets whether this dataset should use the secondary Y axis.
      Parameters:
      useSecondaryYAxis - true to map this dataset to the secondary Y axis

    • getPoints

      public List<Point> getPoints()
      Returns the mutable list of points belonging to this dataset.
      Returns:
      list of Point objects (never null)

    • setPoints

      public void setPoints(List<Point> points)
      Replaces the internal points list. Caller must provide a non-null list.
      Parameters:
      points - the new list of points (must not be null)

    • addPoint

      public void addPoint(Point point)
      Adds a point to this dataset.
      Parameters:
      point - the point to add (must not be null)

    • removePoint

      public boolean removePoint(Point point)
      Removes a point from this dataset.
      Parameters:
      point - the point to remove
      Returns:
      true if the point was removed, false if it was not in the list

    • removePoint

      public Point removePoint(int index)
      Removes a point at the specified index.
      Parameters:
      index - the index of the point to remove
      Returns:
      the removed point
      Throws:
      IndexOutOfBoundsException - if the index is out of range

    • clearPoints

      public void clearPoints()
      Clears all points from this dataset.

    • getPointCount

      public int getPointCount()
      Gets the number of points in this dataset.
      Returns:
      the point count

    • toString

      public String toString()
      Overrides:
      toString in class Object

    • equals

      public boolean equals(Object o)
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object