org.das2.qds.ops

Class OpsParl

java.lang.Object

org.das2.qds.ops.OpsParl

public class OpsParl
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	OpsParl.BinaryOp BinaryOps are operations such as add, pow, atan2

Method Summary

Modifier and Type	Method and Description
static MutablePropertyDataSet	applyBinaryOp(QDataSet ds1, QDataSet ds2, OpsParl.BinaryOp op) apply the binary operator element-for-element of the two datasets, minding dataset geometry, fill values, etc.
static MutablePropertyDataSet	applyBinaryOpNoIter(QDataSet ds1, QDataSet ds2, OpsParl.BinaryOp op) apply the binary operator element-for-element of the two datasets, minding dataset geometry, fill values, etc.
static MutablePropertyDataSet	applyBinaryOpParl(QDataSet ds1, QDataSet ds2, OpsParl.BinaryOp op) apply the binary operator element-for-element of the two datasets, minding dataset geometry, fill values, etc.
static QDataSet	eq_noiter(QDataSet ds1, QDataSet ds2) element-wise equality test.
static QDataSet	eq_parl(QDataSet ds1, QDataSet ds2) element-wise equality test.
static QDataSet	eq(QDataSet ds1, QDataSet ds2) element-wise equality test.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

applyBinaryOp

public static MutablePropertyDataSet applyBinaryOp(QDataSet ds1,
                                                   QDataSet ds2,
                                                   OpsParl.BinaryOp op)

apply the binary operator element-for-element of the two datasets, minding dataset geometry, fill values, etc. The two datasets are coerced to compatible geometry, if possible (e.g.Temperature[Time]+2deg), using CoerceUtil.coerce. Structural metadata such as DEPEND_0 are preserved where this is reasonable, and dimensional metadata such as UNITS are dropped.

Parameters:

ds1 - the first argument

ds2 - the second argument

op - binary operation for each pair of elements

Returns:

the result with the same geometry as the pair.

eq

public static QDataSet eq(QDataSet ds1,
                          QDataSet ds2)

element-wise equality test. 1.0 is returned where the two datasets are equal. Fill is returned where either measurement is invalid.

Parameters:

ds1 - rank n dataset

ds2 - rank m dataset with compatible geometry.

Returns:

rank n or m dataset.

applyBinaryOpNoIter

public static MutablePropertyDataSet applyBinaryOpNoIter(QDataSet ds1,
                                                         QDataSet ds2,
                                                         OpsParl.BinaryOp op)

apply the binary operator element-for-element of the two datasets, minding dataset geometry, fill values, etc. The two datasets are coerced to compatible geometry, if possible (e.g.Temperature[Time]+2deg), using CoerceUtil.coerce. Structural metadata such as DEPEND_0 are preserved where this is reasonable, and dimensional metadata such as UNITS are dropped. This implementation avoids the use of DataSetIterators, which have been shown to be slow. (But it's not known why.)

Parameters:

ds1 - the first argument

ds2 - the second argument

op - binary operation for each pair of elements

Returns:

the result with the same geometry as the pair.

eq_noiter

public static QDataSet eq_noiter(QDataSet ds1,
                                 QDataSet ds2)

element-wise equality test. 1.0 is returned where the two datasets are equal. Fill is returned where either measurement is invalid.

Parameters:

ds1 - rank n dataset

ds2 - rank m dataset with compatible geometry.

Returns:

rank n or m dataset.

applyBinaryOpParl

public static MutablePropertyDataSet applyBinaryOpParl(QDataSet ds1,
                                                       QDataSet ds2,
                                                       OpsParl.BinaryOp op)

apply the binary operator element-for-element of the two datasets, minding dataset geometry, fill values, etc. The two datasets are coerced to compatible geometry, if possible (e.g.Temperature[Time]+2deg), using CoerceUtil.coerce. Structural metadata such as DEPEND_0 are preserved where this is reasonable, and dimensional metadata such as UNITS are dropped. This implementation runs the trivially parallelizable task on separate threads.

Parameters:

ds1 - the first argument

ds2 - the second argument

op - binary operation for each pair of elements

Returns:

the result with the same geometry as the pair.

eq_parl

public static QDataSet eq_parl(QDataSet ds1,
                               QDataSet ds2)

element-wise equality test. 1.0 is returned where the two datasets are equal. Fill is returned where either measurement is invalid.

Parameters:

ds1 - rank n dataset

ds2 - rank m dataset with compatible geometry.

Returns:

rank n or m dataset.