terracotta

Terracotta — это сервер плиток на чистом Python, который работает как приложение WSGI на выделенном веб-сервере или как бессерверное приложение на AWS Lambda. Он построен на современном стеке Python и работает на потрясающем программном обеспечении с открытым исходным кодом, таком как Flask, Zappa и Rasterio.

Прочтите документацию | Попробуйте демо | Изучите API | Satlas на базе Terracotta | Докер-образ

Почему Терракота?

• Это тривиально, чтобы начать работу. У вас есть папка, полная оптимизированных для облака файлов GeoTiff в разных проекциях, которые вы хотите просмотреть в своем браузере? terracotta serve -r {name}.tif и terracotta connect localhost:5000 помогут вам туда.
• Мы делаем минимальные предположения о ваших данных, поэтому ответственность остается за вами . Продолжайте использовать инструменты, которые вы знаете и любите, для создания и систематизации ваших данных, Terracotta предоставит их такими, какие они есть.
• Бессерверное развертывание является первоочередным вариантом использования, поэтому вам не придется беспокоиться о поддержке или масштабировании вашей архитектуры.
• Экземпляры Терракоты самодокументируются. Все, что интерфейсному интерфейсу нужно знать о ваших данных, доступно лишь с нескольких конечных точек API.

Рабочий процесс Терракоты

1. Оптимизация растровых файлов

$ ls -lh
total 1.4G
-rw-r--r-- 1 dimh 1049089 231M Aug 29 16:45 S2A_20160724_135032_27XVB_B02.tif
-rw-r--r-- 1 dimh 1049089 231M Aug 29 16:45 S2A_20160724_135032_27XVB_B03.tif
-rw-r--r-- 1 dimh 1049089 231M Aug 29 16:46 S2A_20160724_135032_27XVB_B04.tif
-rw-r--r-- 1 dimh 1049089 231M Aug 29 16:56 S2A_20170831_171901_25XEL_B02.tif
-rw-r--r-- 1 dimh 1049089 231M Aug 29 16:57 S2A_20170831_171901_25XEL_B03.tif
-rw-r--r-- 1 dimh 1049089 231M Aug 29 16:57 S2A_20170831_171901_25XEL_B04.tif

$ terracotta optimize-rasters * .tif -o optimized/

Optimizing rasters: 100% | ██████████████████████████ | [05: 16< 00:00, file = S2A_20170831_...25XEL_B04.tif]

2. Создайте базу данных на основе шаблона имени файла.

$ terracotta ingest optimized/S2A_{date}_{}_{tile}_{band}.tif -o greenland.sqlite
Ingesting raster files: 100% | ███████████████████████████████████████████ | 6/6 [00: 49< 00:00,  8.54s/it]

3. Подавайте

$ terracotta serve -d greenland.sqlite
 * Serving Flask app " terracotta.server " (lazy loading)
 * Environment: production
   WARNING: Do not use the development server in a production environment.
   Use a production WSGI server instead.
 * Debug mode: off
 * Running on http://localhost:5000/ (Press CTRL+C to quit)

4. Исследуйте работающий сервер

Вручную

Вы можете использовать любой клиент с поддержкой HTTP, например curl .

$ curl localhost:5000/datasets ? tile=25XEL
{ " page " :0, " limit " :100, " datasets " :[{ " date " : " 20170831 " , " tile " : " 25XEL " , " band " : " B02 " },{ " date " : " 20170831 " , " tile " : " 25XEL " , " band " : " B03 " },{ " date " : " 20170831 " , " tile " : " 25XEL " , " band " : " B04 " }]}

Современные браузеры (например, Chrome или Firefox) отображают JSON в виде дерева.

Интерактивно

Terracotta также включает веб-клиент. Вы можете запустить клиент (при условии, что сервер работает по адресу http://localhost:5000), используя

$ terracotta connect localhost:5000
 * Serving Flask app " terracotta.client " (lazy loading)
 * Environment: production
   WARNING: Do not use the development server in a production environment.
   Use a production WSGI server instead.
 * Debug mode: off
 * Running on http://127.0.0.1:5100/ (Press CTRL+C to quit)

Затем откройте страницу клиента (в данном случае http://127.0.0.1:5100/) в браузере.

Разработка

Мы с радостью принимаем отчеты об ошибках и запросы на включение через GitHub. Чтобы ваш код был полезным, убедитесь, что он покрыт тестами и удовлетворяет нашим практикам проверки (с помощью mypy и flake8 ).

Для запуска тестов достаточно установить необходимые зависимости через

$ pip install -e .[test]

Затем вы можете запустить

$ pytest

из корня репозитория.