netCDF4netcdf4-python is a Python interface to the netCDF C library.
netCDF version 4 has many features @@ -1003,6 +1014,11 @@
Import warning regarding threads: +The underlying netcdf-c library is not thread-safe, so netcdf4-python cannot perform parallel +IO in a multi-threaded environment. +Users should expect segfaults if a netcdf file is opened on multiple threads - care should +be taken to restrict netcdf4-python usage to a single thread, even when using free-threaded python.
The most flexible way to store arrays of strings is with the Variable-length (vlen) string data type. However, this requires @@ -1018,7 +1034,7 @@
S1) variable, the chartostring() utility function is used to convert the array of
characters to an array of strings with one less dimension (the last dimension is
interpreted as the length of each string) when reading the data. The character
-set (usually ascii) is specified by the _Encoding attribute. If _Encoding
+set is specified by the _Encoding attribute. If _Encoding
is 'none' or 'bytes', then the character array is converted to a numpy
fixed-width byte string array (dtype S#), otherwise a numpy unicode (dtype
U#) array is created.
@@ -1196,7 +1212,7 @@ Support for complex numbers is handled via the
nc-complex library. See there for
further details.
contact: Jeffrey Whitaker jeffrey.s.whitaker@noaa.gov
+contact: Jeffrey Whitaker whitaker.jeffrey@gmail.com
copyright: 2008 by Jeffrey Whitaker.
license: Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
@@ -1229,7 +1245,7 @@date2index(dates, nctime, calendar=None, select=u'exact', has_year_zero=None)
+date2index(dates, nctime, calendar=None, select='exact', has_year_zero=None)
Return indices of a netCDF time variable corresponding to the given dates.
dates: A datetime object or a sequence of datetime objects. The datetime objects should not include a time-zone offset.
@@ -1347,10 +1363,10 @@
-def num2date(times, units, calendar='standard', only_use_cftime_datetimes=True, only_use_python_datetimes=False, has_year_zero=None)
+def num2date(times,
units,
calendar='standard',
only_use_cftime_datetimes=True,
only_use_python_datetimes=False,
has_year_zero=None)
num2date(times, units, calendar=u'standard', only_use_cftime_datetimes=True, only_use_python_datetimes=False, has_year_zero=None)
+num2date(times, units, calendar='standard', only_use_cftime_datetimes=True, only_use_python_datetimes=False, has_year_zero=None)
Return datetime objects given numeric time values. The units of the numeric time values are described by the units argument and the calendar keyword. The returned datetime objects represent @@ -1460,10 +1476,10 @@
'U1' (if dtype='U')
-def stringtochar(a, encoding='utf-8')
+def stringtochar(a, encoding='utf-8', n_strlen=None)
stringtochar(a,encoding='utf-8')
stringtochar(a,encoding='utf-8',n_strlen=None)
convert a string array to a character array with one extra dimension
a:
Input numpy string array with numpy datatype 'SN' or 'UN', where N
@@ -1473,6 +1489,10 @@
optional kwarg encoding can be used to specify character encoding (default
utf-8). If encoding is 'none' or 'bytes', a numpy.string_ the input array
is treated a raw byte strings (numpy.string_).
optional kwarg n_strlen is the number of characters in each string.
+Default
+is None, which means n_strlen will be set to a.itemsize (the number of bytes
+used to represent each string in the input array).
returns a numpy character array with datatype 'S1' or 'U1'
and shape a.shape + (N,), where N is the length of each string in a.
-def createVariable(self, varname, datatype, dimensions=(), compression=None, zlib=False, complevel=4, shuffle=True, szip_coding='nn', szip_pixels_per_block=8, blosc_shuffle=1, fletcher32=False, contiguous=False, chunksizes=None, endian='native', least_significant_digit=None, significant_digits=None, quantize_mode='BitGroom', fill_value=None, chunk_cache=None)
+def createVariable(self,
varname,
datatype,
dimensions=(),
compression=None,
zlib=False,
complevel=4,
shuffle=True,
szip_coding='nn',
szip_pixels_per_block=8,
blosc_shuffle=1,
fletcher32=False,
contiguous=False,
chunksizes=None,
endian='native',
least_significant_digit=None,
significant_digits=None,
quantize_mode='BitGroom',
fill_value=None,
chunk_cache=None)
createVariable(self, varname, datatype, dimensions=(), compression=None, zlib=False,
@@ -3144,7 +3164,7 @@ Methods