Spaces:
Running
Download docs/running-environment.md from tkadkghdlf/CD: direct link, hf CLI and curl.
- Browser
- Download file 6.95 kB
-
https://huggingface.co/spaces/tkadkghdlf/CD/resolve/main/docs/running-environment.md
- Command line
-
hf download hf://spaces/tkadkghdlf/CD/docs/running-environment.md
-
curl -L -o running-environment.md https://huggingface.co/spaces/tkadkghdlf/CD/resolve/main/docs/running-environment.md
๋ฌ๋ ํ๊ฒฝ ์ ์
์ถ์ฒ ๊ฒฐ๊ณผ์ AI ์ํ์ ์ ์๊ฐ ๋์ ์์ผ๋ก ์ ๋ ฌํ๋ค. ์๋ ์์๋ ์ถ์ฒ ์ ์ ๋๋ฅ ์, ์ง๋ ์ค์ฌ๊น์ง์ ๊ฑฐ๋ฆฌ๋ ์ํ ์ ์ ๋๋ฅ ์ ์ฌ์ฉํ๋ค. ์ ์์ ์ถ์ฒ ์์๋ ๊ฒฝ๋ก ID๋ฅผ ๋ฐ๊พธ์ง ์๋๋ค.
- ๋ณดํ๋ก ๊ตฌ์กฐ 25%, ์ง์ญ ์ธ๊ตฌ ํผ์ก๋ 45%, ์ฑ ํ๋ 30%. ๊ฒฝ๋ก๋ฅผ ๊ฑฐ๋ฆฌ ๊ธฐ์ค์ผ๋ก ์ํ๋งํ๋ค.
- ๋น์ด ์๋ ์ ํธ๋ ์ค๋ฆฝ๊ฐ์ด๋ฉฐ ํ์ฐํ๋ค๋ ์ฆ๊ฑฐ๊ฐ ์๋๋ค. ์ ๋ถ ๋น์ด ์์ผ๋ฉด
์๋ฃ ๋ถ์กฑ. - ํ๋ ์ง๊ณ๊ฐ ์ ์ ์๋ตํ์ ๋์ 0๋ช ์ ์๋น์ค ์ด์ฉ์ ํ๋์๋ง ๋ฐ์ํ๋ฉฐ ์ผ๋ฐ ๋ณดํ ์ธ๊ตฌ์๋ ๋ฐ์ํ์ง ์๋๋ค.
- ์ค์๊ฐ ์ธ๊ตฌ๋ ๊ณต์ POI ์์ญ๊ณผ ๊ต์ฐจํ๋ ๋ถ๋ถ๋ง ์ฌ์ฉํ๋ค. ์์ธ์ API๊ฐ 20๋ถ ๋๊ฒ ์ค๋๋๊ฑฐ๋, ๋์ฒด๊ฐ์ด๊ฑฐ๋, ์คํจํ๋ฉด ๋ฐ์ํ์ง ์๋๋ค. ์๊ฐ๋๋ณ ์๋ฃ๊ฐ ์๋ ๊ตฌ๊ฐ์ ๋ณ๋๋ก ์ถ์ ํ๋ค.
- ์ฑ ํ๋์ ์ต๊ทผ 2๋ถ ์ด๋ด์ ์ ์ฅ๋๊ณ GPS ๊ฒฝ๋ก๊ฐ ์๋ ์งํ ์ค ์ค์ ๋ฌ๋๋ง ํฌํจํ๋ค. ์๋ฎฌ๋ ์ด์ , ์ผ์์ ์ง, ์ข ๋ฃ๋ ์ ์ธํ๋ค. ์ฃผ๋ณ ๊ตฌ์ญ์ ์์ ์ธ์์ด ์์ผ๋ฉด ์กด์ฌ ์ฌ๋ถ๋ง ํ์ํ๊ณ , ์ธ์์๋ ๊ตฌ์ญ๋น 3๋ช ์ด์์ธ ์ง๊ณ๋ง ํฉ์ฐํ๋ค. ๋ธ๋ผ์ฐ์ ์๋ ์์น๋ ๊ตฌ์ญ ๋ชฉ๋ก์ ๋ฐํํ์ง ์๋๋ค.
- ์ด ์ ์๋ ์ถ์ฒ ์์์ฉ์ด๋ฉฐ ํตํ ๊ฐ๋ฅ ์ฌ๋ถ๋ ์์ ์ ์ธ์ฆํ์ง ์๋๋ค.
Hugging Face ๋ฐฐํฌ
GitHub์ DemoService ๋ธ๋์น ํธ์๋ Space ๋๊ธฐํ๋ฅผ ์์ํ๋ค. Docker ๋น๋๋ Geofabrik์
๋ํ๋ฏผ๊ตญ OSM์์ ๋๋ก ์ธ๋ฑ์ค๋ฅผ ๋ง๋ ๋ค. ๊ธฐ๋ณธ๊ฐ์ /app/running-environment์ด๋ฉฐ
RUN_ENV_DATA_DIR๋ก ๋ค๋ฅธ ์ธ๋ฑ์ค๋ฅผ ์ง์ ํ ์ ์๋ค. ํผ์ก๋ ํ๋กํ์ ์ํธํ๋ ๋ฌถ์์ผ๋ก๋ง
๋ฐฐํฌํ๋ฉฐ GitHub Secrets์ RUN_ENV_PROFILE_KEY, RUN_ENV_SEOUL_API_KEY๋ Space Secret์ผ๋ก ์ ๋ฌ๋๋ค.
๋ด๋ถ ํ๋ ์ง๊ณ ํค๋ ์ปจํ
์ด๋ ์์ ์ ์์ฑํ๋ฉฐ ์ธ์ฆ ์๋ฒ์ Next๊ฐ ๊ณต์ ํ๋ค.
์ธ๋ฑ์ค๋ ํค๊ฐ ์์ผ๋ฉด ํด๋น ์ ํธ๋ง ์๋ฃ ๋ถ์กฑ์ผ๋ก ์ฒ๋ฆฌํ๋ค.
๊ฐ์ ธ์ค๊ธฐ
- ๋ํ๋ฏผ๊ตญ OSM PBF๋ฅผ ๋ค์ด๋ก๋ํ๋ค.
- ๊ตญํ ์ ๋ณดํ๋ซํผ์์ ์์น์งํ๋ ๋์ฝ์ ๋ฐ์ ํ์ํ ๋ ์ด์ด๋ฅผ
SHP ๋๋ WGS84 GeoJSON์ผ๋ก ์ค๋นํ๋ค.
sidewalk-1000,sidewalk-5000,road-width,carriageway์ ๊ฐ๊ฐ ๋์ํ๋ค. ์๋ ํ๋๋ช ์ ์์๋ค. ๋์ฝ์ ์กฐ์ฌ์ฐ๋์ ์ด์ฉ์กฐ๊ฑด์ ํ์ธํ ํ ๋ฃ๊ณ , ๊ฐ์ ์ง์ญ์ ๊ตฌ๋ฒ์ ๊ณผ ์ ๋ฒ์ ์ ์ค๋ณต ํฌ์ ํ์ง ์๋๋ค. - ์์ธ ์ค์๊ฐ ๋์๋ฐ์ดํฐ์
์ฃผ์ 121์ฅ์ ์์ญ ZIP์ ํ๊ณ SHP์
AREA_CDํ๋๋ฅผ ์ฌ์ฉํ๋ค.
python -m pip install osmium geopandas
python tools/import_running_environment.py --out D:/data/run-env-v1 --osm D:/data/south-korea.osm.pbf --roads sidewalk-1000 D:/data/sidewalk.shp WIDTH SURFACE --seoul-areas D:/data/seoul-areas.shp AREA_CD
--roads๋ ์ฌ๋ฌ ๋ฒ ์ง์ ํ ์ ์๊ณ --seoul-areas๋ ์ ํ ์ฌํญ์ด๋ค.
OSM๋ง ๋จผ์ ๊ฐ์ ธ์ฌ ์ ์๋ค. ์ฐจ๋๋ ๋๋ก ์ ์ฒด์ ํญ์ ๋ณด๋ ํญ์ผ๋ก ์ฝ์ง ์๋๋ค.
์ ๋ฒ์ ์ ๋น ํด๋์ ์์ฑํ ๋ค ๊ฒฝ๋ก๋ฅผ ๋ฐ๊ฟ Next ์๋ฒ๋ฅผ ์ฌ์์ํ๋ค.
๋ก์ปฌ ์คํ
Next ํ๋ก์ธ์ค์ ๋ค์ ๋ณ์๋ฅผ ์ค์ ํ ํ main์์ npm run dev๋ฅผ ์คํํ๋ค.
RUN_ENV_DATA_DIR: ์์ฑ๋ ์ธ๋ฑ์ค์ ์ ๋ ๊ฒฝ๋ก.RUN_ENV_SEOUL_API_KEY: ๋ฐ๊ธ๋ฐ์ ์๋ฒ์ฉ ์์ธ์ API ํค.sample์ ๊ดํ๋ฌธยท๋์๊ถ ํ ๊ณณ๋ง ๊ฒ์ฆ ๊ฐ๋ฅ.RUN_ENV_INTERNAL_KEY: Next์ ๋ก์ปฌ auth-service์ ๊ฐ์ ์์์ ๊ธด ๋น๋ฐ๊ฐ์ ์ค์ ํ๋ค. Docker Compose๋ก auth-service๋ฅผ ๋์ฐ๋ ๊ฒฝ์ฐ Compose ์คํ ํ๊ฒฝ์๋ ๊ฐ์ ๊ฐ์ ์ ๊ณตํ๋ค.NEXT_INTERNAL_API_PROXY_TARGET: ๋ก์ปฌ API Gateway ์ฃผ์ (๊ธฐ๋ณธhttp://localhost:8000).
๋น๋ฐ๊ฐ๊ณผ ์๋ณธ ์ธ๋ฑ์ค๋ ์ ์ฅ์์ ์ปค๋ฐํ์ง ์๋๋ค. ์์ธ์ API๋ ๊ณต์ ์์ ์ ๊ฐ์ HTTP ํฌํธ 8088์ ์ฌ์ฉํ๋ค. ํค๋ ์๋ฒ์์๋ง ์ฌ์ฉํ๋ฉฐ, ์ด ์ธ๋ถ ์ฐ๊ฒฐ์๋ TLS๊ฐ ์ ์ฉ๋์ง ์๋๋ค. ์ ๊ตญ OSM์ ์ด๋ค๋ ๊ฒ์ ์ ๊ตญ์ ๋์ผํ ํญ/๋ณด๋ ๋ฐ์ดํฐ๊ฐ ์๋ค๋ ๋ป์ด ์๋๋ค. OpenStreetMap ยฉ OpenStreetMap contributors (ODbL).
์ง์ญ๋ณ ๊ณผ๊ฑฐ ํผ์ก๋
์ค์๊ฐ ๊ฐ์ด ์๋ ๊ฒฝ๋ก ์ง์ ์ ํ๊ตญ ์๊ฐ ๊ธฐ์ค ํ์ผ/์ฃผ๋ง ์๊ฐ๋ ํจํด์ ์ฌ์ฉํ๋ค. ๊ฐ ์ฅ์์ ์์ฒด ์ผํ๊ท ๋๋น ๋น์จ์ด๋ฉฐ, ๋ค๋ฅธ ๋์์ ์ธ๊ตฌ์๋ฅผ ์ง์ ๋น๊ตํ์ง ์๋๋ค. ์ค์๊ฐ๊ณผ ๊ณผ๊ฑฐ ๊ฐ์ ๊ฐ์ ์ง์ ์ ์ค๋ณต ๋ฐ์ํ์ง ์๊ณ , ๊ณผ๊ฑฐ ์๋ฃ์ ๋ฐ์ ๊ฐ๋๋ ์ค์๊ฐ์ 65%๋ค.
- ์์ธ 250m ๊ฒฉ์ ์ํ์ธ๊ตฌ: ๋ด๊ตญ์ธ ์ถ์ ์น, ์๊ฐ๋ณ. ๊ณต์ ๊ฒฉ์ SHP์ ๊ฒฐํฉํ๋ค.
- ์ธ์ฒ ๋ถํ๊ตฌ ์ฃผ์์ง์ญ ์ ๋์ธ๊ตฌ: 4์๊ฐ ๋จ์. ์ธ์ฒ๊ด๊ดํ์ํ ์์ฅยท๋ฌธํ์๊ฑฐ๋ฆฌ ์ขํ ์ฃผ๋ณ 150m๋ง ๊ทผ์ฌ ์ ์ฉํ๋ค. ์ด๋ ์กฐ์ฌ ๊ฒฝ๊ณ๊ฐ ์๋๋ค. ๊ณต๊ฐ ๋ฒ์๋ฅผ ํ์ธํ์ง ๋ชปํ ์ถ์ ์ง์ญ๊ณผ ๋ถํ4๋์ ์ ์ธํ๋ค.
python tools/import_regional_crowd.py --seoul ์์ธ์ํ์ธ๊ตฌ.zip ๊ฒฉ์.shp --bupyeong ๋ถํ๊ตฌ.csv --out D:/data/run-env-v1/regional-crowd.json
์ธ๋ฑ์ค ์์ฑ ํ Next ์๋ฒ๋ฅผ ๋ค์ ์์ํ๋ค. ๋ถ์ฐ API๋ ํค์ ์๋ณธ ์๋ต ํ์ธ, ๊ฒฝ๊ธฐ ๋ฐ์ดํฐ๋ ์๋ณธ ๋ฐ ๊ฒฝ๊ณยท์ด์ฉ ์กฐ๊ฑด ํ์ธ, ์ ์ฃผ ์ค์๊ฐ์ ๊ณต์ ์ฐ๋ ๊ฒฝ๋ก ํ์ธ ํ ์ถ๊ฐํ๋ค.
๋ณดํ์ ์ผ์ ๋ฐ ๊ฒฝ๊ธฐ ๊ฒฉ์
- ์์ธ ์ด๋ฆฐ๋ฐ์ดํฐ๊ด์ฅ S-DoT์ ์นด๋ฉ๋ผ ์๋ณ ๋ฒ์ 4001~4050๋ง ์ฌ์ฉํ๋ค. ๋ถ๋ฅ ๊ทผ๊ฑฐ. 45m๋ ์ถ์ฒ ์ ์ฉ ๋ฐ๊ฒฝ์ด๋ฉฐ ๊ด์ธก ์์ผ๊ฐ ์๋๋ค. ์ค์๊ฐ ์ฅ์ ๊ด์ธก์ด ์์ ๋ ์ผ์์ ๊ณผ๊ฑฐ ์๊ฐ๋ ํจํด์ ๊ธฐ์กด ๊ด์ญ ์ถ์ ๋ณด๋ค ์ฐ์ ํ๋ค. ์ต์ ๊ด์ธก์ผ์ด 90์ผ์ ๋์ผ๋ฉด ๋ฐ์ํ์ง ์๋๋ค.
--gyeonggi-verified-grid HOURLY_CSV GRID_FILE๋ก ๊ฒฝ๊ธฐ๋ 50m ๊ฒฉ์ ์๋ฃ๋ฅผ ์ถ๊ฐํ ์ ์๋ค. CSV๋grid_id,date,hour,count(๋ ์ง YYYY-MM-DD), ๊ฒฝ๊ณ ํ์ผ์ ๊ฐ์grid_id๋ฅผ ๊ฐ์ง ์ขํ๊ณ๊ฐ ๋ช ์๋ ๊ฒฉ์์ฌ์ผ ํ๋ค. ๋ฌด๋ฃ ์๋น์ค ์ด์ฉ์ด ํ์ธ๋ ์๊ฐ๋ณ ์๋ณธ๋ง ์ฌ์ฉํ๋ค. 8์ ํ์ ๋ ์ ์ ZIP๊ณผ ํ์ผ/์ฃผ๋ง ์ฃผ๊ฐ ํ๊ท ๋ง ์๋ ๋ฐ์ดํฐ๋ ์ด ์ ๋ ฅ์ผ๋ก ์ฐ์ง ์๋๋ค.
python -m pip install openpyxl
python tools/import_regional_crowd.py --sdot ์์น.xlsx ์ฒซ์ฃผ.csv ๋์งธ์ฃผ.csv --out D:/data/run-env-v1/pedestrian-crowd.json
python tools/import_regional_crowd.py --gyeonggi-verified-grid ์๊ฐ๋ณ.csv ๊ฒฉ์.shp --out D:/data/run-env-v1/gyeonggi-crowd.json