 |
vlmopen_ugrid
NAME
vlmopen_ugrid - Opens a ParVox unstructured grid definition
file.
SYNOPSIS
#include <vlmeta.h>
int vlmopen_ugrid(char *name, int dtype, int mode);
DESCRIPTION
Vlmopen_ugrid opens a ParVox unstructured grid definition
file and
returns a handle that can be used by
vlmget_ugrid,
vlmget_ugdim, vlmget_ugcells,
and
vlmget_ugvert. The name
parameter can be either the basename of the voxel data file, or the
complete name, including the .ugrid.nc extension. For example, to
open the file ocean.vox.nc, vlmopen_vox can be called via
vlmopen_env("ocean", ...) or
vlmopen("ocean.vox.nc", ...). The dtype parameter
can take either VL_RAW or VL_NETCDF, indicating the data
file is in either the raw binary format or the NetCDF format, respectively.
However, VL_RAW is currently not supported. The mode parameter
is the NetCDF
file mode, either NC_WRITE or NC_NOWRITE.
NOTES
The raw binary format isn't not supported in the
current version of the VLMeta library.
SEE ALSO
vlmget_ugdim,
vlmget_ugrid,
vlmget_ugcells,
vlmget_ugvert, vlmclose,
ParVox Tutorial: Input
Data Format
DIAGNOSTICS
Upon successful completion, the file handle for the
file is returned. Otherwise, a value of -1 is returned.
|
 |