From a9fd5f3dbc3df191abf3c952ca2c06fd8b5c0b6e Mon Sep 17 00:00:00 2001 From: nwekealex65 <163132802+nwekealex65@users.noreply.github.com> Date: Fri, 15 Mar 2024 10:10:16 +0100 Subject: [PATCH 1/2] Update Docker-installation.md --- What does this PR do ? Fixed Typo in https://github.com/hotosm/fAIr/blob/master/docs/Docker-installation.md and enhanced the section for creating .env files This fixes issue #235 --- docs/Docker-installation.md | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/docs/Docker-installation.md b/docs/Docker-installation.md index 529793ec..b6f25eaf 100644 --- a/docs/Docker-installation.md +++ b/docs/Docker-installation.md @@ -26,7 +26,7 @@ Docker Compose is created with redis , worker , postgis database , api and fron nvidia-smi ``` -4. Clonse Base Model and Create RAMP_HOME +4. Clone Base Model and Create RAMP_HOME - Create a new folder called RAMP , outside fAIr @@ -72,7 +72,8 @@ Docker Compose is created with redis , worker , postgis database , api and fron - Check permissions for ```Read user preferences``` and Redirect URI to be ```http://127.0.0.1:3000/authenticate/``` , Give it name as ```fAIr Dev Local``` - You will get ```OSM_CLIENT_ID``` , ```OSM_CLIENT_SECRET``` Copy them -6. Create Env variables +6. Create Env variables + Backend - Create a file ```.env``` in backend with [docker_sample_env](../backend/docker_sample_env) content ``` cd backend @@ -82,14 +83,15 @@ Docker Compose is created with redis , worker , postgis database , api and fron Leave rest of the items as it is unless you know what you are doing - - Create ```.env``` in /frontend + Frontend + - Create ```.env``` file in /frontend ``` cd frontend cp .env_sample .env ``` You can leave it as it is for dev setup -7. Build & Run containers +8. Build & Run containers ``` docker compose build @@ -99,7 +101,7 @@ Docker Compose is created with redis , worker , postgis database , api and fron docker compose up ``` -8. Run Migrations +9. Run Migrations Run directly bash script : @@ -121,7 +123,7 @@ Docker Compose is created with redis , worker , postgis database , api and fron python manage.py makemigrations core python manage.py migrate -9. Play and Develop +10. Play and Develop Restart containers @@ -133,7 +135,7 @@ Docker Compose is created with redis , worker , postgis database , api and fron Please open the frontend using URL `127.0.0.1:3000` instead of `localhost:3000` to ensure login functionality. -10. Want to run your local tiles ? +11. Want to run your local tiles ? You can use [titler](https://github.com/developmentseed/titiler) , [gdals2tiles](https://gdal.org/programs/gdal2tiles.html) or nginx to run your own TMS server and add following to docker compose in order to access your localhost through docker containers . Add those to API and Worker . Make sure you update the .env variable accordingly @@ -185,4 +187,4 @@ Docker Compose is created with redis , worker , postgis database , api and fron DATABASE_URL=postgis://postgres:admin@localhost:5434/ai CELERY_BROKER_URL="redis://localhost:6379/0" CELERY_RESULT_BACKEND="redis://localhost:6379/0" - ``` \ No newline at end of file + ``` From 418486d4c4fbaff620b973f349e294713b20d316 Mon Sep 17 00:00:00 2001 From: nwekealex65 <163132802+nwekealex65@users.noreply.github.com> Date: Fri, 15 Mar 2024 13:40:12 +0100 Subject: [PATCH 2/2] docs: Update FAQ.md --- What does this PR do ? Updates FAQ.md with questions added by Petya from Hub session. This update Resolve #196 --- docs/FAQ.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/docs/FAQ.md b/docs/FAQ.md index e4bfea66..a6bf86a8 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -72,3 +72,32 @@ A : Absolutely! The fAIr project welcomes contributions related to new AI models **Q : What kind of support can I expect as a developer contributing to fAIr?** A : As a developer contributing to fAIr, you can receive support and guidance from the project maintainers and the community. The maintainers can help address technical questions, review your contributions, and provide feedback. The community also offers a collaborative environment where you can interact with other contributors and share knowledge. + +## Community Managers +**Q : Why can I only map buildings?** + +A : fAIr currently only works with buildings. We are hoping in the future to expand to other feature types. + +
+ +**Q : Can we edit with JSON in fAir?** + +A : Yes, that option is now available. + +
+ +**Q : If I map the same area but in another editor, will fAIr take into account this data?** + +A : Regardless of which editing tool you use, once it goes into OSM, it will be taken into fAIr as long as you click “fetch OSM” after they map + +
+ +**Q : If I map a little outside the task, selected AOI, is the data also fed into fAIr? Or is it ignored?** + +A : Anything that intersects with the AOI boundary is needed and will be counted in fAIr training data, buildings fully outside the boundary won’t be counted for training dataset but they are already in OSM + +
+ +**Q : I don’t remember what to do when I’m finished, just “fetch”?** + +A : Yes, after mapping the selected AOI, you should come back to fAIr and fetch so you will see them in fAIr.