@@ -97,13 +97,13 @@ class Path:
9797CLOSEPOLY :1 }
9898
9999def __init__ (self ,vertices ,codes = None ,_interpolation_steps = 1 ,
100- closed = False ,readonly = False ):
100+ closed = False ,readonly = False , dims = 2 ):
101101"""
102102 Create a new path with the given vertices and codes.
103103
104104 Parameters
105105 ----------
106- vertices : (N,2 ) array-like
106+ vertices : (N,dims ) array-like
107107 The path vertices, as an array, masked array or sequence of pairs.
108108 Masked values, if any, will be converted to NaNs, which are then
109109 handled correctly by the Agg PathIterator and other consumers of
@@ -125,9 +125,14 @@ def __init__(self, vertices, codes=None, _interpolation_steps=1,
125125 readonly : bool, optional
126126 Makes the path behave in an immutable way and sets the vertices
127127 and codes as read-only arrays.
128+ dims : int, optional
128129 """
130+ if dims <= 1 :
131+ raise ValueError ("Path must be at least 2D" )
132+ self ._dims = dims
133+
129134vertices = _to_unmasked_float_array (vertices )
130- _api .check_shape ((None ,2 ),vertices = vertices )
135+ _api .check_shape ((None ,dims ),vertices = vertices )
131136
132137if codes is not None :
133138codes = np .asarray (codes ,self .code_type )
@@ -160,7 +165,7 @@ def __init__(self, vertices, codes=None, _interpolation_steps=1,
160165self ._readonly = False
161166
162167@classmethod
163- def _fast_from_codes_and_verts (cls ,verts ,codes ,internals_from = None ):
168+ def _fast_from_codes_and_verts (cls ,verts ,codes ,internals_from = None , dims = 2 ):
164169"""
165170 Create a Path instance without the expense of calling the constructor.
166171
@@ -178,6 +183,7 @@ def _fast_from_codes_and_verts(cls, verts, codes, internals_from=None):
178183pth ._vertices = _to_unmasked_float_array (verts )
179184pth ._codes = codes
180185pth ._readonly = False
186+ pth ._dims = dims
181187if internals_from is not None :
182188pth ._should_simplify = internals_from ._should_simplify
183189pth ._simplify_threshold = internals_from ._simplify_threshold
@@ -210,7 +216,7 @@ def _update_values(self):
210216
211217@property
212218def vertices (self ):
213- """The vertices of the `Path` as an (N,2 ) array."""
219+ """The vertices of the `Path` as an (N,dims ) array."""
214220return self ._vertices
215221
216222@vertices .setter