Skip to content
This repository was archived by the owner on Aug 27, 2019. It is now read-only.
This repository was archived by the owner on Aug 27, 2019. It is now read-only.

Improve documentation about rectangular clustering - which rectangles get merged and which don't #143

Description

@alexbfree

http://zooniverse-aggregation.readthedocs.org/en/latest/rectangle_aggregation.html is a good start, but for me it leaves a lot of questions:

“referring to the same thing”
It's not clear to me how the aggregation code can tell whether rectangles are referring to the same thing or not. I think it would be good to add an example where there are 3 distinct regions on the subject - two of which overlap.
this would let you talk about the easy case (non-overlapping entity where all rectangles refer to the same thing) and the harder case (two overlapping entities, each of which with their own collection of rectangles).

I think it's important in the writing to distinguish between the multiplicity of rectangles due to one person marking several areas, vs the multiplicity of rectangles for many people each drawing one rectangle pertaining to a particular region... It's not always clear which you are talking about.

I think a photographic example might make this clearer.
For example:
asg0018jt5
which aggregates to
asg0018jt5
(this is subject 1925322 in Snapshot Serengeti: Computer Vision)
If you used an example like this, that could help make it clearer between overlapping animals and overlapping rectangles.

the triangle
It's really hard to follow how this triangle relates to the rectangle diagram above. I think this could be spelled out a bit, to make the page flow better.

general context of this page
this page isn't very clear about what the general technique being described is. It uses the phrase "clustering rectangles" without really explaining what that means. For example, are we talking about identifying which rectangles should be merged for a single cluster? Or are we talking about identifying several clusters from many rectangles? Are we talking about overlapping opinions or overlapping entities (or both)? All of the above? Maybe break it down into the separate aims/challenges, and how each one is being tackled...

ending
The page ends rather abruptly. It would be good to have some sort of conclusion - the final bit about cliques feels a bit of non-sequitur without saying what that actually means or referring back to the context of the problem in hand.

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions