Znaczenie plików w projekcie UMP

Z UMP

Wersja z dnia 14:06, 20 lis 2009; Miszka (Dyskusja | wkład)

(różn) ← Poprzednia wersja | Aktualna wersja (różn) | Następna wersja → (różn)

Wprowadzenie i objaśnienie

Utrzymujemy następującą konwencję nazywania plików źródłowych. Jeśli się jej trzymasz, nowe pliki pojawią się w mapie same z siebie. Jeśli chcesz ją rozszerzyć, pamiętaj o pliku cvs:/narzedzia/md-filtr, wypada też to uzgodnić na liście ump-devel@.

katalog UMP-JakisRegion/
~~plik JakisRegion-big.mp (samodzielnie działający – kiedyś nam to było potrzebne)~~
pliki jednakowe dla różnych regionów, w szczególności skrypty mont-demont
katalog src/
plik cities-JakisRegion.pnt
- ~~pliki cities-JakisRegion.txt i POI-JakisRegion.txt – niewskazane, chociaż dopuszczalne~~
plik(i) POI-*.pnt
- w tym POI-routing.pnt i/lub *.debug.pnt (na znaczniki ślepych końców oraz wiaduktów)
- wyjątkowo punkty zjazdów z autostrady w plikach *.highways.txt
pliki MIASTO.ulice.txt (do zawartości dopisywana jest przynależność do miasta)
plik(i) inne.ulice.txt i *.drogi.txt (do zawartości nie jest dopisywane info o przynależności)
pliki *.zielone.txt
pliki *.woda.txt
pliki *.obszary.txt
pliki *.kolej.txt
pliki *.zakazy.txt (na zakazy zawracania czy przejazdu)
pliki *.znaki.txt (na podpowiedzi przejazdu czyli sekcje [SIGN])
pliki *.granice.txt
pliki *.szlaki.topo.txt
pliki *.topo.* z drobnymi elementami włączanymi tylko do wersji Topo

W nazwach plików nie stosuj ogonków. W przypadku wieloczłonowych nazw miejscowości pisanych z odstępem (spacją), znak ten należy zastąpić znakiem _ (podkreślenie). Nazwy pisane z dywizem (myślnikiem) zapisujemy w normalny sposób. Człony "Mazowiecki, Wielkopolski" itp. piszemy w całości. Przykłady:

BIELSKO-BIALA.ulice.txt
GORZOW_WIELKOPOLSKI.ulice.txt

Wielkość liter ma znaczenie, i pisząc:

Region jest rozumiane jako konkretny region czyli kawałek mapy, np. Warszawa, Katowice...
REGION jw. zwróć uwagę na wielkość liter, np. WARSZAWA, KATOWICE...
MIASTO oznacza nazwę miasta, np. GRODZISK_MAZOWIECKI, WARSZAWA_SRODMIESCIE...
POWIAT dla zmniejszenia plików inne.drogi.txt sugerujemy zgrubny podział na umowne powiaty, powiatów nie odmieniamy, piszemy je w formie: WARSZAWA, GRODZISK, GROJEC
EXT oznacza zewnętrzne źródło danych. Patrz: Zewnętrzne źródła danych

Pliki

(wyjaśnienia szczegółowe)

cities-Region.pnt

zawierają miejscowości w formie

"lat,lon,wielkość,nazwa"

plik ten wygodnie obrabia się także pod OziExplorerem

MIASTO.ulice.txt

Zawiera ulice danego miasta (w formacie mp). Na początku tego pliku (1 linijka) może być zapisane Miasto=Miasto (kapitaliki, spacje i polskie ogonki) np. w pliku

PODKOWA_LESNA.ulice.txt

znajdziemy na początku

Miasto=Podkowa Leśna

Jeśli wpisu nie ma, to nazwa miasta jest generowana na bazie nazwy pliku.
Sugerujemy wydzielać miasta, które mają wyrysowane ponad 100 ulic.

inne.drogi.txt

Plik zawiera drogi, które jeszcze nie zostały rozdzielone na POWIATy lub nie można w danej chwili stwierdzić przynależności. Zalecane jest jednak rozdzielenie zawartości.

POWIAT

Pliki powstały dla zmniejszenia pliku inne.drogi.txt oraz plików REGIONów. To zmniejsza transmisję w momencie porównywania plików lokalnych i serwera (cvs up, cvs com).

POWIAT.drogi.txt - zawiera drogi. Uwaga! Wiele narzędzi zakłada ze będą tam tylko drogi.
POWIAT.topo.txt - zawiera dane dla kompilacji UMP-PL topo, miejsce na ścieżki, drogi z zasady nie przejezdne dla samochodu itp.
POWIAT.woda.txt - wszelkie obszary i linie dotyczące wody: jeziora, stawy, rzeki, strumyki, morza.
POWIAT.zielone.txt - Lasy, laski, parki, działki.
POWIAT.obszary.txt - zawiera wszelkie obszary które nie trafiły wyżej
POWIAT.zakazy.txt - tutaj umieszczamy restrykcje czyli zakazy manewrów (zakręcania, zawracania)definiowane liniami 0x19. (link?)

REGION

REGION.granice.txt - granice administracyjne miast, powiatów i gmin.
REGION.budynki.txt - gdzieniegdzie pojawiają się obrysy budynków.
REGION.kolej.txt - tu znajdziemy tory kolei wszelkiego rodzaju.
REGION.highways.txt - na zjazdy z autostrady, POI mają dodatkowe informacje które nie pozwalają użyć formatu pnt.
REGION.szlaki.txt - szlaki znakowane - jest to pozostałość po wcześniejszych wersjach\próbach. Po weryfikacji zawartość powinna trafić do szlaki.topo.txt.
REGION.szlaki.topo.txt - zawiera szlaki znakowane - dane stąd trafiają do UMP-PL topo i UMP-szlaki.

Pliki z danymi pochodzącymi z Zewnętrznych źródeł danych

REGION.EXT.topo.txt

Znaczenie poniższych jest takie samo jak dla POWIATów

REGION.zakazy.txt
REGION.woda.txt
REGION.zielone.txt
REGION.obszary.txt

POI

Przyczyną rozbicia na pliki jest głównie łatwiejsza edycja dla człowieka (porządek, posortowanie, łatwiej porównywać z innymi listami punktów danego rodzaju, itp.)

REGION.debug.pnt - bojki
REGION.debug.topo.pnt - bojki dla topo
REGION.kolej.pnt - stacje PKP, przystanki PKS, metro, pętle tramwajowe
REGION.msi.pnt - Mapy "Miejskiego Systemu Informacji", tu też powinny trafić wszelkiego rodzaju tablice informacyjne
REGION.budynki.pnt - budynki użyteczności publicznej: urzędy, ministerstwa, komendy, ambasady itp
REGION.sklepy.pnt - sklepy "wielkoformatowe" oraz 24h lub spożywczaki na "zadupiu"
REGION.bankomaty.pnt - bankomaty oraz banki
REGION.historia.pnt - punkty na mapie które już nie istnieją (forty, budynki historyczne)
REGION.topo.pnt - zawiera punkty brane pod uwagę tylko w mapie topo