Geografía

class tinamit.geog.región.Lugar(nombre, nivel, cód=None, sub_lugares=None)[fuente]

Un lugar dado en una geografía.

Parámetros:
  • nombre (str) – El nombre del lugar.
  • nivel (Nivel) – El nivel geográfico correspondiente.
  • cód (str) – El identificador único de este lugar. Si es None, se tomará su nombre como identificador.
  • sub_lugares – Lugares que se encuentre adentro de este.
buscar_nombre(nombre, nivel=None)[fuente]

Devuelve el sublugar con el nombre dado.

Parámetros:
  • nombre (str) – El nombre del lugar deseado.
  • nivel (Nivel or str) – Desambiguación en el caso que hayan múltiples lugares con el mismo nombre en distintos niveles.
Devuelve:

Tipo del valor devuelto:
 

Lugar

hijos_inmediatos(ord_niveles=None)[fuente]

Devuelve los hijos inmediatos de este Lugar.

Parámetros:ord_niveles (list) – Desambiguación para lugares con niveles paralelos.
Devuelve:
Tipo del valor devuelto:
 list[Lugar]
lugares(en=None, nivel=None)[fuente]

Devolver los sublugares presentes en este lugar.

Parámetros:
  • en (str or Lugar) – Sublugar al cual limitir la búsqueda.
  • nivel (Nivel or str or list) – Opción para limitir los resultados a uno o más niveles.
Devuelve:

Tipo del valor devuelto:
 

set[Lugar]

pariente(lugar, ord_niveles=None, todos=False)[fuente]

Obtener el pariente de un sublugar dado.

Parámetros:
  • lugar (str or Lugar) – Un sublugar cuyo pariente queremos.
  • ord_niveles (list) – Desambiguación para lugares con niveles paralelos.
  • todos (bool) – Si queremos todos los parientes del lugar, o solamente el más cercaco.
Devuelve:

Tipo del valor devuelto:
 

Lugar

class tinamit.geog.región.Nivel(nombre, subniveles=None)[fuente]

Un nivel geográfico (p. ej, municipio o departamento.

Parámetros:
  • nombre (str) – El nombre del nivel.
  • subniveles (list of Nivel) – Lista de subniveles.
tinamit.geog.región.gen_lugares(archivo, nivel_base, nombre=None, col_cód='Código')[fuente]

Genera un lugar con todos los niveles y sublugares asociados desde un archivo .csv.

Cada columna en el .csv debe empezar con el nombre de un nivel, con la excepción de la columna col_cód, la cual tendrá el código identificador único de cada lugar.

Cada fila representa un lugar, con su nombre en la columna correspondiendo al nivel de este lugar y el código del lugar pariente en las otras columnas. Si un nivel no se aplica a un lugar (por ejemplo, un departamento no tendrá municipio pariente), se deja vacía la célula.

Parámetros:
  • archivo (str) – El archivo .csv.
  • nivel_base (str) – El el nivel más alto. Por ejemplo, si tu csv entero representa un país, sería país.
  • nombre (str) – El nombre del lugar correspondiendo al nivel más alto. Por ejemplo, «Guatemala».
  • col_cód (str) – El nombre de la columna con los códigos de cada sublugar.
Devuelve:

Tipo del valor devuelto:
 

Lugar