diff --git a/Makefile.am b/Makefile.am
index cfb6176cb0e..6c15f45f04f 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -2,9 +2,14 @@
# Ed Hartnett
-SUBDIRS = src tests examples
-
# Look in the m4 directory for autotools stuff.
ACLOCAL_AMFLAGS= -I m4
+# Does the user want to build fortran?
+if BUILD_DOCS
+DOC = doc
+endif
+
+SUBDIRS = src tests examples ${DOC}
+
EXTRA_DIST = CMakeLists.txt set_flags.am
diff --git a/configure.ac b/configure.ac
index ddb0da877ca..f34b9d466c0 100644
--- a/configure.ac
+++ b/configure.ac
@@ -2,10 +2,20 @@
## Ed Hartnett 8/16/17
# Initialize autoconf and automake.
-AC_INIT(pio, 2.4.0)
+AC_INIT(pio, 2.4.1)
AC_CONFIG_SRCDIR(src/clib/pio_darray.c)
AM_INIT_AUTOMAKE([foreign serial-tests])
+# The PIO version, again.
+AC_DEFINE([VERSION_MAJOR], [2], [PIO major version])
+AC_DEFINE([VERSION_MINOR], [4], [PIO minor version])
+AC_DEFINE([VERSION_PATCH], [1], [PIO patch version])
+
+# Once more for the documentation.
+AC_SUBST([VERSION_MAJOR], [2])
+AC_SUBST([VERSION_MINOR], [4])
+AC_SUBST([VERSION_PATCH], [1])
+
# The m4 directory holds macros for autoconf.
AC_CONFIG_MACRO_DIR([m4])
@@ -41,7 +51,6 @@ if test "x$enable_logging" = xyes; then
AC_DEFINE([PIO_ENABLE_LOGGING], 1, [If true, turn on logging.])
fi
-
# Does the user want to enable Fortran library?
AC_MSG_CHECKING([whether Fortran library should be build])
AC_ARG_ENABLE([fortran],
@@ -60,14 +69,32 @@ test "x$enable_pnetcdf" = xno || enable_pnetcdf=yes
AC_MSG_RESULT([$enable_pnetcdf])
AM_CONDITIONAL(BUILD_PNETCDF, [test "x$enable_pnetcdf" = xyes])
+# Does the user want to build documentation?
+AC_MSG_CHECKING([whether documentation should be build (requires doxygen)])
+AC_ARG_ENABLE([docs],
+ [AS_HELP_STRING([--enable-docs],
+ [enable building of documentation with doxygen.])])
+test "x$enable_docs" = xyes || enable_docs=no
+AC_MSG_RESULT([$enable_docs])
+AM_CONDITIONAL(BUILD_DOCS, [test "x$enable_docs" = xyes])
+
+# Is doxygen installed?
+AC_CHECK_PROGS([DOXYGEN], [doxygen])
+if test -z "$DOXYGEN" -a test "x$enable_docs" = xyes; then
+ AC_MSG_ERROR([Doxygen not found but --enable-docs used.])
+fi
+
+# If building docs, process Doxyfile.in into Doxyfile.
+if test "x$enable_docs" = xyes; then
+ AC_SUBST([CMAKE_CURRENT_SOURCE_DIR], ["."])
+ AC_SUBST([CMAKE_BINARY_DIR], [".."])
+ AC_SUBST([C_SRC_FILES], ["../src/clib/pio_nc4.c"])
+ AC_CONFIG_FILES([doc/Doxyfile])
+fi
+
# NetCDF (at least classic) is required for PIO to build.
AC_DEFINE([_NETCDF], [1], [netCDF classic library available])
-# The PIO version, again.
-AC_DEFINE([PIO_VERSION_MAJOR], [2], [PIO major version])
-AC_DEFINE([PIO_VERSION_MINOR], [4], [PIO minor version])
-AC_DEFINE([PIO_VERSION_PATCH], [0], [PIO patch version])
-
# ????
AC_DEFINE([CPRGNU], [1], [defined by CMake build])
@@ -143,5 +170,6 @@ AC_OUTPUT(Makefile
tests/unit/Makefile
tests/general/Makefile
tests/general/util/Makefile
+ doc/Makefile
examples/Makefile
examples/c/Makefile)
diff --git a/doc/Doxyfile.in b/doc/Doxyfile.in
index 55aaa4f81dd..5eb337fba77 100644
--- a/doc/Doxyfile.in
+++ b/doc/Doxyfile.in
@@ -58,7 +58,7 @@ PROJECT_LOGO =
# entered, it will be relative to the location where doxygen was started. If
# left blank the current directory will be used.
-OUTPUT_DIRECTORY = ../..
+OUTPUT_DIRECTORY = ..
# If the CREATE_SUBDIRS tag is set to YES then doxygen will create 4096 sub-
# directories (in 2 levels) under the output directory of each output format and
@@ -768,7 +768,7 @@ WARN_LOGFILE =
# spaces.
# Note: If this tag is empty the current directory is searched.
-INPUT = @CMAKE_CURRENT_SOURCE_DIR@/source \
+INPUT = @CMAKE_CURRENT_SOURCE_DIR@/../doc/source \
@CMAKE_CURRENT_SOURCE_DIR@/../src/flib \
@CMAKE_CURRENT_SOURCE_DIR@/../examples/c \
@CMAKE_CURRENT_SOURCE_DIR@/../examples/f03 \
@@ -1113,7 +1113,8 @@ HTML_STYLESHEET =
# list). For an example see the documentation.
# This tag requires that the tag GENERATE_HTML is set to YES.
-HTML_EXTRA_STYLESHEET = ../../docs/customdoxygen.css
+#HTML_EXTRA_STYLESHEET = ../../docs/customdoxygen.css
+HTML_EXTRA_STYLESHEET = customdoxygen.css
# The HTML_EXTRA_FILES tag can be used to specify one or more extra images or
# other source files which should be copied to the HTML output directory. Note
diff --git a/doc/Makefile.am b/doc/Makefile.am
new file mode 100644
index 00000000000..083c26f69c0
--- /dev/null
+++ b/doc/Makefile.am
@@ -0,0 +1,15 @@
+# This is part of PIO. It creates the doc Makefile.
+
+# Ed Hartnett 4/1/19
+
+EXTRA_DIST = CMakeLists.txt customdoxygen.css Doxyfile.in \
+DoxygenLayout.xml doxygen.sty
+
+# simple doxygen target
+all:
+ doxygen Doxyfile
+
+# clean up the extras including doxygen
+#clean-local:
+# cd ${top_srcdir}
+# rm -rf doxygen
diff --git a/docs/_c_a_mexample.html b/docs/_c_a_mexample.html
index baf83667f7a..a8fe87ee93f 100644
--- a/docs/_c_a_mexample.html
+++ b/docs/_c_a_mexample.html
@@ -23,7 +23,7 @@
PIO
- 2.4.0
+ 2.4.1
@@ -107,7 +107,7 @@
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/annotated.html b/docs/annotated.html
index 2291d5b9b52..8376ed135a2 100644
--- a/docs/annotated.html
+++ b/docs/annotated.html
@@ -23,7 +23,7 @@
The multi buffer holds data from one or more variables
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:43 for PIO by 1.8.13
diff --git a/docs/api.html b/docs/api.html
index e78f0442824..f60cb62d4fc 100644
--- a/docs/api.html
+++ b/docs/api.html
@@ -23,7 +23,7 @@
PIO
- 2.4.0
+ 2.4.1
@@ -149,7 +149,7 @@
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/contributing_code.html b/docs/contributing_code.html
index 55fb7b55fc9..5648ea8abc9 100644
--- a/docs/contributing_code.html
+++ b/docs/contributing_code.html
@@ -23,7 +23,7 @@
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/deprecated.html b/docs/deprecated.html
index 3e617b5eeee..3d6897e092f 100644
--- a/docs/deprecated.html
+++ b/docs/deprecated.html
@@ -23,7 +23,7 @@
PIO
- 2.4.0
+ 2.4.1
@@ -77,7 +77,7 @@
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/dir_000001_000005.html b/docs/dir_000001_000005.html
deleted file mode 100644
index 61716c5ad2a..00000000000
--- a/docs/dir_000001_000005.html
+++ /dev/null
@@ -1,75 +0,0 @@
-
-
-
-
-
-
-
-PIO: c -> src Relation
-
-
-
-
-
-
-
-
-
-
-
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:43 for PIO by 1.8.13
diff --git a/docs/dir_209baab7a174f8da935e472521be6c82.html b/docs/dir_209baab7a174f8da935e472521be6c82.html
index d42010e9135..11087b62ced 100644
--- a/docs/dir_209baab7a174f8da935e472521be6c82.html
+++ b/docs/dir_209baab7a174f8da935e472521be6c82.html
@@ -23,7 +23,7 @@
PIO
- 2.4.0
+ 2.4.1
@@ -78,7 +78,7 @@
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:43 for PIO by 1.8.13
diff --git a/docs/dir_4e7c8c4fc0d923782da8a23d70a9725b.html b/docs/dir_4e7c8c4fc0d923782da8a23d70a9725b.html
deleted file mode 100644
index 9be3674bc89..00000000000
--- a/docs/dir_4e7c8c4fc0d923782da8a23d70a9725b.html
+++ /dev/null
@@ -1,83 +0,0 @@
-
-
-
-
-
-
-
-PIO: src Directory Reference
-
-
-
-
-
-
-
-
-
-
-
-
-
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
-
- 1.8.13
-
-
-
diff --git a/docs/dir_68267d1309a1af8e8297ef4c3efbcdba.html b/docs/dir_68267d1309a1af8e8297ef4c3efbcdba.html
index d7edda724c8..28eb34d239c 100644
--- a/docs/dir_68267d1309a1af8e8297ef4c3efbcdba.html
+++ b/docs/dir_68267d1309a1af8e8297ef4c3efbcdba.html
@@ -23,7 +23,7 @@
PIO
- 2.4.0
+ 2.4.1
@@ -75,7 +75,7 @@
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:43 for PIO by 1.8.13
diff --git a/docs/dir_6df6542b1223c38c3752260fabab64d0.html b/docs/dir_6df6542b1223c38c3752260fabab64d0.html
index 8c9b23290d0..0d34c70a82e 100644
--- a/docs/dir_6df6542b1223c38c3752260fabab64d0.html
+++ b/docs/dir_6df6542b1223c38c3752260fabab64d0.html
@@ -23,7 +23,7 @@
PIO
- 2.4.0
+ 2.4.1
@@ -68,17 +68,6 @@
c Directory Reference
-
-Directory dependency graph for c:
-
-
-
-
Files
@@ -95,7 +84,7 @@
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:43 for PIO by 1.8.13
diff --git a/docs/dir_6df6542b1223c38c3752260fabab64d0_dep.map b/docs/dir_6df6542b1223c38c3752260fabab64d0_dep.map
deleted file mode 100644
index 31f56c199ef..00000000000
--- a/docs/dir_6df6542b1223c38c3752260fabab64d0_dep.map
+++ /dev/null
@@ -1,6 +0,0 @@
-
diff --git a/docs/dir_6df6542b1223c38c3752260fabab64d0_dep.md5 b/docs/dir_6df6542b1223c38c3752260fabab64d0_dep.md5
deleted file mode 100644
index a48c18bc29c..00000000000
--- a/docs/dir_6df6542b1223c38c3752260fabab64d0_dep.md5
+++ /dev/null
@@ -1 +0,0 @@
-c15eae5ab828351daca656d5f8d55de9
\ No newline at end of file
diff --git a/docs/dir_6df6542b1223c38c3752260fabab64d0_dep.png b/docs/dir_6df6542b1223c38c3752260fabab64d0_dep.png
deleted file mode 100644
index 201d2aaeec0..00000000000
Binary files a/docs/dir_6df6542b1223c38c3752260fabab64d0_dep.png and /dev/null differ
diff --git a/docs/dir_d28a4824dc47e487b107a5db32ef43c4.html b/docs/dir_d28a4824dc47e487b107a5db32ef43c4.html
index b4922ff8d94..d303a81c7b9 100644
--- a/docs/dir_d28a4824dc47e487b107a5db32ef43c4.html
+++ b/docs/dir_d28a4824dc47e487b107a5db32ef43c4.html
@@ -23,7 +23,7 @@
PIO
- 2.4.0
+ 2.4.1
@@ -68,18 +68,6 @@
examples Directory Reference
-
-Directory dependency graph for examples:
-
-
-
-
Directories
@@ -87,7 +75,7 @@
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:43 for PIO by 1.8.13
diff --git a/docs/dir_d28a4824dc47e487b107a5db32ef43c4_dep.map b/docs/dir_d28a4824dc47e487b107a5db32ef43c4_dep.map
deleted file mode 100644
index 34341e04354..00000000000
--- a/docs/dir_d28a4824dc47e487b107a5db32ef43c4_dep.map
+++ /dev/null
@@ -1,7 +0,0 @@
-
diff --git a/docs/dir_d28a4824dc47e487b107a5db32ef43c4_dep.md5 b/docs/dir_d28a4824dc47e487b107a5db32ef43c4_dep.md5
deleted file mode 100644
index 1eaf263e79e..00000000000
--- a/docs/dir_d28a4824dc47e487b107a5db32ef43c4_dep.md5
+++ /dev/null
@@ -1 +0,0 @@
-9e340fa03f75ff81b19de76fe100348e
\ No newline at end of file
diff --git a/docs/dir_d28a4824dc47e487b107a5db32ef43c4_dep.png b/docs/dir_d28a4824dc47e487b107a5db32ef43c4_dep.png
deleted file mode 100644
index efb6c649617..00000000000
Binary files a/docs/dir_d28a4824dc47e487b107a5db32ef43c4_dep.png and /dev/null differ
diff --git a/docs/dir_dd5ba6a73ef501ea0d15f68121a953e3.html b/docs/dir_dd5ba6a73ef501ea0d15f68121a953e3.html
deleted file mode 100644
index 4869779e111..00000000000
--- a/docs/dir_dd5ba6a73ef501ea0d15f68121a953e3.html
+++ /dev/null
@@ -1,95 +0,0 @@
-
-
-
-
-
-
-
-PIO: flib Directory Reference
-
-
-
-
-
-
-
-
-
-
-
-
-
-Generated on Fri Feb 8 2019 13:02:30 for PIO by
-
- 1.8.13
-
-
-
diff --git a/docs/error.html b/docs/error.html
index fdb058e1322..9e6c8d8ad54 100644
--- a/docs/error.html
+++ b/docs/error.html
@@ -23,7 +23,7 @@
PIO
- 2.4.0
+ 2.4.1
@@ -65,7 +65,16 @@
By default, PIO handles errors internally by printing a string describing the error and then calling mpi_abort. Application developers can change this behaivior with a call to PIO_seterrorhandling
-
The three types of error handling methods are:
+
call pio_seterrorhandling(File, PIO_BCAST_ERROR)
+ ierr = pio_inq_varid(File, 'U', uid)
+ call pio_seterrorhandling(File, PIO_INTERNAL_ERROR)
+ if(ierr/= PIO_NOERR) then
+ write(stderr,*) 'Variable U not found on input file, setting to 0'
+ U=0
+ else
+ ...
+ endif
+
The three types of error handling methods are:
PIO_INTERNAL_ERROR : abort on error from any task
PIO_BCAST_ERROR : broadcast an error from io_rank 0 to all tasks in comm
PIO_RETURN_ERROR : do nothing - allow the user to handle it
@@ -74,7 +83,7 @@
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/examp.html b/docs/examp.html
index 67b75fc57cf..d3e8065cd81 100644
--- a/docs/examp.html
+++ b/docs/examp.html
@@ -23,7 +23,7 @@
PIO
- 2.4.0
+ 2.4.1
@@ -87,7 +87,7 @@
Other Examples
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/example1_8c.html b/docs/example1_8c.html
index fd16d231125..3815fa69387 100644
--- a/docs/example1_8c.html
+++ b/docs/example1_8c.html
@@ -23,7 +23,7 @@
PIOc_Init_Intracomm(). It references an internal structure containing the general IO subsystem data and MPI structure. It is passed to PIOc_finalize() to free associated resources, after all I/O, but before MPI_Finalize is called.
+
The ID for the parallel I/O system. It is set by PIOc_Init_Intracomm(). It references an internal structure containing the general IO subsystem data and MPI structure. It is passed to PIOc_finalize() to free associated resources, after all I/O, but before MPI_Finalize is called.
The ncid of the netCDF file created in this example.
The ID of the netCDF varable in the example file.
-
The I/O description ID as passed back by PIOc_InitDecomp() and freed in PIOc_freedecomp().
+
The I/O description ID as passed back by PIOc_InitDecomp() and freed in PIOc_freedecomp().
A buffer for sample data. The size of this array will vary depending on how many processors are involved in the execution of the example code. It's length will be the same as elements_per_pe.
A 1-D array which holds the decomposition mapping for this example. The size of this array will vary depending on how many processors are involved in the execution of the example code. It's length will be the same as elements_per_pe.
Test filename.
@@ -478,7 +475,7 @@
-Generated on Fri Feb 8 2019 13:02:30 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/example1_8c__incl.map b/docs/example1_8c__incl.map
index 0eb046f1dcf..f5caa5c2268 100644
--- a/docs/example1_8c__incl.map
+++ b/docs/example1_8c__incl.map
@@ -1,3 +1,2 @@
diff --git a/docs/example1_8c__incl.md5 b/docs/example1_8c__incl.md5
index f6cf399f15f..0c7d75dd90a 100644
--- a/docs/example1_8c__incl.md5
+++ b/docs/example1_8c__incl.md5
@@ -1 +1 @@
-55e365c2810caf69105a63b48a9c55d7
\ No newline at end of file
+c440a0a64b9cc9889236ec95c4506eb2
\ No newline at end of file
diff --git a/docs/example1_8c__incl.png b/docs/example1_8c__incl.png
index 1bf1957bfe1..ba6752254d1 100644
Binary files a/docs/example1_8c__incl.png and b/docs/example1_8c__incl.png differ
diff --git a/docs/example2_8c.html b/docs/example2_8c.html
index 169eede751b..642eb5aa232 100644
--- a/docs/example2_8c.html
+++ b/docs/example2_8c.html
@@ -23,7 +23,7 @@
PIOc_Init_Intracomm(). It references an internal structure containing the general IO subsystem data and MPI structure. It is passed to PIOc_finalize() to free associated resources, after all I/O, but before MPI_Finalize is called.
+
The ID for the parallel I/O system. It is set by PIOc_Init_Intracomm(). It references an internal structure containing the general IO subsystem data and MPI structure. It is passed to PIOc_finalize() to free associated resources, after all I/O, but before MPI_Finalize is called.
The ncid of the netCDF file created in this example.
The ID of the netCDF varable in the example file.
-
The I/O description ID as passed back by PIOc_InitDecomp() and freed in PIOc_freedecomp().
+
The I/O description ID as passed back by PIOc_InitDecomp() and freed in PIOc_freedecomp().
A buffer for sample data. The size of this array will vary depending on how many processors are involved in the execution of the example code. It's length will be the same as elements_per_pe.
A buffer for reading data back from the file. The size of this array will vary depending on how many processors are involved in the execution of the example code. It's length will be the same as elements_per_pe.
A 1-D array which holds the decomposition mapping for this example. The size of this array will vary depending on how many processors are involved in the execution of the example code. It's length will be the same as elements_per_pe.
@@ -706,7 +703,7 @@
-Generated on Fri Feb 8 2019 13:02:30 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/example2_8c__incl.map b/docs/example2_8c__incl.map
index 5954de96525..2d2df217c78 100644
--- a/docs/example2_8c__incl.map
+++ b/docs/example2_8c__incl.map
@@ -1,3 +1,2 @@
diff --git a/docs/example2_8c__incl.md5 b/docs/example2_8c__incl.md5
index b976a8f4ce9..f59b67118b9 100644
--- a/docs/example2_8c__incl.md5
+++ b/docs/example2_8c__incl.md5
@@ -1 +1 @@
-859389a04a3976b66e38e403dd77936a
\ No newline at end of file
+1192fe852105b87bcaeda8ef0725dbe2
\ No newline at end of file
diff --git a/docs/example2_8c__incl.png b/docs/example2_8c__incl.png
index df2f7a695de..481cba329db 100644
Binary files a/docs/example2_8c__incl.png and b/docs/example2_8c__incl.png differ
diff --git a/docs/example_pio_8c.html b/docs/example_pio_8c.html
index 2e1af34a805..c7a65964964 100644
--- a/docs/example_pio_8c.html
+++ b/docs/example_pio_8c.html
@@ -23,7 +23,7 @@
This function frees the memory used in this example. It calls the ParallelIO library function PIOc_freedecomp() to free decomposition resources. Then calles PIOc_finalize() and MPI_finalize() to free library resources.
Uses the PIOc_closefile() function to close the netCDF sample file written by this example.
Parameters
[in]
this
Pointer to self.
@@ -239,7 +236,7 @@
PIOc_InitDecomp() to initalize the decomposition for this example. The arguments are:
+
Uses PIOc_InitDecomp() to initalize the decomposition for this example. The arguments are:
the ID of the IO system, obtained from PIOc_init_intracomm().
the NetCDF type of the sample data - in this case a 4-byte integer.
the number of dimensions (1).
@@ -298,14 +295,14 @@
PIOc_createfile() to create the netCDF output file. The format of the file is created in accordance with the iotype member variable, which specifies one of the following values:
+
Uses the function PIOc_createfile() to create the netCDF output file. The format of the file is created in accordance with the iotype member variable, which specifies one of the following values:
PIO_IOTYPE_PNETCDF=1 Parallel Netcdf (parallel)
PIO_IOTYPE_NETCDF=2 Netcdf3 Classic format (serial)
PIO_IOTYPE_NETCDF4C=3 NetCDF4 (HDF5) compressed format (serial)
All of the functions take the pioFileDesc returned by PIOc_createfile(). This is the ncid of the netCDF file.
+
It defines a dimension and a one-dimensional variable in the netCDF file using functions PIOc_def_dim() and PIOc_def_var(). It then calls PIOc_enddef() to end the define mode of the file.
+
All of the functions take the pioFileDesc returned by PIOc_createfile(). This is the ncid of the netCDF file.
On error, process with rank zero will print error message, the netCDF file will be closed with PIOc_closefile(), and MPI_Abort is called to end the example execution on all processes.
This function reads the data that has been written to the sample data file. The data are read with the PIOc_read_darray() function.
Parameters
[in]
this
Pointer to self.
@@ -543,7 +540,7 @@
PIOc_write_darray() function. After the write is complete, ensure the file is synced for all processes after the write.
+
The data are written with the PIOc_write_darray() function. After the write is complete, ensure the file is synced for all processes after the write.
Parameters
[in]
this
Pointer to self.
@@ -627,7 +624,7 @@
-Generated on Fri Feb 8 2019 13:02:30 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/example_pio_8c__incl.map b/docs/example_pio_8c__incl.map
index 3632c25cc60..370decf8e3a 100644
--- a/docs/example_pio_8c__incl.map
+++ b/docs/example_pio_8c__incl.map
@@ -1,3 +1,2 @@
diff --git a/docs/example_pio_8c__incl.md5 b/docs/example_pio_8c__incl.md5
index b2ea0cf9b6e..e964b4b98ce 100644
--- a/docs/example_pio_8c__incl.md5
+++ b/docs/example_pio_8c__incl.md5
@@ -1 +1 @@
-358e3b409d794bc3922912702840cf7e
\ No newline at end of file
+5c7fa3122920813477d1983179a7e269
\ No newline at end of file
diff --git a/docs/example_pio_8c__incl.png b/docs/example_pio_8c__incl.png
index f0a1ea1e2f8..b0c5b034b56 100644
Binary files a/docs/example_pio_8c__incl.png and b/docs/example_pio_8c__incl.png differ
diff --git a/docs/example_pio_8f90.html b/docs/example_pio_8f90.html
index 09798385397..f6b8a13787f 100644
--- a/docs/example_pio_8f90.html
+++ b/docs/example_pio_8f90.html
@@ -23,7 +23,7 @@
PIO
- 2.4.0
+ 2.4.1
@@ -149,7 +149,7 @@
-Generated on Fri Feb 8 2019 13:02:30 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/faq.html b/docs/faq.html
index 117d4a05d50..2369a25289d 100644
--- a/docs/faq.html
+++ b/docs/faq.html
@@ -23,7 +23,7 @@
PIO
- 2.4.0
+ 2.4.1
@@ -81,7 +81,7 @@
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/files.html b/docs/files.html
index 05cd8ac0bbd..eba1d6abfef 100644
--- a/docs/files.html
+++ b/docs/files.html
@@ -23,7 +23,7 @@
PIO
- 2.4.0
+ 2.4.1
@@ -66,35 +66,26 @@
Here is a list of all documented files with brief descriptions:
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:43 for PIO by 1.8.13
diff --git a/docs/globals.html b/docs/globals.html
index b81bd21ba54..bb3ed908ecb 100644
--- a/docs/globals.html
+++ b/docs/globals.html
@@ -23,7 +23,7 @@
PIO
- 2.4.0
+ 2.4.1
@@ -62,16 +62,194 @@
Here is a list of all documented file members with links to the documentation:
-
-
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
-
- 1.8.13
-
-
-
diff --git a/docs/graph_legend.html b/docs/graph_legend.html
index dfda35b6726..73f4798eeb0 100644
--- a/docs/graph_legend.html
+++ b/docs/graph_legend.html
@@ -23,7 +23,7 @@
PIO
- 2.4.0
+ 2.4.1
@@ -96,7 +96,7 @@
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:43 for PIO by 1.8.13
diff --git a/docs/group___p_i_o__advanceframe.html b/docs/group___p_i_o__advanceframe.html
index ff3af972a23..c188253fd4a 100644
--- a/docs/group___p_i_o__advanceframe.html
+++ b/docs/group___p_i_o__advanceframe.html
@@ -23,7 +23,7 @@
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/group___p_i_o__closefile.html b/docs/group___p_i_o__closefile.html
index 162b35cba49..b854104697d 100644
--- a/docs/group___p_i_o__closefile.html
+++ b/docs/group___p_i_o__closefile.html
@@ -23,7 +23,7 @@
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/group___p_i_o__createfile.html b/docs/group___p_i_o__createfile.html
index 6d2c8c61066..41799de0d9b 100644
--- a/docs/group___p_i_o__createfile.html
+++ b/docs/group___p_i_o__createfile.html
@@ -23,7 +23,7 @@
Input parameters are read on comp task 0 and ignored elsewhere. NOFILL mode will be turned on in all cases.
-
Parameters
-
-
iosysid
A defined pio system ID, obtained from PIOc_InitIntercomm() or PIOc_InitAsync().
-
ncidp
A pointer that gets the ncid of the newly created file.
-
iotype
A pointer to a pio output format. Must be one of PIO_IOTYPE_PNETCDF, PIO_IOTYPE_NETCDF, PIO_IOTYPE_NETCDF4C, or PIO_IOTYPE_NETCDF4P.
-
filename
The filename to create.
-
mode
The netcdf mode for the create operation.
-
-
-
-
Returns
0 for success, error code otherwise.
-
Author
Jim Edwards, Ed Hartnett
-
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/group___p_i_o__def__dim.html b/docs/group___p_i_o__def__dim.html
index 4f1f1a093d3..23df95a7b25 100644
--- a/docs/group___p_i_o__def__dim.html
+++ b/docs/group___p_i_o__def__dim.html
@@ -23,7 +23,7 @@
a pointer that will get the id of the variable or attribute.
-
-
-
-
Returns
PIO_NOERR for success, error code otherwise.
-
Author
Jim Edwards, Ed Hartnett
-
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/group___p_i_o__def__var.html b/docs/group___p_i_o__def__var.html
index 6da12c9d277..6cc96508ea3 100644
--- a/docs/group___p_i_o__def__var.html
+++ b/docs/group___p_i_o__def__var.html
@@ -23,7 +23,7 @@
When the fill mode for the file is NC_FILL, then fill values are used for missing data. This function sets the fill value to be used for a variable. If no specific fill value is set (as a _FillValue attribute), then the default fill values from netcdf.h are used.
-
NetCDF-4 and pnetcdf files allow setting fill_mode (to NC_FILL or NC_NOFILL) on a per-variable basis. NetCDF classic only allows the fill_mode setting to be set for the whole file. For this function, the fill_mode parameter is ignored for classic files. Set the file-level fill mode with PIOc_set_fill().
-
Parameters
-
-
ncid
the ncid of the open file.
-
varid
the ID of the variable to set chunksizes for.
-
fill_mode
fill mode for this variable (NC_FILL or NC_NOFILL)
-
fill_value
pointer to the fill value to be used if fill_mode is set to NC_FILL.
-
-
-
-
Returns
PIO_NOERR for success, otherwise an error code.
-
Author
Jim Edwards, Ed Hartnett
-
@@ -710,7 +583,7 @@
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/group___p_i_o__enddef.html b/docs/group___p_i_o__enddef.html
index 45a72f7d764..d28fdeadc13 100644
--- a/docs/group___p_i_o__enddef.html
+++ b/docs/group___p_i_o__enddef.html
@@ -23,7 +23,7 @@
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/group___p_i_o__error__method.html b/docs/group___p_i_o__error__method.html
index 38eafea098f..066f4b2b47e 100644
--- a/docs/group___p_i_o__error__method.html
+++ b/docs/group___p_i_o__error__method.html
@@ -23,7 +23,7 @@
Set the error handling method to be used for subsequent pio library calls, returns the previous method setting.
-
Note that this changes error handling for the IO system that was used when this file was opened. Other files opened with the same IO system will also he affected by this call. This function is supported but deprecated. New code should use PIOc_set_iosystem_error_handling(). This method has no way to return an error, so any failure will result in MPI_Abort.
Set the error handling method used for subsequent calls.
-
This function is deprecated. New code should use PIOc_set_iosystem_error_handling(). This method has no way to return an error, so any failure will result in MPI_Abort.
Set the error handling method used for subsequent calls for this IO system.
-
Parameters
-
-
iosysid
the IO system ID. Passing PIO_DEFAULT instead changes the default error handling for the library.
-
method
the error handling method
-
old_method
pointer to int that will get old method. Ignored if NULL.
-
-
-
-
Returns
0 for success, error code otherwise.
-
Author
Jim Edwards, Ed Hartnett
-
-
-
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/group___p_i_o__finalize.html b/docs/group___p_i_o__finalize.html
index 8f0b2c03bac..9f9d7adc5d7 100644
--- a/docs/group___p_i_o__finalize.html
+++ b/docs/group___p_i_o__finalize.html
@@ -23,7 +23,7 @@
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/group___p_i_o__freedecomp.html b/docs/group___p_i_o__freedecomp.html
index e0a734940e1..4308d236af8 100644
--- a/docs/group___p_i_o__freedecomp.html
+++ b/docs/group___p_i_o__freedecomp.html
@@ -23,7 +23,7 @@
IO descriptor structure. This structure defines the mapping for a given variable between compute and IO decomposition.
+
iodesc
@@ -165,7 +165,7 @@
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/group___p_i_o__get__att.html b/docs/group___p_i_o__get__att.html
index d78ea6acd72..6263ca5d381 100644
--- a/docs/group___p_i_o__get__att.html
+++ b/docs/group___p_i_o__get__att.html
@@ -23,7 +23,7 @@
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/group___p_i_o__get__local__array__size.html b/docs/group___p_i_o__get__local__array__size.html
index 79a09b0a29b..145970d3955 100644
--- a/docs/group___p_i_o__get__local__array__size.html
+++ b/docs/group___p_i_o__get__local__array__size.html
@@ -23,7 +23,7 @@
-Generated on Fri Feb 8 2019 13:02:31 for PIO by
+Generated on Mon Apr 1 2019 08:48:42 for PIO by 1.8.13
diff --git a/docs/group___p_i_o__get__var.html b/docs/group___p_i_o__get__var.html
index e5e53e89c60..e6e393f2011 100644
--- a/docs/group___p_i_o__get__var.html
+++ b/docs/group___p_i_o__get__var.html
@@ -23,7 +23,7 @@
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.
: A vector of size_t integers specifying the index in the variable where the first of the data values will be read. The indices are relative to 0, so for example, the first data value of a variable would have index (0, 0, ... , 0). The length of start must be the same as the number of dimensions of the specified variable. The elements of start correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first index would correspond to the starting record number for reading the data values.
count
: A vector of size_t integers specifying the edge lengths along each dimension of the block of data values to be read. To read a single value, for example, specify count as (1, 1, ... , 1). The length of count is the number of dimensions of the specified variable. The elements of count correspond, in order, to the variable's dimensions. Hence, if the variable is a record variable, the first element of count corresponds to a count of the number of records to read. Note: setting any element of the count array to zero causes the function to exit without error, and without doing anything.