## org.das2.qstream.QDataSetStreamHandler

reads a stream and produces QDataSets representing the data found on the stream. The stream is read in, and then getDataSet or getDataSet(name) is called to retrieve datasets.

## QDataSetStreamHandler( )

## BUILDER_JOIN_CHILDREN

## flattenJoin

flattenJoin( QDataSet ds ) → org.das2.qds.MutablePropertyDataSet

since an appended series of rank 1 datasets will return as a rank 2 join, this utility provides a standard place to flatten it. This will also flatten DEPENDNAME_0.

### Parameters

ds - rank 2 or 3 join dataset.

### Returns:

rank 1 or 2 dataset.
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## getDataSet

getDataSet( String name ) → QDataSet

return the dataset from the stream.

### Parameters

name - the name of the dataset to retrieve.

### Returns:

the dataset
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## getDataSet

getDataSet( ) → QDataSet

return the default dataset for the stream. The default dataset is identified in the stream packet descriptor dataset_id attribute.

### Returns:

the default dataset
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## getDataSetNames

getDataSetNames( ) → java.util.List

return a list of available datasets

### Returns:

a java.util.List
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## getDataSetNamesAndDescriptions

getDataSetNamesAndDescriptions( ) → java.util.Map

return a list of available datasets and their label (or name if not available).

### Returns:

a java.util.Map
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## getReadPackets

getReadPackets( ) → boolean

if true, then packets are interpreted.

### Returns:

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

## isFlattenableJoin

isFlattenableJoin( QDataSet ds ) → boolean

If the dataset is a join of appendable datasets, then we can append them to reduce the rank by 1 and make one long time series. These datasets should be equivalent, however most of the system doesn't implement this (and probably never will). So this is a bit of a kludge, where I don't want to flatten a dataset automatically, but we probably want to.

### Parameters

ds - a join dataset of rank 2 or rank 3.

### Returns:

true if the data can be joined.
[search for examples] [view on GitHub] [view on old javadoc] [view source]

## packet

packet( org.das2.qstream.PacketDescriptor pd, java.nio.ByteBuffer data ) → void

### Parameters

pd - a PacketDescriptor
data - a ByteBuffer

### Returns:

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

## packetDescriptor

packetDescriptor( org.das2.qstream.PacketDescriptor pd ) → void

### Parameters

pd - a PacketDescriptor

### Returns:

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

## setReadPackets

setReadPackets( boolean val ) → void

set this is false if you just want to look at the empty dataset metadata.

### Parameters

val - a boolean

### Returns:

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

## streamClosed

streamClosed( org.das2.qstream.StreamDescriptor sd ) → void

### Parameters

sd - a StreamDescriptor

### Returns:

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

## streamComment

streamComment( org.das2.qstream.StreamComment se ) → void

### Parameters

se - a StreamComment

### Returns:

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

## streamDescriptor

streamDescriptor( org.das2.qstream.StreamDescriptor sd ) → void

### Parameters

sd - a StreamDescriptor

### Returns:

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

## streamException

streamException( org.das2.qstream.StreamException se ) → void

### Parameters

se - a StreamException

### Returns:

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