isconvex

ISCONVEX Checks if a polytope array forms a convex union

 [status, Pconv] = isconvex(P)
 [status, Pconv] = isconvex(P,Options)

 ---------------------------------------------------------------------------
 DESCRIPTION
 ---------------------------------------------------------------------------
 STATUS = ISCONVEX(P) returns TRUE (1) if a given polytope array P is convex

 ---------------------------------------------------------------------------
 INPUT
 ---------------------------------------------------------------------------
 P                - polytope array
 Options.usehull  - if set to 1 (default is 0), uses convex hulls instead of
                    convex envelopes to detect convexity

 Note: If Options is missing or some of the fields are not defined, the default
       values from mptOptions will be used

 ---------------------------------------------------------------------------
 OUTPUT                                                                                                    
 ---------------------------------------------------------------------------
 status           - Logical statement
 Pconv            - if P is convex it returns the convex set, otherwise 
                    an empty polytope