org.autoplot.cdf.CdfUtil
static methods supporting CdfFileDataSource
CdfUtil( )
Creates a new instance of CdfUtil
OPTION_INCLUDE_EMPTY_RECORDS
if "true", show empty records (true is default).
OPTION_IS_MASTER
if "true", then don't show the number of records.
OPTION_DEEP
if "true" then return more detailed descriptions in HTML
OPTION_DATA_ONLY
if "true" return only the data variables, not the support data.
OPTION_RANK_LIMIT
if greater than -1, then only read variables up to this rank.
doApplyAttributes
doApplyAttributes( java.util.Map attr1, org.das2.qds.MutablePropertyDataSet result, String os1, String constraint ) → void
apply the ISTP metadata to the dataset. This is used to implement master files, where metadata from one file
can override the data within another. Do not use this, as its location will probably change.
Parameters
attr1 - the ISTP metadata
result - the data
os1 - if non-null, then modify the metadata for slice1
constraint - if non-null, then drop the render type.
Returns:
void (returns nothing)
[search for examples]
[view on GitHub]
[view on old javadoc]
getDimensions
getDimensions( gov.nasa.gsfc.spdf.cdfj.CDFReader cdf, String variableName ) → int
This is cdf.getDimensions( variableName ), but then check varies
to see if varies[0] is false (for rvariables). This will return "new int[0]" for
scalar quantities like density.
Parameters
cdf - a CDFReader
variableName - a String
Returns:
the dimensions for each record.
[search for examples]
[view on GitHub]
[view on old javadoc]
getPlottable
getPlottable( gov.nasa.gsfc.spdf.cdfj.CDFReader cdf, boolean dataOnly, int rankLimit ) → Map
Return a map where keys are the names of the variables, and values are descriptions.
Parameters
cdf - the cdf reader reference.
dataOnly - show only the DATA and not SUPPORT_DATA. Note I reclaimed this parameter because I wasn't using it.
rankLimit - show only variables with no more than this rank.
Returns:
map of parameter name to short description
[search for examples]
[view on GitHub]
[view on old javadoc]
getPlottable( gov.nasa.gsfc.spdf.cdfj.CDFReader cdf, java.util.Map options ) → LinkedHashMap
getPlottable( gov.nasa.gsfc.spdf.cdfj.CDFReader cdf, boolean dataOnly, int rankLimit, java.util.Map options ) → Map
getRange
getRange( java.util.HashMap attrs ) → DatumRange
returns the range of the data by looking for the SCALEMIN/SCALEMAX params,
or the required VALIDMIN/VALIDMAX parameters. This is not used.
Parameters
attrs - the properties for the variable
Returns:
the range
[search for examples]
[view on GitHub]
[view on old javadoc]
getScaleType
getScaleType( java.util.HashMap attrs ) → String
Parameters
attrs - a java.util.HashMap
Returns:
java.lang.String
[search for examples]
[view on GitHub]
[view on old javadoc]
getStringDataType
getStringDataType( int type ) → String
return the data type for the encoding. From
https://cdaweb.gsfc.nasa.gov/pub/software/cdf/doc/cdf380/cdf38ifd.pdf page 41.
Parameters
type - integer type, such as 44 for CDF_FLOAT
Returns:
string like "CDF_FLOAT"
[search for examples]
[view on GitHub]
[view on old javadoc]
hasAttribute
hasAttribute( gov.nasa.gsfc.spdf.cdfj.CDFReader cdf, String var, String attrname ) → boolean
return true if the attribute is set for the variable.
Parameters
cdf - the cdf file reader
var - the variable name
attrname - the attribute name.
Returns:
true if the attribute is set for the variable.
[search for examples]
[view on GitHub]
[view on old javadoc]
jvmMemory
jvmMemory( QDataSet ds ) → int
returns the amount of JVM memory in bytes occupied by the dataset. This is an approximation,
calculated by taking the element type size (e.g. float=4 bytes) times the number of elements for
the dataset. This does not include the memory consumed by DEPEND_0, etc.
Parameters
ds - the ArrayDataSet, or TrArrayDataSet, or BufferDataSet.
Returns:
the approximate memory consumption in bytes
[search for examples]
[view on GitHub]
[view on old javadoc]
loadVariable
loadVariable( gov.nasa.gsfc.spdf.cdfj.CDFReader cdf, String svariable ) → MutablePropertyDataSet
Return the named variable as a QDataSet. This does not look at the
metadata for DEPEND_0, etc, and only adds metadata to represent time units
(e.g. the data is in TT2000) and ordinal data.
Parameters
cdf - the value of CDF
svariable - name of the variable
Returns:
the dataset
[search for examples]
[view on GitHub]
[view on old javadoc]
loadVariable( gov.nasa.gsfc.spdf.cdfj.CDFReader cdf, String svariable, long recStart, long recCount, long recInterval, int slice1, ProgressMonitor mon ) → MutablePropertyDataSet
maybeAddValidRange
maybeAddValidRange( java.util.Map props, org.das2.qds.MutablePropertyDataSet ds ) → void
add the valid range only if it looks like it is correct. It must contain some of the data.
Parameters
props - the properties for the variable
ds - the dataset to which the valid range would be added.
Returns:
void (returns nothing)
[search for examples]
[view on GitHub]
[view on old javadoc]
maybeShorten
maybeShorten( String context, String name ) → String
abbreviate names, motivated by Cluster CDF files which have
Data__C1_CP_PEA_3DRH_cnts with DEPEND_0 of
time_tags__C1_CP_PEA_3DRH_cnts.
Parameters
context - a String
name - a String
Returns:
a String
[search for examples]
[view on GitHub]
[view on old javadoc]
wrapCdfData
Deprecated: use loadCdfVariable instead
wrapCdfData( gov.nasa.gsfc.spdf.cdfj.CDFReader cdf, String svariable, long recStart, long recCount, long recInterval, int slice1, boolean depend, ProgressMonitor mon ) → MutablePropertyDataSet