## org.das2.components.DataPointRecorderNew

DataPointRecorderNew is a GUI for storing data points selected by the user. This is the old recorder but: 1. uses QDataSet to handle the data. No more strange internal object. 2. allows the columns to be declared explicitly by code, and data is merged in by name.

## DataPointRecorderNew( )

Creates a new instance of DataPointRecorder

## addDataPoint

addDataPoint( Datum x, Datum y ) → void

add just the x and y values.

### Parameters

x - the x position
y - the y position

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## addDataPoint

addDataPoint( Datum x, Datum y, Object meta ) → void

add the x and y values with unnamed metadata.

### Parameters

x - the x position
y - the y position
meta - any metadata (String, Double, etc ) to be recorded along with the data point.

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## addDataPoint

addDataPoint( Datum x, Datum y, java.util.Map planes ) → void

add the data point, along with metadata such as the key press.

### Parameters

x - the x position
y - the y position
planes - null or additional planes. Note LinkedHashMap will keep the order of the tabs.

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## addDataPoint

addDataPoint( QDataSet rec ) → void

add the record to the collection of records. This should be a rank 1 bundle or 1-record rank 2 bundle.

>     dpr=DataPointRecorder()
>     dpr.addDataPoint( createEvent( '2014-04-23/P1D', 0xFF0000, 'alert' ) )

### Parameters

rec - rank 1 qdataset, or 1-record rank 2 dataset (ds[1,n])

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## addDataPointSelectionListener

addDataPointSelectionListener( org.das2.event.DataPointSelectionListener listener ) → void

Registers DataPointSelectionListener to receive events.

### Parameters

listener - The listener to register.

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## addDataSetUpdateListener

addDataSetUpdateListener( org.das2.dataset.DataSetUpdateListener listener ) → void

### Parameters

listener - a DataSetUpdateListener

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## addSelectedDataSetUpdateListener

addSelectedDataSetUpdateListener( org.das2.dataset.DataSetUpdateListener listener ) → void

### Parameters

listener - a DataSetUpdateListener

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## appendDataSet

appendDataSet( org.das2.dataset.VectorDataSet ds ) → void

### Parameters

ds - a VectorDataSet

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## createFramed

createFramed( ) → org.das2.components.DataPointRecorderNew

### Returns:

org.das2.components.DataPointRecorderNew
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## deleteInterval

deleteInterval( DatumRange range ) → void

delete all the points within the interval. This was introduced to support the case where we are going to reprocess an interval, as with the RBSP digitizer.

### Parameters

range - range to delete, end time is exclusive.

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## deleteRow

deleteRow( int row ) → void

delete the specified row.

### Parameters

row - the row, where zero is the first element.

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## deleteRows

deleteRows( int[] selectedRows ) → void

delete the specified rows.

### Parameters

selectedRows - the rows, where zero is the first element..

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## getAppendDataSetUpListener

getAppendDataSetUpListener( ) → org.das2.dataset.DataSetUpdateListener

this adds all the points in the DataSet to the list. This will also check the dataset for the special property "comment" and add it as a comment.

### Returns:

the listener to receive data set updates

### See Also:

org.das2.dataset.DataSetUpdateEvent
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## getCurrentFile

getCurrentFile( ) → java.io.File

shows the current name for the file.

### Returns:

the current name for the file.
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## getDataSet

getDataSet( ) → QDataSet

returns a data set of the table data.

### Returns:

a data set of the table data.
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## getSelectedDataSet

getSelectedDataSet( ) → QDataSet

returns a data set of the selected table data. Warning: this used to return a bundle dataset with Y,plane1,plane2,etc that had DEPEND_0 for X. This now returns a bundle ds[n,m] where m is the number of columns and n is the number of records.

### Returns:

a data set of the selected table data.

### See Also:

select(org.das2.datum.DatumRange, org.das2.datum.DatumRange) which selects part of the dataset.
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## getXTagWidth

getXTagWidth( ) → Datum

Getter for property xTagWidth. When xTagWidth is zero, this implies there is no binning.

### Returns:

Value of property xTagWidth.
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## isModified

isModified( ) → boolean

return true when the data point recorder has been modified.

### Returns:

true when the data point recorder has been modified.
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## isSnapToGrid

isSnapToGrid( ) → boolean

Getter for property snapToGrid.

### Returns:

Value of property snapToGrid.
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## isSorted

isSorted( ) → boolean

Getter for property sorted.

### Returns:

Value of property sorted.
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## loadFromFile

loadFromFile( java.io.File file ) → void

load the dataset from the file. TODO: this should be redone.

### Parameters

file - a File

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## removeDataPointSelectionListener

removeDataPointSelectionListener( org.das2.event.DataPointSelectionListener listener ) → void

Removes DataPointSelectionListener from the list of listeners.

### Parameters

listener - The listener to remove.

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## removeDataSetUpdateListener

removeDataSetUpdateListener( org.das2.dataset.DataSetUpdateListener listener ) → void

### Parameters

listener - a DataSetUpdateListener

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## removeSelectedDataSetUpdateListener

removeSelectedDataSetUpdateListener( org.das2.dataset.DataSetUpdateListener listener ) → void

### Parameters

listener - a DataSetUpdateListener

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## save

save( ) → boolean

### Returns:

boolean
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## saveAs

saveAs( ) → boolean

return true if the file was saved, false if cancel

### Returns:

true if the file was saved, false if cancel
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## saveBeforeExit

saveBeforeExit( ) → boolean

return true if the file was saved or "don't save" was pressed by the user.

### Returns:

true if the file was saved or "don't save" was pressed by the user.
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## saveToFile

saveToFile( java.io.File file ) → void

This should be called off the event thread.

### Parameters

file - a File

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## select

select( DatumRange xrange, DatumRange yrange ) → void

Selects all the points where the first column is within xrange and the second column is within yrange.

### Parameters

xrange - the range constraint (non-null).
yrange - the range constraint (non-null). return the selected index, or -1 if no elements are found.

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## setActive

setActive( boolean active ) → void

active=true means fire off events on any change. false= wait for update button.

### Parameters

active - a boolean

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## setColumn

setColumn( int i, String name, Units units, Datum deft ) → void

identify the name and unit for each column.

### Parameters

i - the column number
name - a Java identifier for the column, e.g. "StartTime"
units - units for the column, or null for dimensionless.
deft - default value to use when data is not provided.

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## setColumn

setColumn( int i, String name, Units units, String deft ) → void

identify the name and unit for each column.

### Parameters

i - the column number
name - a Java identifier for the column, e.g. "StartTime"
units - units units for the column, or null for dimensionless.
deft - default value to use when data is not provided, which must be parseable by units.

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## setColumn

setColumn( int i, String name, Units units, double deft ) → void

identify the name and unit for each column.

### Parameters

i - the column number
name - a Java identifier for the column, e.g. "StartTime"
units - units units for the column, or null for dimensionless.
deft - default value to use when data is not provided.

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## setColumnCount

setColumnCount( int count ) → void

explicitly declare the number of columns. Call this and then setColumn to define each column.

### Parameters

count - the number of columns.

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## setSnapToGrid

setSnapToGrid( boolean snapToGrid ) → void

Setter for property snapToGrid. true indicates the xtag will be reset so that the tags are equally spaced, each xTagWidth apart.

### Parameters

snapToGrid - New value of property snapToGrid.

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## setSorted

setSorted( boolean sorted ) → void

Setter for property sorted.

### Parameters

sorted - New value of property sorted.

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## setXTagWidth

setXTagWidth( Datum xTagWidth ) → void

bins for the data, when xTagWidth is non-zero.

### Parameters

xTagWidth - New value of property xTagWidth.

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## update

update( ) → void

Notify listeners that the dataset has updated. Pressing the "Update" button calls this.

### Returns:

void (returns nothing)
[search for examples] [view on GitHub] [view on old javadoc] [view source]