ucar.nc2.write

Class NetcdfFormatWriter.Builder

java.lang.Object

ucar.nc2.write.NetcdfFormatWriter.Builder

Enclosing class:

NetcdfFormatWriter

public static class NetcdfFormatWriter.Builder
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
NetcdfFormatWriter.Builder	addAttribute(Attribute att) Add a global attribute
Dimension	addDimension(Dimension dim) Add a dimension to the root group.
Dimension	addDimension(java.lang.String dimName, int length) Add a dimension to the root group.
Structure.Builder	addStructure(java.lang.String shortName, java.lang.String dimString) Add a Structure to the root group.
Dimension	addUnlimitedDimension(java.lang.String dimName) Add an unlimited dimension to the root group.
Variable.Builder	addVariable(java.lang.String shortName, DataType dataType, java.util.List<Dimension> dims) Add a Variable to the root group.
Variable.Builder	addVariable(java.lang.String shortName, DataType dataType, java.lang.String dimString) Add a Variable to the root group.
NetcdfFormatWriter	build() Once this is called, do not use the Builder again.
long	calcSize()
NetcdfFileFormat	getFormat()
IOServiceProvider	getIosp()
Group.Builder	getRootGroup() Get the root group
NetcdfFormatWriter.Builder	setChunker(Nc4Chunking chunker) Nc4Chunking, used only for netcdf4
NetcdfFormatWriter.Builder	setExtraHeader(int extraHeaderBytes) Set extra bytes to reserve in the header.
NetcdfFormatWriter.Builder	setFill(boolean fill) Set the fill flag.
NetcdfFormatWriter.Builder	setFormat(NetcdfFileFormat format) Set the format version.
NetcdfFormatWriter.Builder	setIosp(IOServiceProvider iosp)
NetcdfFormatWriter.Builder	setLocation(java.lang.String location) The file locatipn
NetcdfFormatWriter.Builder	setNewFile(boolean newFile) True if its a new file, false if its an existing file.
NetcdfFormatWriter.Builder	setPreallocateSize(long preallocateSize) Preallocate the file size, for efficiency.
NetcdfFormatWriter.Builder	setRootGroup(Group.Builder rootGroup) Set the root group.
NetcdfFormatWriter.Builder	setUseJna(boolean useJna) Set if you want to use JNA / netcdf c library to do the writing.

Methods inherited from class java.lang.Object

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

Constructor Detail

Builder

public Builder()

Method Detail

addAttribute

public NetcdfFormatWriter.Builder addAttribute(Attribute att)

Add a global attribute

addDimension

public Dimension addDimension(Dimension dim)

Add a dimension to the root group.

addDimension

public Dimension addDimension(java.lang.String dimName,
                              int length)

Add a dimension to the root group.

addStructure

public Structure.Builder addStructure(java.lang.String shortName,
                                      java.lang.String dimString)

Add a Structure to the root group.

addUnlimitedDimension

public Dimension addUnlimitedDimension(java.lang.String dimName)

Add an unlimited dimension to the root group.

addVariable

public Variable.Builder addVariable(java.lang.String shortName,
                                    DataType dataType,
                                    java.util.List<Dimension> dims)

Add a Variable to the root group.

addVariable

public Variable.Builder addVariable(java.lang.String shortName,
                                    DataType dataType,
                                    java.lang.String dimString)

Add a Variable to the root group.

build

public NetcdfFormatWriter build()
                         throws java.io.IOException

Once this is called, do not use the Builder again.

Throws:

java.io.IOException

calcSize

public long calcSize()

getFormat

public NetcdfFileFormat getFormat()

getIosp

public IOServiceProvider getIosp()

getRootGroup

public Group.Builder getRootGroup()

Get the root group

setChunker

public NetcdfFormatWriter.Builder setChunker(Nc4Chunking chunker)

Nc4Chunking, used only for netcdf4

setExtraHeader

public NetcdfFormatWriter.Builder setExtraHeader(int extraHeaderBytes)

Set extra bytes to reserve in the header. Only used by netcdf-3. This can prevent rewriting the entire file on redefine.

Parameters:

extraHeaderBytes - # bytes extra for the header

setFill

public NetcdfFormatWriter.Builder setFill(boolean fill)

Set the fill flag. Only used by netcdf-3. If true, the data is first written with fill values. Default is fill = true, to follow the C library. Set false if you expect to write all data values, which makes writing faster. Set true if you want to be sure that unwritten data values are set to the fill value.

setFormat

public NetcdfFormatWriter.Builder setFormat(NetcdfFileFormat format)

Set the format version. Only needed when its a new file. Default is NetcdfFileFormat.NETCDF3

setIosp

public NetcdfFormatWriter.Builder setIosp(IOServiceProvider iosp)

setLocation

public NetcdfFormatWriter.Builder setLocation(java.lang.String location)

The file locatipn

setNewFile

public NetcdfFormatWriter.Builder setNewFile(boolean newFile)

True if its a new file, false if its an existing file. Default true.

setPreallocateSize

public NetcdfFormatWriter.Builder setPreallocateSize(long preallocateSize)

Preallocate the file size, for efficiency. Only used by netcdf-3.

setRootGroup

public NetcdfFormatWriter.Builder setRootGroup(Group.Builder rootGroup)

Set the root group. This allows all metadata to be built externally.

setUseJna

public NetcdfFormatWriter.Builder setUseJna(boolean useJna)

Set if you want to use JNA / netcdf c library to do the writing. Default is false.