Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Area of Interest ==> Training Area #214

Open
Ettrig opened this issue Feb 6, 2024 · 1 comment
Open

Area of Interest ==> Training Area #214

Ettrig opened this issue Feb 6, 2024 · 1 comment
Labels
component : frontend documentation Improvements or additions to documentation good first issue Issues that welcome contributions

Comments

@Ettrig
Copy link
Contributor

Ettrig commented Feb 6, 2024

The expression AOI is not informative as it is used in fAIr. Since it is used so many times, the user will understand the meaning eventually. But a more informative expression would help the user understand how fAIr works.

An AOI is an area from which data is generated to be used for complementary (fine-tuning) training of the model. The central word here is training. The AOI should be called Training Area (TA).

There is a concrete problem with the expression AOI. It is used in the same context with another meaing. In the manual for people who create projects in TA, the AOI is the whole area to be mapped. It would be better to call it Area to be Mapped. But at least it is not wrong. And this is the given background for us.

AOI is misleading. The user is not interested. fAIr is not particularly interested. It is important that the Training Area is representative. This means that we want there to be nothing special with the Training areas. We want the buildings here to be just like the the vast majority of the other buildings (for now) in the area to be mapped (using this model). So we do not want the user to choose interesting areas, but boring areas.

Here is a sentence where it is used: "A dataset would be a list of area of interests (AIOs) and its labels." Notice how an important concept is introduced using "AOI" and "label" to convey the meaning. But AOI is used to refer to a concept that we have invented and label is used with a meaning that is a deep implementation detail in CNNs. To sort this out we need to distinguish at least three different things.

  1. The real area, a part of the surface of the Earth.
  2. An image of that area.
  3. The OSM description of that area.

In the sentence above, it sounds like 1) is intended. That is, that is what one would think if one didn't know what you mean. That is, if one needs this explanation. Rewrite:

"A training dataset is a set of images of areas of interest (AOIs) and corresponding OSM map data."

Or, if I can persuade you to let go of this use of AOI:

"A training dataset is a set of images of training areas (TAs) and corresponding OSM map data."

@Ettrig Ettrig added the bug Something isn't working label Feb 6, 2024
@kshitijrajsharma kshitijrajsharma added documentation Improvements or additions to documentation good first issue Issues that welcome contributions component : frontend and removed bug Something isn't working labels Feb 13, 2024
@omranlm
Copy link
Contributor

omranlm commented May 27, 2024

I think is is already done, right? @kshitijrajsharma @Ettrig

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
component : frontend documentation Improvements or additions to documentation good first issue Issues that welcome contributions
Projects
None yet
Development

No branches or pull requests

3 participants