/
list.py
105 lines (79 loc) · 2.5 KB
/
list.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
from . import core, mixin
class List(
mixin.NetCDFVariable,
mixin.PropertiesData,
mixin.Files,
core.abstract.PropertiesData,
):
"""A list variable required to uncompress a gathered array.
Compression by gathering combines axes of a multidimensional array
into a new, discrete axis whilst omitting the missing values and
thus reducing the number of values that need to be stored.
The information needed to uncompress the data is stored in a list
variable that gives the indices of the required points.
**NetCDF interface**
{{netCDF variable}}
.. versionadded:: (cfdm) 1.7.0
"""
def __init__(
self,
properties=None,
data=None,
source=None,
copy=True,
_use_data=True,
):
"""**Initialisation**
:Parameters:
{{init properties: `dict`, optional}}
*Parameter example:*
``properties={'long_name': 'uncompression indices'}``
{{init data: data_like, optional}}
{{init source: optional}}
{{init copy: `bool`, optional}}
"""
super().__init__(
properties=properties,
data=data,
source=source,
copy=copy,
_use_data=_use_data,
)
self._initialise_netcdf(source)
self._initialise_original_filenames(source)
def dump(
self,
display=True,
_key=None,
_title=None,
_create_title=True,
_prefix="",
_level=0,
_omit_properties=None,
_axes=None,
_axis_names=None,
):
"""A full description of the list variable.
Returns a description of all properties, including those of
components, and provides selected values of all data arrays.
.. versionadded:: (cfdm) 1.7.0
:Parameters:
display: `bool`, optional
If False then return the description as a string. By
default the description is printed.
:Returns:
{{returns dump}}
"""
if _create_title and _title is None:
_title = "List: " + self.identity(default="")
return super().dump(
display=display,
_key=_key,
_omit_properties=_omit_properties,
_prefix=_prefix,
_level=_level,
_title=_title,
_create_title=_create_title,
_axes=_axes,
_axis_names=_axis_names,
)