mkgmap-splitter: en línea en la nube

PROGRAMA:

NOMBRE

mkgmap-splitter - divisor de mosaicos para mkgmap

SINOPSIS

divisor-mkgmap [opciones] archivo.osm > divisor.log

DESCRIPCIÓN

divisor-mkgmap divide un archivo .osm que contiene grandes regiones bien mapeadas en un número
de mosaicos más pequeños, para ajustarse al tamaño máximo utilizado para el formato de mapas de Garmin. Allí
Se requieren al menos dos etapas de procesamiento. La primera etapa es calcular qué área
cada mosaico debe cubrir, según la distribución de los nodos. La segunda etapa escribe
los nodos, formas y relaciones del archivo .osm original en .osm más pequeños separados
archivos, uno para cada área que se calculó en la etapa uno. Con opcion
--keep-complete = verdadero, se utilizan dos etapas adicionales para evitar formas rotas y polígonos.

Las dos características más importantes son:

· Azulejos de tamaño variable para evitar una gran cantidad de archivos diminutos.

· Los mosaicos se unen exactamente sin superposición ni espacios.

Necesitará mucha memoria en su computadora si tiene la intención de dividir un área grande. Unos pocos
Las opciones permiten configurar la cantidad de memoria que necesita. Con los parámetros predeterminados, necesita
alrededor de 4-5 bytes para cada nodo y vía. Esto no suena mucho, pero hay alrededor de 1700.
millones de nodos en todo el archivo del planeta y, por lo tanto, no puede procesar todo el planeta en uno
pasar el archivo en una máquina de 32 bits utilizando esta utilidad, ya que el espacio de almacenamiento dinámico máximo de Java es 2G. Eso
es posible con Java de 64 bits y aproximadamente 7 GB de montón o con múltiples pases.

El extracto europeo de Cloudmade o Geofabrik se puede procesar dentro del límite de 2G si
tener suficiente memoria. Con las opciones predeterminadas, europa se divide en aproximadamente 750 mosaicos.
El extracto de Europa tiene aproximadamente la mitad del tamaño del archivo completo del planeta.

Por otro lado, un solo país, incluso uno bien cartografiado como Alemania o el Reino Unido,
ser posible en una máquina modesta, incluso en una netbook.

USO

Splitter requiere Java 1.6 o superior. El uso básico es el siguiente.

divisor-mkgmap archivo.osm > divisor.log

Si tiene menos de 2 GB de memoria en su computadora, debe reducir la -Xmx opción por
estableciendo la variable de entorno JAVA_OPTS.

JAVA_OPTS = "-Xmx512m" divisor-mkgmap archivo.osm > divisor.log

Esto producirá varios archivos .osm.pbf que pueden ser leídos por mkgmapa(1). Existen
también otros archivos producidos:

La sección plantilla.args archivo es un archivo que se puede utilizar con el -c opción de mkgmapa con amados villancicos que
compila todos los archivos. Puede usarlo tal cual o puede copiarlo y editarlo para incluir
sus propias opciones. Por ejemplo, en lugar de que cada descripción sea "Mapa OSM", podría ser "NW
Escocia "según corresponda.

La sección lista de áreas archivo es la lista de cuadros delimitadores que se calcularon. Si te quieres
puede usar esto en una llamada posterior el divisor usando el --Archivo dividido opción de uso
exactamente las mismas áreas que la última vez. Esto puede ser útil si produce un mapa con regularidad.
y desea mantener las áreas de baldosas iguales de un mes a otro. También es útil evitar
el tiempo que se tarda en regenerar el archivo cada vez (actualmente alrededor de un tercio del total
tiempo necesario para realizar el split). Por supuesto, si el mapa crece lo suficiente como para que uno de los mosaicos
desbordes, tendrá que volver a calcular las áreas nuevamente.

La sección áreas.poly El archivo contiene el polígono delimitador de las áreas calculadas. Ver opción
--archivo de polígono cómo se puede utilizar esto.

La sección densidades-fuera.txt El archivo se escribe cuando no se proporciona ningún archivo dividido y contiene depuración
sólo información.

También puede utilizar un archivo .osm comprimido con formato gzip o bz2 como archivo de entrada. Tenga en cuenta que
esto puede ralentizar considerablemente el divisor (particularmente cierto para bz2) porque
descomprimir el archivo .osm puede consumir bastante potencia de la CPU. Si es probable que sea
procesando un archivo varias veces, probablemente sea mejor convertir el archivo a uno de
los formatos binarios pbf u o5m. El formato o5m es más rápido de leer, pero requiere más espacio
en el disco.

OPCIONES

Hay una serie de opciones para ajustar las cosas que quizás desee probar.

--boundary-tags =cadena
Una lista separada por comas de valores de etiqueta para relaciones. Se utiliza para filtrar multipolígono.
y relaciones de límites para el procesamiento de listas de problemas. Ver también opción
--se busca-nivel-de-administrador. Predeterminado: use-exclude-list

--caché =cadena
En desuso, ahora no hace nada

--description =cadena
Establece la descripción que se escribirá en el plantilla.args .

--geonames-file =cadena
El nombre de un archivo GeoNames que se utilizará para determinar los nombres de los mosaicos. Típicamente
ciudades15000.zip de geonames ⟨http://download.geonames.org/export/dump⟩.

--keep-complete =booleano
Utilice --keep-complete = falso para deshabilitar dos fases adicionales del programa entre
split y la fase de distribución final (no recomendado). La primera fase, llamada
gen-problem-list, detecta todas las formas y relaciones que están cruzando las fronteras de
uno o más archivos de salida. La segunda fase, denominada manejar-lista-de-problemas, recopila
las coordenadas de estas formas y relaciones y calcula todos los archivos de salida que
están cruzados o encerrados. La información se pasa a la fase final de distribución en
tres archivos temporales. Esto evita polígonos rotos, pero tenga en cuenta que requiere
para leer los archivos de entrada al menos dos veces más.

No lo especifique con --superposición a menos que tenga una buena razón para hacerlo.

Predeterminado: verdadero

--mapid =int
Establezca el nombre de archivo para los archivos divididos. En el ejemplo, el primer archivo se llamará
63240001.osm.pbf y el próximo será 63240002.osm.pbf y así sucesivamente.

Predeterminado: 63240001

--max-areas =int
El número máximo de áreas que se pueden procesar en una sola pasada durante la
segunda etapa de procesamiento. Debe ser un número del 1 al 4096. Números más altos
significa menos pasadas sobre el archivo de origen y, por lo tanto, un procesamiento general más rápido, pero
también requieren más memoria. Si descubre que se está quedando sin memoria pero no quiere
para aumentar tu --max-nodos valor, intente reducirlo en su lugar. Cambiar esta voluntad
no tiene ningún efecto en el resultado de la división, es simplemente para permitirle intercambiar memoria
para el rendimiento. Tenga en cuenta que la primera etapa del procesamiento tiene una memoria fija
sobrecarga independientemente de lo que esté configurado, por lo que si se está quedando sin memoria
antes de lista de áreas se genera el archivo, debe aumentar su -Xmx
valor o reduzca el tamaño del archivo de entrada que está intentando dividir.

Predeterminado: 512

--max-nodos =int
El número máximo de nodos que puede haber en cualquiera de los archivos resultantes. El valor por defecto
es bastante conservador, podría aumentarlo bastante antes de obtener cualquier 'mapa
mensajes demasiado grandes. No se ha hecho mucha experimentación. También cuanto más grande es esto
valor, se requiere menos memoria durante la etapa de división.

Predeterminado: 1600000

--max-hilos =valor
El número máximo de subprocesos utilizados por divisor-mkgmap.

Predeterminado: 4 (automático)

--mixed =booleano
Especifique esto si el archivo osm de entrada tiene nodos, caminos y relaciones entremezclados o
los identificadores no están ordenados estrictamente. Para aumentar el rendimiento, utilice el ósmosis sort
función.

Predeterminado: falso

--no-trim =booleano
No recorte los espacios vacíos de los bordes de las baldosas. Esta opción se ignora cuando
--archivo de polígono se utiliza.

Predeterminado: falso

--num-tiles =valorcadena
Un valor objetivo que se utiliza cuando no se proporciona ningún archivo dividido. La división se realiza para que
se produce el número dado de baldosas. los --max-nodos el valor se ignora si este
se da la opción.

--salida =cadena
El formato en el que se escriben los archivos de salida. Los valores posibles son xml, pbf,
o5m y simular. El valor predeterminado es pbf, que produce los tamaños de archivo más pequeños.
El formato o5m es más rápido de escribir, pero crea archivos alrededor de un 40% más grandes. los
La opción de simulación es para fines de depuración.

--output-dir =camino
El directorio en el que el divisor debe escribir los archivos de salida. Si el especificado
la ruta a un directorio no existe, divisor-mkgmap intenta crearlo. Predeterminado a
el directorio de trabajo actual.

--overlap =cadena
En desuso desde r279. Con --keep-complete = falso, divisor-mkgmap debe incluir
nodos fuera del cuadro delimitador, de modo que mkgmapa puede recortar prolijamente exactamente en el
frontera. Este parámetro controla el tamaño de esa superposición. Está en unidades de mapa, un
se utiliza el valor predeterminado de 2000, lo que significa aproximadamente 0.04 grados de latitud o longitud.
If --keep-complete = verdadero está activo y --superposición se da, se imprimirá una advertencia
porque esta combinación rara vez tiene sentido.

--polygon-desc-file =camino
Un archivo osm (.o5m, .pbf, .osm) con formas nombradas que describen polígonos delimitadores con
Formas OSM que tienen etiquetas name y mapid.

--polygon-file =camino
El nombre de un archivo que contiene un polígono delimitador en el formato de archivo de polígono de ósmosis
. divisor-mkgmap utiliza este archivo al calcular las áreas. Primero calcula
una cuadrícula usando el dado --resolución. Se lee el archivo de entrada y para cada nodo, un
El contador aumenta para el área de la cuadrícula relacionada. Si el archivo de entrada contiene un
cuadro delimitador, esto se aplica a la cuadrícula para que los nodos fuera del cuadro delimitador
son ignorados. A continuación, si se especifica, el polígono delimitador se usa para poner a cero esas cuadrículas
elementos fuera del área del polígono delimitador. Si las áreas del polígono describen
un área rectilínea con no más de 40 vértices, divisor-mkgmap tratará de
crear archivos de salida que encajen exactamente en el área; de lo contrario, se aproximará
el área del polígono con rectángulos.

--precomp-sea =camino
El nombre de un directorio que contiene mosaicos de mar precompilados. Si se da, mkgmap-
disidente usará los mosaicos de mar precompilados de la misma manera que mkgmapa lo hace. Utilizar
esto si desea utilizar un archivo poligonal o --no-trim = verdadero y mkgmapa crea vacío
* Archivos .img combinados con un mensaje que comienza "No hay suficiente espacio en un solo
mapa de garmin para todos los datos de entrada ".

--problem-file =camino
El nombre de un archivo que contiene formas y relaciones que se sabe que causan problemas
en el proceso de división. Utilice esta opción si --mantener completo requiere demasiado tiempo o
memoria y --superposición no resuelve tu problema.

Sintaxis del archivo problemático:

camino: # comentario ...
rel: # comentario ...

ejemplo:

manera: 2784765 # Ferry Guernsey - Jersey

--problem-report =camino
El nombre de un archivo para escribir la lista de problemas generada creada con
--mantener completo. El parámetro se ignora si --keep-complete = falso. Puedes reutilizar
este archivo con el --archivo-problema parámetro, pero haga esto solo si usa el mismo
valores para --max-nodos y --resolución.

--resolution =int
La resolución del mapa de densidad producido durante la primera fase. Un valor entre
1 y 24. El valor predeterminado es 13. Aumentar el valor a 14 requiere cuatro veces más
memoria en la fase dividida. El valor se ignora si un --Archivo dividido es dado.

--search-limit =int
Límite de búsqueda en algoritmo dividido. Los valores más altos pueden encontrar mejores divisiones, pero tomarán
más.

Predeterminado: 200000

--split-file =camino
Utilice las áreas de mosaico calculadas previamente en lugar de calcularlas desde cero.
El archivo puede estar en formato .list o .kml.

--status-freq =int
Muestra la cantidad de memoria utilizada por la JVM cada --estado-frecuencia segundos. Establecer = 0
deshabilitar.

Predeterminado: 120

--stop-after =cadena
Depuración: se detiene después de una determinada fase del programa. Puede ser dividido, gen-problem-list o
manejar-lista-de-problemas. El valor predeterminado es dist, lo que significa ejecutar todas las fases.

--wanted-admin-level =cadena
Especifica el valor admin_level más bajo de las relaciones de límite que se deben mantener
completo. Se utiliza para filtrar relaciones de límites para el procesamiento de listas de problemas. los
El valor predeterminado 5 significa que las relaciones de contorno se mantienen completas cuando
admin_level es 5 o superior (5..11). El parámetro se ignora si
--keep-complete = falso. Predeterminado: 5

--escribir-kml =camino
El nombre de un archivo kml para escribir las áreas. Esto es además de
lista de áreas (que siempre está escrito).

Opciones especiales

--versión
Si el parámetro --versión se encuentra en algún lugar de las opciones, divisor-mkgmap will
simplemente imprima la información de la versión y salga. La información de la versión se ve así:

splitter 279 compiled 2013-01-12T01:45:02+0000

--ayuda Si el parámetro --ayuda se encuentra en algún lugar de las opciones, divisor-mkgmap will
imprima una lista de todas las opciones normales conocidas junto con una breve ayuda y salga.

TUNING

Sintonización para el mejor rendimiento

Algunas sugerencias para aquellos que están usando divisor-mkgmap para dividir archivos grandes.

· Para un procesamiento más rápido con --keep-complete = verdadero, convierta el archivo de entrada al formato o5m
mediante:

conversión osm - versión de gota archivo.osm -o =archivo.o5m

· La opción - versión de gota es opcional, reduce el archivo a los datos que se necesitan
by divisor-mkgmap y mkgmapa.

· Si sigue teniendo un rendimiento deficiente, consulte divisor.log. Busca la palabra
Distribuido. Puede encontrar algo como esto en la siguiente línea:

Procesando 1502 áreas en 3 pasadas, 501 áreas a la vez

Esto significa que el divisor tiene que leer la entrada del archivo de entrada tres veces porque el --áreas máximas
El parámetro fue mucho menor que el número de áreas. Si tiene suficiente montón, configure
--áreas máximas valor a un valor superior al número de áreas, p. ej.
--áreas máximas = 2048. Ejecutar divisor-mkgmap de nuevo y deberías encontrar

Procesando 1502 áreas en una sola pasada

· Más áreas requieren más memoria. Asegúrate de eso divisor-mkgmap tiene suficiente montón
(aumenta el -Xmx parámetro) para que no pierda mucho tiempo en la basura
colector (GC), pero mantenga la mayor cantidad de memoria posible para los cachés de E / S del sistema.

· Si está disponible, use dos discos diferentes para el archivo de entrada y el directorio de salida, esp. Cuando usted
utilice el formato o5m para entrada y salida.

· Si utiliza mkgmapa r2415 o posterior y el espacio en disco no es un problema, considere usar
--salida = o5m para acelerar el procesamiento.

Ajuste para requisitos de memoria bajos

Si su máquina tiene menos de 1 GB de memoria libre (por ejemplo, una netbook), aún puede usar mkgmap-
disidente, pero es posible que tenga que ser paciente si utiliza el parámetro --mantener completo y
quiero dividir un archivo como alemania.osm.pbf o uno más grande. Si es necesario, reduzca el número
de áreas procesadas en paralelo a 50 con el --áreas máximas parámetro. Tienes que usar
--keep-complete = falso al dividir un área como Europa.

NOTAS

· Ya no hay un límite superior en el número de áreas que se pueden generar (anteriormente
era 255). Más áreas solo significan que potencialmente se requieren más pases sobre el .osm
archivo y, por lo tanto, el divisor tardará más en ejecutarse.

· Ya no hay un límite sobre cuántas áreas puede pertenecer una forma o relación (anteriormente
era 4).

Use mkgmap-splitter en línea usando los servicios de onworks.net