Znaczenie plików w projekcie UMP

Z UMP

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

Pliki z POI z Zewnętrznych źródeł danych

  • REGION.EXT.paliwo.pnt