diff options
Diffstat (limited to 'subprojects/viatra-runtime/src/main/java/tools/refinery/viatra/runtime/matchers/psystem/IRelationEvaluator.java')
-rw-r--r-- | subprojects/viatra-runtime/src/main/java/tools/refinery/viatra/runtime/matchers/psystem/IRelationEvaluator.java | 47 |
1 files changed, 47 insertions, 0 deletions
diff --git a/subprojects/viatra-runtime/src/main/java/tools/refinery/viatra/runtime/matchers/psystem/IRelationEvaluator.java b/subprojects/viatra-runtime/src/main/java/tools/refinery/viatra/runtime/matchers/psystem/IRelationEvaluator.java new file mode 100644 index 00000000..e4c396d8 --- /dev/null +++ b/subprojects/viatra-runtime/src/main/java/tools/refinery/viatra/runtime/matchers/psystem/IRelationEvaluator.java | |||
@@ -0,0 +1,47 @@ | |||
1 | /******************************************************************************* | ||
2 | * Copyright (c) 2010-2022, Tamas Szabo, GitHub | ||
3 | * This program and the accompanying materials are made available under the | ||
4 | * terms of the Eclipse Public License v. 2.0 which is available at | ||
5 | * http://www.eclipse.org/legal/epl-v20.html. | ||
6 | * | ||
7 | * SPDX-License-Identifier: EPL-2.0 | ||
8 | *******************************************************************************/ | ||
9 | package tools.refinery.viatra.runtime.matchers.psystem; | ||
10 | |||
11 | import java.util.List; | ||
12 | import java.util.Set; | ||
13 | |||
14 | import tools.refinery.viatra.runtime.matchers.tuple.Tuple; | ||
15 | |||
16 | /** | ||
17 | * Implementations of this interface take an arbitrary number of input relations with their contents and compute the | ||
18 | * tuples of a single output relation. | ||
19 | * | ||
20 | * @author Tamas Szabo | ||
21 | * @since 2.8 | ||
22 | * | ||
23 | */ | ||
24 | public interface IRelationEvaluator { | ||
25 | |||
26 | /** | ||
27 | * A textual description of the evaluator. Used only for debug purposes, but must not be null. | ||
28 | */ | ||
29 | String getShortDescription(); | ||
30 | |||
31 | /** | ||
32 | * The relation evaluator code. For performance reasons, it is expected that the returned set is a mutable | ||
33 | * collection, and the caller must be allowed to actually perform mutations! | ||
34 | */ | ||
35 | Set<Tuple> evaluateRelation(List<Set<Tuple>> inputs) throws Exception; | ||
36 | |||
37 | /** | ||
38 | * For each input relation that this evaluator requires, this method returns the expected arities of the relations in order. | ||
39 | */ | ||
40 | List<Integer> getInputArities(); | ||
41 | |||
42 | /** | ||
43 | * Returns the arity of the output relation that this evaluator computes. | ||
44 | */ | ||
45 | int getOutputArity(); | ||
46 | |||
47 | } | ||