Инициализация¶

API может быть использован следующими способами:

в приложении ГИС «Аксиома» из панели «Консоль Python»;
в модуле, который будет загружен в ГИС «Аксиома»;
как SDK - Software development kit, независимо от приложения Аксиома.ГИС.

Примечание

Для использования API в качестве SDK требуется платная лицензия.

В первых двух случаях можно сразу приступать к работе, так как API будет инициализировано за вас. В последнем случае перед началом использования его необходимо самостоятельно инициализировать. Если забыть это сделать, то при попытке использования будет вызвано исключение, которое напомнит выполнить инициализацию.

Например:

from axipy.cs import CoordSystem


try:
    crs = CoordSystem.from_epsg(4326)
except RuntimeError as error:
    print(f"Поймано исключение: {error}")

>>> Поймано исключение: axipy is not initialized

Для инициализации API следует вызвать метод axipy.init_axioma():

from axipy import init_axioma
init_axioma()  # инициализация

from axipy.cs import CoordSystem
crs = CoordSystem.from_epsg(4326)
crs.name

>>> 'Долгота / Широта (WGS 84)'

Допускается (но не рекомендуется) импортировать сразу все классы и функции, чтобы упростить процедуру импорта.

from axipy import *  # импортируем все типы ГИС "Аксиома"
                     # в текущее пространство имен

crs = CoordSystem.from_epsg(4088)
crs.name

>>> 'World Equidistant Cylindrical (Sphere)'

Системные переменные¶

Системные переменные, если это требуется, необходимо устанавливать до проведения инициализации ядра.

AXIOMA_LOG_LEVEL¶

Системная переменная AXIOMA_LOG_LEVEL управляет уровнем логирования в системе. Допустимый диапазон значений (0…3) в сторону уменьшения количества выводимой информации. По умолчанию устанавливается средний уровень - «2». Если установить значение «-1», то логирование будет отключено.

AXIOMA_LANGUAGE¶

Системная переменная AXIOMA_LANGUAGE устанавливает язык интерфейса. Допустимые значения «ru» и «en».

from axipy import init_axioma
import os

os.environ["AXIOMA_LOG_LEVEL"] = "1"
os.environ["AXIOMA_LANGUAGE"] = "en"
init_axioma()  # инициализация