ucar.nc2.write

Class Ncdump

java.lang.Object

ucar.nc2.write.Ncdump

@Immutable
public class Ncdump
extends java.lang.Object

Utility to implement ncdump. A difference with ncdump is that the nesting of multidimensional array data is represented by nested brackets, so the output is not legal CDL that can be used as input for ncgen. Also, the default is header only (-h). Moved from ucar.nc2.NCdumpW

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Ncdump.Builder
static class	Ncdump.WantValues Tell Ncdump if you want values printed.

Method Summary

Modifier and Type	Method and Description
static Ncdump.Builder	builder(NetcdfFile ncfile)
static void	main(java.lang.String[] args) Main program.
static void	ncdump(NetcdfFile nc, java.lang.String command, java.io.Writer out, CancelTask ct) ncdump, parsing command string, file already open.
static void	ncdump(java.lang.String command, java.io.Writer out, CancelTask ct) ncdump that parses a command string.
java.lang.String	print()
static java.lang.String	printArray(Array ma) Print array to returned String.
static java.lang.String	printArray(Array array, java.lang.String name, CancelTask ct) Print named array to returned String.
static java.lang.String	printArrayPlain(Array ma) Print array as undifferentiated sequence of values.
static java.lang.String	printStructureData(StructureData sdata) Print StructureData to returned String.
static java.lang.String	printVariableData(Variable v, CancelTask ct) Print all the data of the given Variable.

Methods inherited from class java.lang.Object

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

Method Detail

builder

public static Ncdump.Builder builder(NetcdfFile ncfile)

main

public static void main(java.lang.String[] args)

Main program.

ucar.nc2.NCdumpW filename [-cdl | -ncml] [-c | -vall] [-v varName1;varName2;..] [-v varName(0:1,:,12)]

where:

• filename : path of any CDM readable file
• cdl or ncml: output format is CDL or NcML
• -vall : dump all variable data
• -c : dump coordinate variable data
• -v varName1;varName2; : dump specified variable(s)
• -v varName(0:1,:,12) : dump specified variable section

Default is to dump the header info only.

Parameters:

args - arguments

ncdump

public static void ncdump(NetcdfFile nc,
                          java.lang.String command,
                          java.io.Writer out,
                          CancelTask ct)
                   throws java.io.IOException

ncdump, parsing command string, file already open.

Parameters:

nc - apply command to this file

command - : command string

out - send output here

ct - allow task to be cancelled; may be null.

Throws:

java.io.IOException

ncdump

public static void ncdump(java.lang.String command,
                          java.io.Writer out,
                          CancelTask ct)
                   throws java.io.IOException

ncdump that parses a command string.

Parameters:

command - command string

out - send output here

ct - allow task to be cancelled; may be null.

Throws:

java.io.IOException - on write error

print

public java.lang.String print()

printArray

public static java.lang.String printArray(Array ma)

Print array to returned String.

printArray

public static java.lang.String printArray(Array array,
                                          java.lang.String name,
                                          CancelTask ct)

Print named array to returned String.

printArrayPlain

public static java.lang.String printArrayPlain(Array ma)

Print array as undifferentiated sequence of values.

Parameters:

ma - any Array except ArrayStructure

printStructureData

public static java.lang.String printStructureData(StructureData sdata)

Print StructureData to returned String.

printVariableData

public static java.lang.String printVariableData(Variable v,
                                                 CancelTask ct)
                                          throws java.io.IOException

Print all the data of the given Variable.

Parameters:

v - variable to print

ct - allow task to be cancelled; may be null.

Returns:

String result

Throws:

java.io.IOException - on write error