NUSDAS_WRITE

Writes a two-dimensional array into NuSDaS dataset.

SYNOPSIS

/* C */
    int
nusdas_write(type1, type2, type3, btime, memb, vtime1, plane1, elem,
  udata, utype, usize)

    int
nusdas_write2(type1, type2, type3, btime, memb, vtime1, vtime2,
  plane1, plane2, elem, udata, utype, usize)

! Fortran
SUBROUTINE NUSDAS_WRITE(type1, type2, type3, btime, memb, vtime1, &
  plane1, elem, udata, utype, usize, iostat)

SUBROUTINE NUSDAS_WRITE2(type1, type2, type3, btime, memb, vtime1, vtime2, &
  plane1, plane2, elem, udata, utype, usize, iostat)


symbol	Fortran	C
type1 ... elem	(see table above)
udata	(may be various type) INTENT(OUT)	void *
utype	(should be constant in header)	(should be macro in header)
iostat	INTEGER, INTENT(OUT)	(not used)

ARGUMENTS

From type1 to elem, see section 'NuSDaS Data Identifier Dimensions'.

udata: user data array, from which the requested data will be copied.
utype: see table of User Data Array Type.
usize: number of array elements allocated user data. It must equal to than that of dataset.
iostat: see following section, RETURN VALUE.

RETURN VALUE


> 0	Succeeded. The value is number of array elements written.
-2	Warning: requested data is not registered yet.
-3	Error: size of user data array is too small.
-4	Error: conversion to specified data type is not supported.
-5	Error: data record size exceeds fixed record size.
-6	Error: invalid missing value style.
-7	Error: mask bit pattern undefined.
-8	Error: overflow in packing.
-9	Error: invalid compression scheme.
-10 to -99	(see error code table)

see also Error Code of NuSDaS library for return code from -10 to -99.

DESCRIPTION

NUSDAS_WRITE and NUSDAS_WRITE2 writes a data record from user data array udata. If you are going to write data in a layer or timespan, use NUSDAS_WRITE2.