ucar.nc2

Class ParsedSectionSpec

java.lang.Object

ucar.nc2.ParsedSectionSpec

Deprecated.

use ParsedArraySectionSpec

@Deprecated
public class ParsedSectionSpec
extends Object

A String expression for denoting a section of a Variable to be read. Parse a section specification String. These have the form:

  section specification := selector | selector '.' selector
  selector := varName ['(' dims ')']
  varName := ESCAPED_STRING
 

   dims := dim | dim, dims
   dim := ':' | slice | start ':' end | start ':' end ':' stride
   slice := INTEGER
   start := INTEGER
   stride := INTEGER
   end := INTEGER
   ESCAPED_STRING : must escape characters = ".("
 

Nonterminals are in lower case, terminals are in upper case, literals are in single quotes. Optional components are enclosed between square braces '[' and ']'.

Constructor Summary

Constructors

Constructor and Description
ParsedSectionSpec(Variable variable, Section section) Deprecated.

Method Summary

Modifier and Type	Method and Description
Section	getArraySection() Deprecated.
ParsedSectionSpec	getChild() Deprecated.
Section	getSection() Deprecated. use getArraySection()
Variable	getVariable() Deprecated.
static ParsedSectionSpec	makeFromVariable(Variable v, String selector) Deprecated.
String	makeSectionSpecString() Deprecated.
static String	makeSectionSpecString(Variable v, List<Range> ranges) Deprecated. Make section specification String from a range list for a Variable.
static ParsedSectionSpec	parseVariableSection(NetcdfFile ncfile, String variableSection) Deprecated. Parse a section specification String.
String	toString() Deprecated.

Methods inherited from class java.lang.Object

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

Constructor Detail

ParsedSectionSpec

public ParsedSectionSpec(Variable variable,
                         Section section)

Deprecated.

Method Detail

parseVariableSection

public static ParsedSectionSpec parseVariableSection(NetcdfFile ncfile,
                                                     String variableSection)
                                              throws InvalidRangeException

Deprecated.

Parse a section specification String.

Parameters:

ncfile - look for variable in here

variableSection - the string to parse, eg "record(12).wind(1:20,:,3)"

Returns:

return ParsedSectionSpec, parsed representation of the variableSection String

Throws:

IllegalArgumentException - when token is misformed, or variable name doesnt exist in ncfile

InvalidRangeException - if section does not match variable shape

makeFromVariable

public static ParsedSectionSpec makeFromVariable(Variable v,
                                                 String selector)
                                          throws InvalidRangeException

Deprecated.

Throws:

InvalidRangeException

makeSectionSpecString

public static String makeSectionSpecString(Variable v,
                                           List<Range> ranges)

Deprecated.

Make section specification String from a range list for a Variable.

Parameters:

v - for this Variable.

ranges - list of Range. Must includes all parent structures. The list be null, meaning use all. Individual ranges may be null, meaning all for that dimension.

Returns:

section specification String.

getVariable

public Variable getVariable()

Deprecated.

getSection

@Deprecated
public Section getSection()

Deprecated. use getArraySection()

getArraySection

public Section getArraySection()

Deprecated.

getChild

public ParsedSectionSpec getChild()

Deprecated.

toString

public String toString()

Deprecated.

Overrides:

toString in class Object

makeSectionSpecString

public String makeSectionSpecString()

Deprecated.