Skip to content

Commit e312442

Browse files
committed
data table
1 parent 373832e commit e312442

File tree

1 file changed

+35
-35
lines changed

1 file changed

+35
-35
lines changed

docs/source/data.md

Lines changed: 35 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -10,24 +10,24 @@ Files:
1010

1111
Attributes:
1212

13-
| Name | Type | Description |
14-
| ---- | ---- | ----------- |
15-
| idx | integer | - |
16-
| project_id | string | The ID of the project used in Firebase. |
17-
| name | string | The name of the project as displayed in the app. For newer projects this will be a composition of project topic, project region and project number. |
18-
| project_details | string | The project description. This is displayed in the app on the project page. |
19-
| look_for | string | What should the users look for (e.g. buildings, cars, trees)? |
20-
| project_type | integer | The type of the project. 1=BuildArea, 2=Footprint, 3=ChangeDetection, 4=Completeness |
21-
| tile_server_names | string | The names of the satellite imagery providers used for this project. Some projects, e.g. Change Detection Type projects, have multiple tile server names. |
22-
| status | string | The status of the project defines if the project is visible in the app. There are the following values: active, inactive, finished, archived. Archived projects can not be set to active again. |
23-
| area_sqkm | float | The size of the project area in square kilometers. |
24-
| geom | string | The geometry of the project region as WKT geometry. |
25-
| centroid | string | The centroid of the project geometry as WKT geometry. |
26-
| progress | float | The mapping progress of the project. 1.0=completed. |
27-
| number_of_users | integer | The number of distinct users who contributed to this project. |
28-
| number_of_results | integer | The total number of results for all tasks. |
13+
| Name | Type | Description |
14+
|----------------------------|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
15+
| idx | integer | - |
16+
| project_id | string | The ID of the project used in Firebase. |
17+
| name | string | The name of the project as displayed in the app. For newer projects this will be a composition of project topic, project region and project number. |
18+
| project_details | string | The project description. This is displayed in the app on the project page. |
19+
| look_for | string | What should the users look for (e.g. buildings, cars, trees)? |
20+
| project_type | integer | The type of the project. 1=BuildArea, 2=Footprint, 3=ChangeDetection, 4=Completeness |
21+
| tile_server_names | string | The names of the satellite imagery providers used for this project. Some projects, e.g. Change Detection Type projects, have multiple tile server names. |
22+
| status | string | The status of the project defines if the project is visible in the app. There are the following values: active, inactive, finished, archived. Archived projects can not be set to active again. |
23+
| area_sqkm | float | The size of the project area in square kilometers. |
24+
| geom | string | The geometry of the project region as WKT geometry. |
25+
| centroid | string | The centroid of the project geometry as WKT geometry. |
26+
| progress | float | The mapping progress of the project. 1.0=completed. |
27+
| number_of_users | integer | The number of distinct users who contributed to this project. |
28+
| number_of_results | integer | The total number of results for all tasks. |
2929
| number_of_results_progress | integer | The number of results that are taken into account for the progress calculation. If a tasks has been mapped more often than required, usually 3-times, the additional results are not considered for the progress calculation. |
30-
| day | string | The date when the project information was updated the last time. |
30+
| day | string | The date when the project information was updated the last time. |
3131

3232

3333
## Aggregated Results
@@ -37,21 +37,21 @@ Files:
3737
- `aggregated_results_{project_id}.csv`, e.g. [agg\_results\_-M56eeMCZ5VeOHjJN4Bx.csv](https://apps.mapswipe.org/api/agg_results/agg_results_-M56eeMCZ5VeOHjJN4Bx.csv)
3838
- `aggregated_results_{project_id}.geojson`, e.g. [agg\_results\_-M56eeMCZ5VeOHjJN4Bx.geojson](https://apps.mapswipe.org/api/agg_results/agg_results_-M56eeMCZ5VeOHjJN4Bx.geojson)
3939

40-
| Name | Type | Description |
41-
| ---- | ---- | ----------- |
42-
| idx | integer | - |
43-
| task_id | string | The ID of the task, for BuildArea projects this is a composition of `TileZ-TileX-TileY` |
44-
| 0_count | integer | The number of users who marked this task as 0, e.g. "no building" for BuildArea Project Type. |
45-
| 1_count | integer | The number of users who marked this task as 1, e.g. "building" for BuildArea Project Type. |
46-
| 2_count | integer | The number of users who marked this task as 2, e.g. "maybe" for BuildArea Project Type. |
47-
| 3_count | integer | The number of users who marked this task as 3, e.g. "bad imagery" for BuildArea Project Type. |
48-
| total_count | integer | The total number of users who mapped this task. |
49-
| 0_share | float | 0_count divived by total_count. This gives you the share of all users who marked as 0. |
50-
| 1_share | float | 1_count divived by total_count. This gives you the share of all users who marked as 1. |
51-
| 2_share | float | 2_count divived by total_count. This gives you the share of all users who marked as 2. |
52-
| 3_share | float | 3_count divived by total_count. This gives you the share of all users who marked as 3. |
53-
| agreement | float | This is defined as [Scott's Pi](https://en.wikipedia.org/wiki/Scott%27s_Pi) and gives you an understanding of inter-rater reliability. The value is 1.0 if all users agree, e.g. all users classify as "building". If users disagree this value will be lower. |
54-
| geom | string | The geometry of this task as WKT geometry. |
40+
| Name | Type | Description |
41+
|-------------|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
42+
| idx | integer | - |
43+
| task_id | string | The ID of the task, for BuildArea projects this is a composition of `TileZ-TileX-TileY` |
44+
| 0_count | integer | The number of users who marked this task as 0, e.g. "no building" for BuildArea Project Type. |
45+
| 1_count | integer | The number of users who marked this task as 1, e.g. "building" for BuildArea Project Type. |
46+
| 2_count | integer | The number of users who marked this task as 2, e.g. "maybe" for BuildArea Project Type. |
47+
| 3_count | integer | The number of users who marked this task as 3, e.g. "bad imagery" for BuildArea Project Type. |
48+
| total_count | integer | The total number of users who mapped this task. |
49+
| 0_share | float | 0_count divived by total_count. This gives you the share of all users who marked as 0. |
50+
| 1_share | float | 1_count divived by total_count. This gives you the share of all users who marked as 1. |
51+
| 2_share | float | 2_count divived by total_count. This gives you the share of all users who marked as 2. |
52+
| 3_share | float | 3_count divived by total_count. This gives you the share of all users who marked as 3. |
53+
| agreement | float | This is defined as [Scott's Pi](https://en.wikipedia.org/wiki/Scott%27s_Pi) and gives you an understanding of inter-rater reliability. The value is 1.0 if all users agree, e.g. all users classify as "building". If users disagree this value will be lower. |
54+
| geom | string | The geometry of this task as WKT geometry. |
5555

5656
Additionally, project type specific data can be found here. E.g. footprint projects which were created based on OSM data, will have data describing the original OSM object included.
5757

@@ -64,9 +64,9 @@ Currently, the geometries in this dataset consist of maximum 15 MapSwipe Tasks,
6464
Files:
6565
- `hot_tm_{project_id}.geojson`, e.g. [hot\_tm\_-M56eeMCZ5VeOHjJN4Bx.geojson](https://apps.mapswipe.org/api/hot_tm/hot_tm_-M56eeMCZ5VeOHjJN4Bx.geojson)
6666

67-
| Name | Type | Description |
68-
| ---- | ---- | ----------- |
69-
| group_id | integer | A ID for the geometry. It has no connection to the MapSwipe data model. |
67+
| Name | Type | Description |
68+
|----------|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
69+
| group_id | integer | A ID for the geometry. It has no connection to the MapSwipe data model. |
7070
| geometry | geometry | A polygon geometry representing the selected MapSwipe tasks. In our GIS workflow we further aggregate and simplify the geometry, hence they kind of look like easter eggs. |
7171

7272
<img src="_static/img/tasking_manager_geometries_example.png" width="600px">

0 commit comments

Comments
 (0)