6 from fractions
import Fraction
8 from . import islhelper
9 from .islhelper
import mainctx
, libisl
10 from .linexprs
import Expression
, Symbol
, Rational
11 from .geometry
import GeometricObject
, Point
, Vector
20 @functools.total_ordering
21 class Domain(GeometricObject
):
29 def __new__(cls
, *polyhedra
):
30 from .polyhedra
import Polyhedron
31 if len(polyhedra
) == 1:
32 argument
= polyhedra
[0]
33 if isinstance(argument
, str):
34 return cls
.fromstring(argument
)
35 elif isinstance(argument
, GeometricObject
):
36 return argument
.aspolyhedron()
38 raise TypeError('argument must be a string '
39 'or a GeometricObject instance')
41 for polyhedron
in polyhedra
:
42 if not isinstance(polyhedron
, Polyhedron
):
43 raise TypeError('arguments must be Polyhedron instances')
44 symbols
= cls
._xsymbols
(polyhedra
)
45 islset
= cls
._toislset
(polyhedra
, symbols
)
46 return cls
._fromislset
(islset
, symbols
)
49 def _xsymbols(cls
, iterator
):
51 Return the ordered tuple of symbols present in iterator.
55 symbols
.update(item
.symbols
)
56 return tuple(sorted(symbols
, key
=Symbol
.sortkey
))
60 return self
._polyhedra
68 return self
._dimension
72 Returns this set as disjoint.
74 islset
= self
._toislset
(self
.polyhedra
, self
.symbols
)
75 islset
= libisl
.isl_set_make_disjoint(mainctx
, islset
)
76 return self
._fromislset
(islset
, self
.symbols
)
80 Returns true if this set is an Empty set.
82 islset
= self
._toislset
(self
.polyhedra
, self
.symbols
)
83 empty
= bool(libisl
.isl_set_is_empty(islset
))
84 libisl
.isl_set_free(islset
)
88 return not self
.isempty()
92 Returns true if this set is the Universe set.
94 islset
= self
._toislset
(self
.polyhedra
, self
.symbols
)
95 universe
= bool(libisl
.isl_set_plain_is_universe(islset
))
96 libisl
.isl_set_free(islset
)
101 Returns true if this set is bounded.
103 islset
= self
._toislset
(self
.polyhedra
, self
.symbols
)
104 bounded
= bool(libisl
.isl_set_is_bounded(islset
))
105 libisl
.isl_set_free(islset
)
108 def __eq__(self
, other
):
110 Returns true if two sets are equal.
112 symbols
= self
._xsymbols
([self
, other
])
113 islset1
= self
._toislset
(self
.polyhedra
, symbols
)
114 islset2
= other
._toislset
(other
.polyhedra
, symbols
)
115 equal
= bool(libisl
.isl_set_is_equal(islset1
, islset2
))
116 libisl
.isl_set_free(islset1
)
117 libisl
.isl_set_free(islset2
)
120 def isdisjoint(self
, other
):
122 Return True if two sets have a null intersection.
124 symbols
= self
._xsymbols
([self
, other
])
125 islset1
= self
._toislset
(self
.polyhedra
, symbols
)
126 islset2
= self
._toislset
(other
.polyhedra
, symbols
)
127 equal
= bool(libisl
.isl_set_is_disjoint(islset1
, islset2
))
128 libisl
.isl_set_free(islset1
)
129 libisl
.isl_set_free(islset2
)
132 def issubset(self
, other
):
134 Report whether another set contains this set.
136 symbols
= self
._xsymbols
([self
, other
])
137 islset1
= self
._toislset
(self
.polyhedra
, symbols
)
138 islset2
= self
._toislset
(other
.polyhedra
, symbols
)
139 equal
= bool(libisl
.isl_set_is_subset(islset1
, islset2
))
140 libisl
.isl_set_free(islset1
)
141 libisl
.isl_set_free(islset2
)
144 def __le__(self
, other
):
146 Returns true if this set is less than or equal to another set.
148 return self
.issubset(other
)
150 def __lt__(self
, other
):
152 Returns true if this set is less than another set.
154 symbols
= self
._xsymbols
([self
, other
])
155 islset1
= self
._toislset
(self
.polyhedra
, symbols
)
156 islset2
= self
._toislset
(other
.polyhedra
, symbols
)
157 equal
= bool(libisl
.isl_set_is_strict_subset(islset1
, islset2
))
158 libisl
.isl_set_free(islset1
)
159 libisl
.isl_set_free(islset2
)
162 def complement(self
):
164 Returns the complement of this set.
166 islset
= self
._toislset
(self
.polyhedra
, self
.symbols
)
167 islset
= libisl
.isl_set_complement(islset
)
168 return self
._fromislset
(islset
, self
.symbols
)
170 def __invert__(self
):
172 Returns the complement of this set.
174 return self
.complement()
178 Returns a set without redundant constraints.
180 islset
= self
._toislset
(self
.polyhedra
, self
.symbols
)
181 islset
= libisl
.isl_set_remove_redundancies(islset
)
182 return self
._fromislset
(islset
, self
.symbols
)
184 def aspolyhedron(self
):
186 Returns polyhedral hull of set.
188 from .polyhedra
import Polyhedron
189 islset
= self
._toislset
(self
.polyhedra
, self
.symbols
)
190 islbset
= libisl
.isl_set_polyhedral_hull(islset
)
191 return Polyhedron
._fromislbasicset
(islbset
, self
.symbols
)
196 def project(self
, dims
):
198 Return new set with given dimensions removed.
200 islset
= self
._toislset
(self
.polyhedra
, self
.symbols
)
202 for index
, symbol
in reversed(list(enumerate(self
.symbols
))):
206 islset
= libisl
.isl_set_project_out(islset
, libisl
.isl_dim_set
, index
+ 1, n
)
209 islset
= libisl
.isl_set_project_out(islset
, libisl
.isl_dim_set
, 0, n
)
210 dims
= [symbol
for symbol
in self
.symbols
if symbol
not in dims
]
211 return Domain
._fromislset
(islset
, dims
)
215 Returns a single subset of the input.
217 islset
= self
._toislset
(self
.polyhedra
, self
.symbols
)
218 islpoint
= libisl
.isl_set_sample_point(islset
)
219 if bool(libisl
.isl_point_is_void(islpoint
)):
220 libisl
.isl_point_free(islpoint
)
221 raise ValueError('domain must be non-empty')
223 for index
, symbol
in enumerate(self
.symbols
):
224 coordinate
= libisl
.isl_point_get_coordinate_val(islpoint
,
225 libisl
.isl_dim_set
, index
)
226 coordinate
= islhelper
.isl_val_to_int(coordinate
)
227 point
[symbol
] = coordinate
228 libisl
.isl_point_free(islpoint
)
231 def intersection(self
, *others
):
233 Return the intersection of two sets as a new set.
237 symbols
= self
._xsymbols
((self
,) + others
)
238 islset1
= self
._toislset
(self
.polyhedra
, symbols
)
240 islset2
= other
._toislset
(other
.polyhedra
, symbols
)
241 islset1
= libisl
.isl_set_intersect(islset1
, islset2
)
242 return self
._fromislset
(islset1
, symbols
)
244 def __and__(self
, other
):
246 Return the intersection of two sets as a new set.
248 return self
.intersection(other
)
250 def union(self
, *others
):
252 Return the union of sets as a new set.
256 symbols
= self
._xsymbols
((self
,) + others
)
257 islset1
= self
._toislset
(self
.polyhedra
, symbols
)
259 islset2
= other
._toislset
(other
.polyhedra
, symbols
)
260 islset1
= libisl
.isl_set_union(islset1
, islset2
)
261 return self
._fromislset
(islset1
, symbols
)
263 def __or__(self
, other
):
265 Return a new set with elements from both sets.
267 return self
.union(other
)
269 def __add__(self
, other
):
271 Return new set containing all elements in both sets.
273 return self
.union(other
)
275 def difference(self
, other
):
277 Return the difference of two sets as a new set.
279 symbols
= self
._xsymbols
([self
, other
])
280 islset1
= self
._toislset
(self
.polyhedra
, symbols
)
281 islset2
= other
._toislset
(other
.polyhedra
, symbols
)
282 islset
= libisl
.isl_set_subtract(islset1
, islset2
)
283 return self
._fromislset
(islset
, symbols
)
285 def __sub__(self
, other
):
287 Return the difference of two sets as a new set.
289 return self
.difference(other
)
293 Return a new set containing the lexicographic minimum of the elements in the set.
295 islset
= self
._toislset
(self
.polyhedra
, self
.symbols
)
296 islset
= libisl
.isl_set_lexmin(islset
)
297 return self
._fromislset
(islset
, self
.symbols
)
301 Return a new set containing the lexicographic maximum of the elements in the set.
303 islset
= self
._toislset
(self
.polyhedra
, self
.symbols
)
304 islset
= libisl
.isl_set_lexmax(islset
)
305 return self
._fromislset
(islset
, self
.symbols
)
308 def involves_vars(self
, vars):
310 Returns true if a set depends on given dimensions.
312 islset
= self
._toislset
(self
.polyhedra
, self
.symbols
)
314 symbols
= sorted(list(self
.symbols
))
319 first
= symbols
.index(dims
[0])
325 value
= bool(libisl
.isl_set_involves_dims(islset
, libisl
.isl_dim_set
, first
, n
))
326 libisl
.isl_set_free(islset
)
329 _RE_COORDINATE
= re
.compile(r
'\((?P<num>\-?\d+)\)(/(?P<den>\d+))?')
333 Return a list of vertices for this Polygon.
335 from .polyhedra
import Polyhedron
336 if not self
.isbounded():
337 raise ValueError('domain must be bounded')
338 islbset
= self
._toislbasicset
(self
.equalities
, self
.inequalities
, self
.symbols
)
339 vertices
= libisl
.isl_basic_set_compute_vertices(islbset
);
340 vertices
= islhelper
.isl_vertices_vertices(vertices
)
342 for vertex
in vertices
:
343 expr
= libisl
.isl_vertex_get_expr(vertex
)
345 if islhelper
.isl_version
< '0.13':
346 constraints
= islhelper
.isl_basic_set_constraints(expr
)
347 for constraint
in constraints
:
348 constant
= libisl
.isl_constraint_get_constant_val(constraint
)
349 constant
= islhelper
.isl_val_to_int(constant
)
350 for index
, symbol
in enumerate(self
.symbols
):
351 coefficient
= libisl
.isl_constraint_get_coefficient_val(constraint
,
352 libisl
.isl_dim_set
, index
)
353 coefficient
= islhelper
.isl_val_to_int(coefficient
)
355 coordinate
= -Fraction(constant
, coefficient
)
356 coordinates
.append((symbol
, coordinate
))
358 string
= islhelper
.isl_multi_aff_to_str(expr
)
359 matches
= self
._RE
_COORDINATE
.finditer(string
)
360 for symbol
, match
in zip(self
.symbols
, matches
):
361 numerator
= int(match
.group('num'))
362 denominator
= match
.group('den')
363 denominator
= 1 if denominator
is None else int(denominator
)
364 coordinate
= Fraction(numerator
, denominator
)
365 coordinates
.append((symbol
, coordinate
))
366 points
.append(Point(coordinates
))
371 Returns the points contained in the set.
373 if not self
.isbounded():
374 raise ValueError('domain must be bounded')
375 from .polyhedra
import Universe
, Eq
376 islset
= self
._toislset
(self
.polyhedra
, self
.symbols
)
377 islpoints
= islhelper
.isl_set_points(islset
)
379 for islpoint
in islpoints
:
381 for index
, symbol
in enumerate(self
.symbols
):
382 coordinate
= libisl
.isl_point_get_coordinate_val(islpoint
,
383 libisl
.isl_dim_set
, index
)
384 coordinate
= islhelper
.isl_val_to_int(coordinate
)
385 coordinates
[symbol
] = coordinate
386 points
.append(Point(coordinates
))
390 def _polygon_inner_point(cls
, points
):
391 symbols
= points
[0].symbols
392 coordinates
= {symbol
: 0 for symbol
in symbols
}
394 for symbol
, coordinate
in point
.coordinates():
395 coordinates
[symbol
] += coordinate
396 for symbol
in symbols
:
397 coordinates
[symbol
] /= len(points
)
398 return Point(coordinates
)
401 def _sort_polygon_2d(cls
, points
):
404 o
= cls
._polygon
_inner
_point
(points
)
408 dx
, dy
= (coordinate
for symbol
, coordinate
in om
.coordinates())
409 angle
= math
.atan2(dy
, dx
)
411 return sorted(points
, key
=angles
.get
)
414 def _sort_polygon_3d(cls
, points
):
417 o
= cls
._polygon
_inner
_point
(points
)
428 raise ValueError('degenerate polygon')
432 normprod
= norm_oa
* om
.norm()
433 cosinus
= max(oa
.dot(om
) / normprod
, -1.)
434 sinus
= u
.dot(oa
.cross(om
)) / normprod
435 angle
= math
.acos(cosinus
)
436 angle
= math
.copysign(angle
, sinus
)
438 return sorted(points
, key
=angles
.get
)
442 Returns the vertices of the faces of a polyhedra.
445 for polyhedron
in self
.polyhedra
:
446 vertices
= polyhedron
.vertices()
447 for constraint
in polyhedron
.constraints
:
449 for vertex
in vertices
:
450 if constraint
.subs(vertex
.coordinates()) == 0:
456 def _plot_2d(self
, plot
=None, **kwargs
):
457 import matplotlib
.pyplot
as plt
458 from matplotlib
.patches
import Polygon
461 plot
= fig
.add_subplot(1, 1, 1)
462 xmin
, xmax
= plot
.get_xlim()
463 ymin
, ymax
= plot
.get_ylim()
464 for polyhedron
in self
.polyhedra
:
465 vertices
= polyhedron
._sort
_polygon
_2d
(polyhedron
.vertices())
466 xys
= [tuple(vertex
.values()) for vertex
in vertices
]
468 xmin
, xmax
= min(xmin
, float(min(xs
))), max(xmax
, float(max(xs
)))
469 ymin
, ymax
= min(ymin
, float(min(ys
))), max(ymax
, float(max(ys
)))
470 plot
.add_patch(Polygon(xys
, closed
=True, **kwargs
))
471 plot
.set_xlim(xmin
, xmax
)
472 plot
.set_ylim(ymin
, ymax
)
475 def _plot_3d(self
, plot
=None, **kwargs
):
476 import matplotlib
.pyplot
as plt
477 from mpl_toolkits
.mplot3d
import Axes3D
478 from mpl_toolkits
.mplot3d
.art3d
import Poly3DCollection
484 xmin
, xmax
= axes
.get_xlim()
485 ymin
, ymax
= axes
.get_ylim()
486 zmin
, zmax
= axes
.get_zlim()
488 for vertices
in self
.faces():
489 vertices
= self
._sort
_polygon
_3d
(vertices
)
490 vertices
.append(vertices
[0])
491 face_xyzs
= [tuple(vertex
.values()) for vertex
in vertices
]
492 xs
, ys
, zs
= zip(*face_xyzs
)
493 xmin
, xmax
= min(xmin
, float(min(xs
))), max(xmax
, float(max(xs
)))
494 ymin
, ymax
= min(ymin
, float(min(ys
))), max(ymax
, float(max(ys
)))
495 zmin
, zmax
= min(zmin
, float(min(zs
))), max(zmax
, float(max(zs
)))
496 poly_xyzs
.append(face_xyzs
)
497 collection
= Poly3DCollection(poly_xyzs
, **kwargs
)
498 axes
.add_collection3d(collection
)
499 axes
.set_xlim(xmin
, xmax
)
500 axes
.set_ylim(ymin
, ymax
)
501 axes
.set_zlim(zmin
, zmax
)
505 def plot(self
, plot
=None, **kwargs
):
507 Display plot of this set.
509 if not self
.isbounded():
510 raise ValueError('domain must be bounded')
511 elif self
.dimension
== 2:
512 return self
._plot
_2d
(plot
=plot
, **kwargs
)
513 elif self
.dimension
== 3:
514 return self
._plot
_3d
(plot
=plot
, **kwargs
)
516 raise ValueError('polyhedron must be 2 or 3-dimensional')
518 def __contains__(self
, point
):
519 for polyhedron
in self
.polyhedra
:
520 if point
in polyhedron
:
524 def subs(self
, symbol
, expression
=None):
526 Subsitute the given value into an expression and return the resulting
529 polyhedra
= [polyhedron
.subs(symbol
, expression
)
530 for polyhedron
in self
.polyhedra
]
531 return Domain(*polyhedra
)
534 def _fromislset(cls
, islset
, symbols
):
535 from .polyhedra
import Polyhedron
536 islset
= libisl
.isl_set_remove_divs(islset
)
537 islbsets
= islhelper
.isl_set_basic_sets(islset
)
538 libisl
.isl_set_free(islset
)
540 for islbset
in islbsets
:
541 polyhedron
= Polyhedron
._fromislbasicset
(islbset
, symbols
)
542 polyhedra
.append(polyhedron
)
543 if len(polyhedra
) == 0:
544 from .polyhedra
import Empty
546 elif len(polyhedra
) == 1:
549 self
= object().__new
__(Domain
)
550 self
._polyhedra
= tuple(polyhedra
)
551 self
._symbols
= cls
._xsymbols
(polyhedra
)
552 self
._dimension
= len(self
._symbols
)
556 def _toislset(cls
, polyhedra
, symbols
):
557 polyhedron
= polyhedra
[0]
558 islbset
= polyhedron
._toislbasicset
(polyhedron
.equalities
,
559 polyhedron
.inequalities
, symbols
)
560 islset1
= libisl
.isl_set_from_basic_set(islbset
)
561 for polyhedron
in polyhedra
[1:]:
562 islbset
= polyhedron
._toislbasicset
(polyhedron
.equalities
,
563 polyhedron
.inequalities
, symbols
)
564 islset2
= libisl
.isl_set_from_basic_set(islbset
)
565 islset1
= libisl
.isl_set_union(islset1
, islset2
)
569 def _fromast(cls
, node
):
570 from .polyhedra
import Polyhedron
571 if isinstance(node
, ast
.Module
) and len(node
.body
) == 1:
572 return cls
._fromast
(node
.body
[0])
573 elif isinstance(node
, ast
.Expr
):
574 return cls
._fromast
(node
.value
)
575 elif isinstance(node
, ast
.UnaryOp
):
576 domain
= cls
._fromast
(node
.operand
)
577 if isinstance(node
.operand
, ast
.invert
):
579 elif isinstance(node
, ast
.BinOp
):
580 domain1
= cls
._fromast
(node
.left
)
581 domain2
= cls
._fromast
(node
.right
)
582 if isinstance(node
.op
, ast
.BitAnd
):
583 return And(domain1
, domain2
)
584 elif isinstance(node
.op
, ast
.BitOr
):
585 return Or(domain1
, domain2
)
586 elif isinstance(node
, ast
.Compare
):
589 left
= Expression
._fromast
(node
.left
)
590 for i
in range(len(node
.ops
)):
592 right
= Expression
._fromast
(node
.comparators
[i
])
593 if isinstance(op
, ast
.Lt
):
594 inequalities
.append(right
- left
- 1)
595 elif isinstance(op
, ast
.LtE
):
596 inequalities
.append(right
- left
)
597 elif isinstance(op
, ast
.Eq
):
598 equalities
.append(left
- right
)
599 elif isinstance(op
, ast
.GtE
):
600 inequalities
.append(left
- right
)
601 elif isinstance(op
, ast
.Gt
):
602 inequalities
.append(left
- right
- 1)
607 return Polyhedron(equalities
, inequalities
)
608 raise SyntaxError('invalid syntax')
610 _RE_BRACES
= re
.compile(r
'^\{\s*|\s*\}$')
611 _RE_EQ
= re
.compile(r
'([^<=>])=([^<=>])')
612 _RE_AND
= re
.compile(r
'\band\b|,|&&|/\\|∧|∩')
613 _RE_OR
= re
.compile(r
'\bor\b|;|\|\||\\/|∨|∪')
614 _RE_NOT
= re
.compile(r
'\bnot\b|!|¬')
615 _RE_NUM_VAR
= Expression
._RE
_NUM
_VAR
616 _RE_OPERATORS
= re
.compile(r
'(&|\||~)')
619 def fromstring(cls
, string
):
620 # remove curly brackets
621 string
= cls
._RE
_BRACES
.sub(r
'', string
)
622 # replace '=' by '=='
623 string
= cls
._RE
_EQ
.sub(r
'\1==\2', string
)
624 # replace 'and', 'or', 'not'
625 string
= cls
._RE
_AND
.sub(r
' & ', string
)
626 string
= cls
._RE
_OR
.sub(r
' | ', string
)
627 string
= cls
._RE
_NOT
.sub(r
' ~', string
)
628 # add implicit multiplication operators, e.g. '5x' -> '5*x'
629 string
= cls
._RE
_NUM
_VAR
.sub(r
'\1*\2', string
)
630 # add parentheses to force precedence
631 tokens
= cls
._RE
_OPERATORS
.split(string
)
632 for i
, token
in enumerate(tokens
):
634 token
= '({})'.format(token
)
636 string
= ''.join(tokens
)
637 tree
= ast
.parse(string
, 'eval')
638 return cls
._fromast
(tree
)
641 assert len(self
.polyhedra
) >= 2
642 strings
= [repr(polyhedron
) for polyhedron
in self
.polyhedra
]
643 return 'Or({})'.format(', '.join(strings
))
645 def _repr_latex_(self
):
647 for polyhedron
in self
.polyhedra
:
648 strings
.append('({})'.format(polyhedron
._repr
_latex
_().strip('$')))
649 return '${}$'.format(' \\vee '.join(strings
))
652 def fromsympy(cls
, expr
):
654 from .polyhedra
import Lt
, Le
, Eq
, Ne
, Ge
, Gt
656 sympy
.And
: And
, sympy
.Or
: Or
, sympy
.Not
: Not
,
657 sympy
.Lt
: Lt
, sympy
.Le
: Le
,
658 sympy
.Eq
: Eq
, sympy
.Ne
: Ne
,
659 sympy
.Ge
: Ge
, sympy
.Gt
: Gt
,
661 if expr
.func
in funcmap
:
662 args
= [Domain
.fromsympy(arg
) for arg
in expr
.args
]
663 return funcmap
[expr
.func
](*args
)
664 elif isinstance(expr
, sympy
.Expr
):
665 return Expression
.fromsympy(expr
)
666 raise ValueError('non-domain expression: {!r}'.format(expr
))
670 polyhedra
= [polyhedron
.tosympy() for polyhedron
in polyhedra
]
671 return sympy
.Or(*polyhedra
)
676 Return the intersection of two sets as a new set.
678 if len(domains
) == 0:
679 from .polyhedra
import Universe
682 return domains
[0].intersection(*domains
[1:])
686 Return the union of sets as a new set.
688 if len(domains
) == 0:
689 from .polyhedra
import Empty
692 return domains
[0].union(*domains
[1:])
696 Returns the complement of this set.