Znaczenie plików w projekcie UMP

Z UMP

Wersja z dnia 13:49, 20 lis 2009

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.

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

Pozostałe nie wymagaja opisu:

• REGION.hotele.pnt
• REGION.jedzenie.pnt
• REGION.kinoteatr.pnt
• REGION.koscioly.pnt
• REGION.paliwo.pnt
• REGION.rozrywka.pnt
• REGION.sport.pnt
• REGION.szkoly.pnt
• REGION.szpitale.pnt i apteki
• REGION.zabytki.pnt

• REGION.inne.pnt