# raster - Операции с растром

Модуль операций с растрами.

class axipy.GCP

  Точка привязки (Ground Control Point).

  Атрибуты:

  `device` | Точка на изображении (пиксели).
  `label` | Идентификатор.
  `scene` | Точка на карте.

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

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

class axipy.Algorithm

  Алгоритм трансформации.

  Атрибуты:

  `POLYNOM1` | Аффинитет.
  `POLYNOM2` | Полиномиальный второго порядка.
  `POLYNOM3` | Полиномиальный третьего порядка.
  `SPLINE` | Сплайновый.

class axipy.Resample

  Метод интерполяции.

  Атрибуты:

  `Average` | Средний.
  `Bilinear` | Билинейный.
  `Cubic` | Кубический.
  `CubicSpline` | Кубический сплайн.
  `Lanczos` | Ланцоша.
  `Max` | Максимальный.
  `Med` | Медианный.
  `Min` | Минимальный.
  `Mode` | Самый встречающийся.
  `NearestNeighbour` | Ближайший.
  `Q1` | Первый квартиль.
  `Q3` | Третий квартиль.
  `Sum` | Сумма.

class axipy.Format

  Формат изображения.

  Атрибуты:

  `BMP` |
  `GTiff` |
  `JPEG` |
  `PNG` |

class axipy.Compression

  Сжатие.

  Примечание

  Сжатие можно использовать только для файлов формата GeoTIFF.

  Атрибуты:

  `DEFLATE` |
  `LZW` |
  `NONE` |
  `PACKBITS` |

axipy.register(filepath: str, bindings: Union[List[GCP], QTransform], coordsystem: CoordSystem, override: bool = False)

  Регистрирует растр.

  Добавляет изображению пространственную привязку.

  Параметры:

    - filepath – Файл с изображением.

    - bindings – Привязка в виде точек или матрицы преобразования.

    - coordsystem – Координатная система.

    - override – При регистрации формируется файл привязки TAB. Если он существует, то данный параметр управляет его перезаписью.

  Пример использования

      from PySide2.QtGui import QTransform

      matrix = QTransform()
      coordsystem = CoordSystem.from_units(Unit.m)
      register(imagefile, matrix, coordsystem)

axipy.transform(inputfile: str, outputfile: str, points: List[GCP], coordsystem: CoordSystem, algorithm: Algorithm = Algorithm.SPLINE, resample: Resample = Resample.NearestNeighbour, output_format: Format = Format.GTiff, compression: Compression = Compression.NONE)

  Трансформирует растр.

  Растру, имеющему пространственную привязку, задает новую привязку. На выходе получается новый растр.

  Параметры:

    - inputfile – Входной файл с растром.

    - outputfile – Выходной файл с растром.

    - points – Точки привязки.

    - coordsystem – Координатная система.

    - algorithm – Алгоритм трансформации.

    - resample – Метод интерполяции.

    - output_format – Выходной формат.

    - compression – Метод сжатия.

  Пример использования

      coordsystem = CoordSystem.from_epsg(4326)
      gcps = [
          GCP((0, 0), (0, 0)),
          GCP((200, 0), (30, 30)),
          GCP((200, 200), (60, 0)),
      ]
      transform(rasterfile, outputfile, gcps, coordsystem)