# Match by Object

### Description
Both inputs `A [OBJ,OBJ]` and `B [OBJ,OBJ]` contain pairs `[candidate, evidence]`.
The block compares the `evidence` columns from the inputs and return as matches the corresponding `candidate` objects.

Optional input `Cands [OBJ,OBJ]` can limit the matching to only the pairs of candidates listed.
- The first column corresponds to the `candidate` column of `A`.
- The second column corresponds to the `candidate` column of `B`.
- Scores are propagated to final matches.

Optional input `Evidence [OBJ,OBJ]` can limit the comparison to only the pairs of evidence listed.
- The first column corresponds to the `evidence` column of `A`.
- The second column corresponds to the `evidence` column of `B`.
- Scores are propagated to final matches.

### Input
- `A [OBJ,OBJ]`: a list of `[candidate, evidence]` pairs, in which the `evidence` column will be used for comparison and the `candidate` column will be the result
- `Cands [OBJ,OBJ]` (optional) : candidate pairs, only `candidate` columns of `A` and `B` that are in `Cands` will be matched
- `Evidence [OBJ,OBJ]` (optional) : evidence pairs, only `evidence` columns of `A` and `B` that are in `Evidence` will be compared
- `B [OBJ,OBJ]`: a list of `[candidate, evidence]` pairs, in which the `evidence` column will be used for comparison and the `candidate` column will be the result

### Output
- `RESULT [OBJ,OBJ]`: the matched `candidate` items from `A` and `B`
- `NOTA [OBJ]`: the `candidate` items from `A` that did not match with an item from `B`
- `NOTB [OBJ]`: the `candidate` items from `B` that did not match with an item from `A`

### Parameters
- `Exclude self-matches`: whether to emit the match if the objects in `A` and `B` are the same. Mostly useful when `A` and `B` come from the same source