भूगोल

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

Un lugar dado en una geografía.

Parameters:

• 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)

Devuelve el sublugar con el nombre dado.

Parameters:

• 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.

Returns:

Return type:

Lugar

hijos_inmediatos(ord_niveles=None)

Devuelve los hijos inmediatos de este Lugar.

Parameters:ord_niveles (list) -- Desambiguación para lugares con niveles paralelos. Returns: Return type:list[Lugar]

lugares(en=None, nivel=None)

Devolver los sublugares presentes en este lugar.

Parameters:

• 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.

Returns:

Return type:

set[Lugar]

pariente(lugar, ord_niveles=None, todos=False)

Obtener el pariente de un sublugar dado.

Parameters:

• 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.

Returns:

Return type:

Lugar

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

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

Parameters:

• 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')

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.

Parameters:

• 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.

Returns:

Return type:

Lugar