1 | /*
|
---|
2 | * Licensed to the Apache Software Foundation (ASF) under one or more
|
---|
3 | * contributor license agreements. See the NOTICE file distributed with
|
---|
4 | * this work for additional information regarding copyright ownership.
|
---|
5 | * The ASF licenses this file to You under the Apache License, Version 2.0
|
---|
6 | * (the "License"); you may not use this file except in compliance with
|
---|
7 | * the License. You may obtain a copy of the License at
|
---|
8 | *
|
---|
9 | * http://www.apache.org/licenses/LICENSE-2.0
|
---|
10 | *
|
---|
11 | * Unless required by applicable law or agreed to in writing, software
|
---|
12 | * distributed under the License is distributed on an "AS IS" BASIS,
|
---|
13 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
---|
14 | * See the License for the specific language governing permissions and
|
---|
15 | * limitations under the License.
|
---|
16 | */
|
---|
17 | package agents.anac.y2019.harddealer.math3.geometry.hull;
|
---|
18 |
|
---|
19 | import java.io.Serializable;
|
---|
20 |
|
---|
21 | import agents.anac.y2019.harddealer.math3.exception.InsufficientDataException;
|
---|
22 | import agents.anac.y2019.harddealer.math3.geometry.Point;
|
---|
23 | import agents.anac.y2019.harddealer.math3.geometry.Space;
|
---|
24 | import agents.anac.y2019.harddealer.math3.geometry.partitioning.Region;
|
---|
25 |
|
---|
26 | /**
|
---|
27 | * This class represents a convex hull.
|
---|
28 | *
|
---|
29 | * @param <S> Space type.
|
---|
30 | * @param <P> Point type.
|
---|
31 | * @since 3.3
|
---|
32 | */
|
---|
33 | public interface ConvexHull<S extends Space, P extends Point<S>> extends Serializable {
|
---|
34 |
|
---|
35 | /**
|
---|
36 | * Get the vertices of the convex hull.
|
---|
37 | * @return vertices of the convex hull
|
---|
38 | */
|
---|
39 | P[] getVertices();
|
---|
40 |
|
---|
41 | /**
|
---|
42 | * Returns a new region that is enclosed by the convex hull.
|
---|
43 | * @return the region enclosed by the convex hull
|
---|
44 | * @throws InsufficientDataException if the number of vertices is not enough to
|
---|
45 | * build a region in the respective space
|
---|
46 | */
|
---|
47 | Region<S> createRegion() throws InsufficientDataException;
|
---|
48 | }
|
---|