# OgrDataProvider - Векторный провайдер OGR

class axipy.OgrDataProvider

  Базовые классы: `DataProvider`

  Провайдер для векторных данных OGR.

  Примечание

  Ссылку на провайдер можно получить через глобальную переменную `axipy.provider_manager.ogr`.

  См.также

  Пример использования см Преобразование с использованием библиотеки OGR

  Свойства:

  `id` | Идентификатор провайдера.

  Методы:

  `create_open`() | Внимание Не поддерживается.
  `file_extensions`() | Список поддерживаемых расширений файлов.
  `get_destination`(filepath, dataobject, schema) | Создает назначение объекта данных.
  `get_source`(data[, dataobject, alias, ...]) | Создает источник данных.
  `open`(data[, dataobject, alias, encoding, ...]) | Открывает объект данных.

  Специальные методы:

  `__repr__`() | Официальное строковое представление объекта при вызове `repr()`.

  __repr__() → str

    Официальное строковое представление объекта при вызове `repr()`.

  create_open() → DataObject

    Внимание

    Не поддерживается.

    Исключение:

      NotImplementedError –

  file_extensions() → List[str]

    Список поддерживаемых расширений файлов.

    Результат:

      Пустой список для не файловых провайдеров.

  get_destination(filepath: str, dataobject: str, schema: Schema, open_mode: OpenMode = OpenMode.Create, create_data: Optional[dict] = None) → Destination

    Создает назначение объекта данных.

    Параметры:

      - filepath – Источник данных или имя файла.

      - dataobject – Наименование таблицы

      - schema – Схема таблицы.

      - open_mode – Режим открытия файла. В случае `OpenMode.Append` будет производиться дополнение к существующему файлу.

      - create_data –

        Параметры OGR. Разделены на два раздел, которые организуются так же как словари `dict`.

        - »lco» - используется при создании слоя как дополнительные параметры. Соответствуют «Layer creation options» у рассматриваемого источника

        - »dsco» - используется при создании источника данных как дополнительные параметры. Соответствуют «Database creation options»

        - »driver» - явное указание используемого драйвера»

    См.также

    Преобразование с использованием библиотеки OGR

  get_source(data: str, dataobject: Optional[str] = None, alias: Optional[str] = None, encoding: str = 'utf8', open_data: Optional[dict] = None) → Source

    Создает источник данных.

    Параметры:

      - data – Источник данных или имя файла.

      - dataobject – Наименование таблицы. Если не указано, будет выбрано по умолчанию.

      - alias – Псевдоним для открываемой таблицы.

      - encoding – Кодировка.

      - open_data – Параметры OGR. Передаются как пары параметр-значения, которые в конечном итоге рассматриваются как дополнительные параметры при открытии в функции GDALOpenEx Конкретные параметры необходимо смотреть в разделе «Dataset open options» для рассматриваемого источника.

  property id: str

    Идентификатор провайдера.

  open(data: str, dataobject: Optional[str] = None, alias: Optional[str] = None, encoding: str = 'utf8', open_data: Optional[dict] = None) → DataObject

    Открывает объект данных.

    Параметры:

      - data – Источник данных или имя файла.

      - dataobject – Наименование таблицы. Если не указано, будет выбрано по умолчанию.

      - alias – Псевдоним для открываемой таблицы.

      - encoding – Кодировка.

      - open_data –

        Параметры OGR. Передаются как пары параметр-значения, которые в конечном итоге рассматриваются как дополнительные параметры при открытии в функции GDALOpenEx Конкретные параметры необходимо смотреть в разделе «Dataset open options» для рассматриваемого источника.