Up: Component summary
Up: Component summary
Component
MaskRelateRelates objects from two masks defining parents and their children objects. Children that ovelap with a parent object are given a number to refer to the parent. Children without parents get 0 value as the parent. As a default, children overlapping with multiple parents get the parent with most overlapping pixels. The value is 0 if most overlap is with no parent. In the output, you will find the relative areas of intersection to parent, child, and union objects.
| Version | 1.2 |
|---|---|
| Bundle | anima |
| Categories | Image Analysis |
| Authors | Ville Rantanen (ville.rantanen@helsinki.fi) |
| Issue tracker | View/Report issues |
| Requires | Matlab |
| Source files | component.xml maskrelate.m maskrelate_single.m execute.m |
| Usage | Example with default values |
Inputs| Name | Type | Mandatory | Description |
|---|---|---|---|
| parent | ImageList | Mandatory | A directory with BW mask image files working as the parent objects. |
| child | ImageList | Mandatory | A directory with BW mask image files working as the child objects. |
| names | ImageList | Optional | A directory with the original image files, for naming the table. If omitted, names from "dir" are used. |
Outputs| Name | Type | Description |
|---|---|---|
| out | CSV | List of relation values. |
| overlap | ImageList | Visualization of the parent-child relation. |
Parameters| Name | Type | Default | Description |
|---|---|---|---|
| emptyParents | boolean | true | Add a 0 child for each parent that has no children at the end of table. |
| method | string | "Most" | Method to solve children overlapping the edge of parent. Child may overlap with several parents, or with background. Methods to use: Most will select the parent with most overlap. Discard will set the parent 0 at any overlap situation. Any will select non-zero parent with most overlap. |
Test cases| Test case | Parameters▼ | IN parent |
IN child |
IN names |
OUT out |
OUT overlap |
|---|---|---|---|---|---|---|
| case1_normal | properties | parent | child | (missing) | out | overlap |
| case2_inverted | properties | parent | child | (missing) | out | overlap |
| case3_discard | properties | parent | child | (missing) | out | overlap |
|
method=Discard, |
||||||
| case4_any | properties | parent | child | (missing) | out | overlap |
|
method=Any |
||||||
| case5_inverted_any | properties | parent | child | (missing) | out | overlap |
|
method=Any |
||||||
| case6_origdir | properties | parent | child | names | out | overlap |