Znaczenie plików w projekcie UMP

Z UMP

(Różnice między wersjami)
d (Wklejone to, co było w FAQ. Drobne zmiany w innych miejscach. Region zamiast Obszar (w sensie podziału))
d (drobne)
Linia 2: Linia 2:
== Wprowadzenie i objaśnienie ==
== 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@.
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@.
-
/uwaga na DUŻE, one są istotne/
 
* katalog UMP-JakisRegion/
* katalog UMP-JakisRegion/
* <del>plik JakisRegion-big.mp (samodzielnie działający – kiedyś nam to było potrzebne)</del>
* <del>plik JakisRegion-big.mp (samodzielnie działający – kiedyś nam to było potrzebne)</del>
Linia 8: Linia 7:
* katalog src/
* katalog src/
* plik cities-JakisRegion.pnt
* plik cities-JakisRegion.pnt
-
* plik(i) POI-*.pnt (w tym POI-routing.pnt)
+
** <del>pliki cities-JakisRegion.txt i POI-JakisRegion.txt – niewskazane, chociaż dopuszczalne </del>
-
* 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)
* 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)
* plik(i) inne.ulice.txt i *.drogi.txt (do zawartości nie jest dopisywane info o przynależności)
Linia 19: Linia 20:
* pliki *.znaki.txt (na podpowiedzi przejazdu czyli sekcje [SIGN])
* pliki *.znaki.txt (na podpowiedzi przejazdu czyli sekcje [SIGN])
* pliki *.granice.txt
* pliki *.granice.txt
-
* pliki *.highways.txt (na zjazdy z autostrady)
 
-
* pliki *.debug.txt (na znaczniki ślepych końców oraz wiaduktów)
 
* pliki *.szlaki.topo.txt
* pliki *.szlaki.topo.txt
* pliki *.topo.* z drobnymi elementami włączanymi tylko do wersji Topo
* pliki *.topo.* z drobnymi elementami włączanymi tylko do wersji Topo
-
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:
+
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
BIELSKO-BIALA.ulice.txt
GORZOW_WIELKOPOLSKI.ulice.txt
GORZOW_WIELKOPOLSKI.ulice.txt
-
 
Wielkość liter ma znaczenie, i pisząc:
Wielkość liter ma znaczenie, i pisząc:
* '''Region''' jest rozumiane jako konkretny region czyli kawałek mapy, np. Warszawa, Katowice...
* '''Region''' jest rozumiane jako konkretny region czyli kawałek mapy, np. Warszawa, Katowice...
* '''REGION''' jw. zwróć uwagę na wielkość liter, np. WARSZAWA, KATOWICE...
* '''REGION''' jw. zwróć uwagę na wielkość liter, np. WARSZAWA, KATOWICE...
* '''MIASTO''' oznacza nazwę miasta, np. GRODZISK_MAZOWIECKI, WARSZAWA_SRODMIESCIE...
* '''MIASTO''' oznacza nazwę miasta, np. GRODZISK_MAZOWIECKI, WARSZAWA_SRODMIESCIE...
-
 
-
Dopuszczalne w nazwach są litery A-Z (bez polskich), myślnik, znak podkreślenia (zamiast spacji).
 
-
 
* '''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
* '''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
Linia 46: Linia 41:
*'''MIASTO'''.ulice.txt
*'''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
+
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
PODKOWA_LESNA.ulice.txt
znajdziemy na początku
znajdziemy na początku
Miasto=Podkowa Leśna
Miasto=Podkowa Leśna
Jeśli wpisu nie ma, to nazwa miasta jest generowana na bazie nazwy pliku.
Jeśli wpisu nie ma, to nazwa miasta jest generowana na bazie nazwy pliku.
-
<br />Sugerujemy wydzielać miasta, które osiągnęły 100 ulic.
+
<br />Sugerujemy wydzielać miasta, które mają wrysowane ponad 100 ulic.
*inne.drogi.txt
*inne.drogi.txt

Wersja z dnia 10:38, 17 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

==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ą wrysowane 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