ucar.nc2.jni.netcdf

Class Nc4Iosp

java.lang.Object

ucar.nc2.iosp.AbstractIOServiceProvider

ucar.nc2.jni.netcdf.Nc4Iosp

All Implemented Interfaces:

java.lang.Comparable<IOServiceProvider>, IOServiceProvider, IOServiceProviderWriter

Deprecated.

do not use, will be removed in ver 6.

@Deprecated
public class Nc4Iosp
extends AbstractIOServiceProvider
implements IOServiceProviderWriter

IOSP for reading netcdf files through JNA interface to netcdf C library

See Also:

, ,

Nested Class Summary

Nested classes/interfaces inherited from interface ucar.nc2.iosp.IOServiceProvider

IOServiceProvider.SortGroup

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEBUG Deprecated.
static int	NC_TURN_OFF_LOGGING Deprecated.
static java.lang.String	TRANSLATE_NC4 Deprecated.
static java.lang.String	TRANSLATE_NONE Deprecated.
static java.lang.String	TRANSLATECONTROL Deprecated.

Fields inherited from class ucar.nc2.iosp.AbstractIOServiceProvider

location, ncfile, raf, rafOrder

Constructor Summary

Constructors

Constructor and Description
Nc4Iosp() Deprecated.
Nc4Iosp(NetcdfFileWriter.Version version) Deprecated.

Method Summary

Modifier and Type	Method and Description
int	appendStructureData(Structure s, StructureData sdata) Deprecated. Append a structureData along the unlimited dimension
void	close() Deprecated. Close the file.
void	create(java.lang.String filename, NetcdfFile ncfile, int extra, long preallocateSize, boolean largeFile) Deprecated. Create new file, populate it from the objects in ncfile.
static void	dumpbytes(byte[] bytes, int start, int len, java.lang.String tag) Deprecated.
void	flush() Deprecated. Flush all data buffers to disk.
static Nc4prototypes	getCLibrary() Deprecated. use NetcdfClibrary.getNativeInterface
java.lang.String	getFileTypeDescription() Deprecated. Get a human-readable description for this file type.
java.lang.String	getFileTypeId() Deprecated. Get a unique id for this file type.
java.lang.String	getFileTypeVersion() Deprecated. Get the version of this file type.
static long	getNativeAddr(int pos, java.nio.ByteBuffer buf) Deprecated.
static boolean	isClibraryPresent() Deprecated. use NetcdfClibrary.isLibraryPresent
boolean	isValidFile(RandomAccessFile raf) Deprecated. Checks whether raf is a valid file NetCDF-4 file.
void	open(RandomAccessFile raf, NetcdfFile ncfile, CancelTask cancelTask) Deprecated. Open existing file, and populate ncfile with it.
void	openForWriting(RandomAccessFile raf, NetcdfFile ncfile, CancelTask cancelTask) Deprecated. Open existing file and allow writing.
Array	readData(Variable v2, Section section) Deprecated. Read data from a top level Variable and return a memory resident Array.
boolean	rewriteHeader(boolean largeFile) Deprecated. if theres room before data, rewrite header without moving the data.
java.lang.Object	sendIospMessage(java.lang.Object message) Deprecated. A way to communicate arbitrary information to and from an iosp.
Nc4Iosp	setAddReserved(boolean tf) Deprecated.
void	setChunker(Nc4Chunking chunker) Deprecated.
static void	setDebugFlags(DebugFlags flags) Deprecated.
void	setFill(boolean fill) Deprecated. Set the fill flag.
static void	setLibraryAndPath(java.lang.String jnaPath, java.lang.String libName) Deprecated. use NetcdfClibrary.setLibraryNameAndPath
static int	setLogLevel(int level) Deprecated. use NetcdfClibrary.setLogLevel
static java.lang.String	show(SizeT[] inta) Deprecated.
void	updateAttribute(Variable v2, Attribute att) Deprecated. Update the value of an existing attribute.
static void	useHdfEos(boolean val) Deprecated.
void	writeData(Variable v2, Section section, Array values) Deprecated. Write data into a variable.

Methods inherited from class ucar.nc2.iosp.AbstractIOServiceProvider

build, buildFinish, getDetailInfo, getLastModified, getStructureIterator, isBuilder, reacquire, readSection, readToByteChannel, readToOutputStream, release, setNetcdfFile, streamToByteChannel, syncExtend, toStringDebug

Methods inherited from class java.lang.Object

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

Methods inherited from interface ucar.nc2.iosp.IOServiceProvider

build, buildFinish, compareTo, getDetailInfo, getSortGroup, getStructureIterator, isBuilder, reacquire, readSection, readToByteChannel, readToOutputStream, release, streamToByteChannel, syncExtend, toStringDebug

Field Detail

DEBUG

public static final boolean DEBUG

Deprecated.

See Also:

Constant Field Values

NC_TURN_OFF_LOGGING

public static int NC_TURN_OFF_LOGGING

Deprecated.

TRANSLATECONTROL

public static final java.lang.String TRANSLATECONTROL

Deprecated.

See Also:

Constant Field Values

TRANSLATE_NONE

public static final java.lang.String TRANSLATE_NONE

Deprecated.

See Also:

Constant Field Values

TRANSLATE_NC4

public static final java.lang.String TRANSLATE_NC4

Deprecated.

See Also:

Constant Field Values

Constructor Detail

Nc4Iosp

public Nc4Iosp()

Deprecated.

Nc4Iosp

public Nc4Iosp(NetcdfFileWriter.Version version)

Deprecated.

Method Detail

setLibraryAndPath

@Deprecated
public static void setLibraryAndPath(java.lang.String jnaPath,
                                                 java.lang.String libName)

Deprecated. use NetcdfClibrary.setLibraryNameAndPath

Set the path and name of the netcdf c library.

This method will only work if the netCDF-C library was not found on the system path. If you need to use a specific version of the C library, and you have a different version on a system path, do not use this method. Instead, call NetcdfClibrary.setLibraryNameAndPath prior to any uses of the Nc4Iosp class.

Parameters:

jnaPath - path to shared libraries

libName - library name

isClibraryPresent

@Deprecated
public static boolean isClibraryPresent()

Deprecated. use NetcdfClibrary.isLibraryPresent

Test if the netcdf C library is present and loaded.

Returns:

true if present

getCLibrary

@Deprecated
public static Nc4prototypes getCLibrary()

Deprecated. use NetcdfClibrary.getNativeInterface

setLogLevel

@Deprecated
public static int setLogLevel(int level)

Deprecated. use NetcdfClibrary.setLogLevel

Set the log level for loaded library. Do nothing if set_log_level is not available.

useHdfEos

public static void useHdfEos(boolean val)

Deprecated.

setDebugFlags

public static void setDebugFlags(DebugFlags flags)

Deprecated.

setChunker

public void setChunker(Nc4Chunking chunker)

Deprecated.

isValidFile

public boolean isValidFile(RandomAccessFile raf)
                    throws java.io.IOException

Deprecated.

Checks whether raf is a valid file NetCDF-4 file. Actually, it checks whether it is a valid HDF-5 file of any type. Furthermore, it checks whether the NetCDF C library is available on the system. If both conditions are satisfied, this method returns true; otherwise it returns false.

Specified by:

isValidFile in interface IOServiceProvider

Parameters:

raf - a file on disk.

Returns:

true if raf is a valid HDF-5 file and the NetCDF C library is available.

Throws:

java.io.IOException - if an I/O error occurs.

getFileTypeDescription

public java.lang.String getFileTypeDescription()

Deprecated.

Description copied from interface: IOServiceProvider

Get a human-readable description for this file type.

Specified by:

getFileTypeDescription in interface IOServiceProvider

Returns:

description of the file type

See Also:

"https://www.unidata.ucar.edu/software/netcdf-java/formats/FileTypes.html"

getFileTypeId

public java.lang.String getFileTypeId()

Deprecated.

Description copied from interface: IOServiceProvider

Get a unique id for this file type.

Specified by:

getFileTypeId in interface IOServiceProvider

Returns:

registered id of the file type

See Also:

"https://www.unidata.ucar.edu/software/netcdf-java/formats/FileTypes.html"

getFileTypeVersion

public java.lang.String getFileTypeVersion()

Deprecated.

Description copied from interface: IOServiceProvider

Get the version of this file type.

Specified by:

getFileTypeVersion in interface IOServiceProvider

Overrides:

getFileTypeVersion in class AbstractIOServiceProvider

Returns:

version of the file type

See Also:

"https://www.unidata.ucar.edu/software/netcdf-java/formats/FileTypes.html"

close

public void close()
           throws java.io.IOException

Deprecated.

Description copied from interface: IOServiceProvider

Close the file. It is the IOServiceProvider's job to close the file (even though it didnt open it), and to free any other resources it has used.

Specified by:

close in interface IOServiceProvider

Overrides:

close in class AbstractIOServiceProvider

Throws:

java.io.IOException - if read error

open

public void open(RandomAccessFile raf,
                 NetcdfFile ncfile,
                 CancelTask cancelTask)
          throws java.io.IOException

Deprecated.

Description copied from interface: IOServiceProvider

Open existing file, and populate ncfile with it. This method is only called by the NetcdfFile constructor on itself. The provided NetcdfFile object will be empty except for the location String and the IOServiceProvider associated with this NetcdfFile object.

Specified by:

open in interface IOServiceProvider

Overrides:

open in class AbstractIOServiceProvider

Parameters:

raf - the file to work on, it has already passed the isValidFile() test.

ncfile - add objects to this empty NetcdfFile

cancelTask - used to monitor user cancellation; may be null.

Throws:

java.io.IOException - if read error

openForWriting

public void openForWriting(RandomAccessFile raf,
                           NetcdfFile ncfile,
                           CancelTask cancelTask)
                    throws java.io.IOException

Deprecated.

Description copied from interface: IOServiceProviderWriter

Open existing file and allow writing. Netcdf-4 writing is general. Netcdf-3 writing is restricted to writing data into existing variables.

Specified by:

openForWriting in interface IOServiceProviderWriter

Parameters:

raf - the file to work on.

ncfile - add objects to this empty NetcdfFile

cancelTask - used to monitor user cancellation; may be null.

Throws:

java.io.IOException - if I/O error

dumpbytes

public static void dumpbytes(byte[] bytes,
                             int start,
                             int len,
                             java.lang.String tag)

Deprecated.

readData

public Array readData(Variable v2,
                      Section section)
               throws java.io.IOException,
                      InvalidRangeException

Deprecated.

Description copied from interface: IOServiceProvider

Read data from a top level Variable and return a memory resident Array. This Array has the same element type as the Variable, and the requested shape.

Specified by:

readData in interface IOServiceProvider

Parameters:

v2 - a top-level Variable

section - the section of data to read. There must be a Range for each Dimension in the variable, in order. Note: no nulls allowed. IOSP may not modify.

Returns:

the requested data in a memory-resident Array

Throws:

java.io.IOException - if read error

InvalidRangeException - if invalid section

See Also:

Range

show

public static java.lang.String show(SizeT[] inta)

Deprecated.

create

public void create(java.lang.String filename,
                   NetcdfFile ncfile,
                   int extra,
                   long preallocateSize,
                   boolean largeFile)
            throws java.io.IOException

Deprecated.

Description copied from interface: IOServiceProviderWriter

Create new file, populate it from the objects in ncfile.

Specified by:

create in interface IOServiceProviderWriter

Parameters:

filename - name of file to create.

ncfile - get everything but data from here

extra - if > 0, pad header with extra bytes

preallocateSize - if > 0, set length of file to this upon creation - this (usually) pre-allocates contiguous storage.

largeFile - if want large file format

Throws:

java.io.IOException - if I/O error

writeData

public void writeData(Variable v2,
                      Section section,
                      Array values)
               throws java.io.IOException,
                      InvalidRangeException

Deprecated.

Description copied from interface: IOServiceProviderWriter

Write data into a variable.

Specified by:

writeData in interface IOServiceProviderWriter

Parameters:

v2 - variable to write; must already exist.

section - the section of data to write. There must be a Range for each Dimension in the variable, in order. The shape must match the shape of values. The origin and stride indicate where the data is placed into the stored Variable array.

values - data to write. The shape must match section.getShape().

Throws:

java.io.IOException - if I/O error

InvalidRangeException - if invalid section

appendStructureData

public int appendStructureData(Structure s,
                               StructureData sdata)
                        throws java.io.IOException,
                               InvalidRangeException

Deprecated.

Description copied from interface: IOServiceProviderWriter

Append a structureData along the unlimited dimension

Specified by:

appendStructureData in interface IOServiceProviderWriter

Parameters:

s - belongs to this structure

sdata - the stuctureData to append

Returns:

the recnum where it was written

Throws:

java.io.IOException

InvalidRangeException

flush

public void flush()
           throws java.io.IOException

Deprecated.

Description copied from interface: IOServiceProviderWriter

Flush all data buffers to disk.

Specified by:

flush in interface IOServiceProviderWriter

Throws:

java.io.IOException

setAddReserved

public Nc4Iosp setAddReserved(boolean tf)

Deprecated.

setFill

public void setFill(boolean fill)

Deprecated.

Description copied from interface: IOServiceProviderWriter

Set the fill flag. For new files, set in the create() method. This method is to set fill for existing files that you want to write. If true, the data is first written with fill values. Set to false if you expect to write all data values, set to true if you want to be sure that unwritten data values have the fill value in it.

Specified by:

setFill in interface IOServiceProviderWriter

Parameters:

fill - set fill mode true or false

rewriteHeader

public boolean rewriteHeader(boolean largeFile)
                      throws java.io.IOException

Deprecated.

Description copied from interface: IOServiceProviderWriter

if theres room before data, rewrite header without moving the data. netcdf3 only

Specified by:

rewriteHeader in interface IOServiceProviderWriter

Returns:

true if it worked

Throws:

java.io.IOException

updateAttribute

public void updateAttribute(Variable v2,
                            Attribute att)
                     throws java.io.IOException

Deprecated.

Description copied from interface: IOServiceProviderWriter

Update the value of an existing attribute. Attribute is found by name, which must match exactly. You cannot make an attribute longer, or change the number of values. For strings: truncate if longer, zero fill if shorter. Strings are padded to 4 byte boundaries, ok to use padding if it exists. For numerics: must have same number of values.

Specified by:

updateAttribute in interface IOServiceProviderWriter

Parameters:

v2 - variable, or null for global attribute

att - replace with this value

Throws:

java.io.IOException

getNativeAddr

public static long getNativeAddr(int pos,
                                 java.nio.ByteBuffer buf)

Deprecated.

sendIospMessage

public java.lang.Object sendIospMessage(java.lang.Object message)

Deprecated.

Description copied from interface: IOServiceProvider

A way to communicate arbitrary information to and from an iosp.

Specified by:

sendIospMessage in interface IOServiceProvider

Overrides:

sendIospMessage in class AbstractIOServiceProvider

Parameters:

message - opaque message sent to the IOSP object when its opened (not when isValidFile() is called)

Returns:

opaque Object, may be null.