Добавление собственных пользовательских показателей в ваше рабочее пространство

Этот перевод выполнен с помощью искусственного интеллекта и может содержать ошибки.

Публичная платформа UNBL в настоящее время предлагает одиннадцать динамических метрик по умолчанию (см. «Какие динамические метрики доступны для моей страны?»).

Рабочие пространства UNBL позволяют пользователям настраивать собственные пользовательские метрики для выполнения вычислений «на лету» и отображения зональной статистики для интересующих пользователя территорий на основе загруженных ими геопространственных слоёв данных.

Настройка пользовательской метрики в рабочем пространстве включает 5 шагов. Каждый шаг подробно описан в данном разделе.

Шаг 1: Загрузите место

Метрики отображаются на UNBL после выбора конкретного места, которое определяет область интереса, для которой рассчитывается зональная статистика. Поэтому необходимо загрузить в рабочее пространство место, для которого вы хотите просматривать пользовательскую метрику. Подробные инструкции по загрузке места в рабочее пространство см. в разделе «Как добавить места?».

Шаг 2: Загрузите растровый слой в формате GeoTIFF

Для создания пользовательской метрики необходимо загрузить растровый слой, для которого вы хотите просматривать зональную статистику. Рабочие пространства UNBL поддерживают вычисление метрик только с использованием слоёв, загруженных в рабочее пространство через опцию «Загрузка файла GeoTIFF». Подробные инструкции по загрузке слоя с помощью этой опции см. в разделе «Как загружать растровые слои в формате GeoTIFF?».

Для корректной работы пользовательской метрики на UNBL необходимо учитывать следующие технические предварительные условия для загружаемых слоёв GeoTIFF:

• GeoTIFF может представлять любой вид непрерывных или категориальных данных, однако значения пикселей должны быть целочисленного или вещественного типа;

• Для категориальных данных рекомендуется, чтобы GeoTIFF содержал не более 25 дискретных целочисленных классов; большее число классов снижает читаемость графиков метрик;

• Зональная статистика для пользовательской метрики может быть рассчитана только для слоёв GeoTIFF, охватывающих загруженное место. Если выбранное на карте UNBL место пространственно не перекрывается со слоем GeoTIFF, для которого настроена пользовательская метрика, метрика вернёт пустой график данных.

• Можно настроить метрику временного ряда, отображающую изменения во времени для нескольких слоёв GeoTIFF; в таких случаях все слои GeoTIFF должны иметь одинаковые атрибуты, например диапазоны минимальных/максимальных значений для непрерывных данных или определения категорий (т. е. конфигурацию легенды) для категориальных данных.

Пользователи, желающие настроить пользовательские метрики для векторных полигональных данных, должны сначала конвертировать их в растровый формат GeoTIFF с помощью методов растеризации. Примеры методов растеризации можно найти в онлайн-документации QGIS, PyGIS и rdrr.io. Для минимизации ошибок в расчётах метрик, которые могут возникнуть при растеризации векторных данных, рекомендуется:

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

• Преобразовать векторные данные в единую проецируемую систему координат, например WGS84 (EPSG: 4326), до растеризации;

• Перекрывающиеся полигоны следует разрешить с помощью приоритета записи пикселей при растеризации — например, подходов «последнее нарисованное» или «победа наибольшего значения»;

• Выбрать подходящее растровое разрешение с учётом компромисса между минимизацией краевых ошибок при преобразовании границ полигонов в пиксели и минимизацией размера файла (слои, загружаемые в рабочее пространство UNBL через опцию «Загрузка файла GeoTIFF», не могут превышать 1000 МБ).

Шаг 3: Создайте метрику

Создание метрики предполагает выбор слоёв GeoTIFF в рабочем пространстве, которые будут использоваться для расчёта зональной статистики. Для создания метрики:

1. Нажмите кнопку «Home» на странице администратора вашего рабочего пространства, чтобы развернуть выпадающее меню. Выберите «Metrics».

2. Нажмите появившуюся кнопку «CREATE NEW METRIC».

   

3. На странице новой метрики заполните следующую информацию:

   a) Title: Название метрики. Оно должно описывать содержимое набора данных, для которого настраивается метрика. Оно может совпадать с названием загруженного слоя GeoTIFF.

   b) Metric slug: Слаг — это уникальный идентификатор метрики в рабочем пространстве. В рабочем пространстве не может быть нескольких метрик с одинаковым слагом. Он должен содержать только буквы, цифры и дефисы («-»). Для генерации уникального идентификатора на основе указанного названия метрики можно использовать кнопку «GENERATE SLUG NAME».

   c) Metric data source(s): Выберите из выпадающего списка слой GeoTIFF, загруженный в ваше рабочее пространство. Для пользовательских метрик, отображающих изменения во времени, есть возможность выбрать несколько слоёв GeoTIFF с помощью кнопки «ADD ADDITIONAL DATA SOURCE». Используйте эту опцию только при наличии ряда слоёв GeoTIFF с единой схемой атрибутов, например диапазонами минимальных/максимальных значений для непрерывных данных или определениями категорий (т. е. конфигурацией легенды) для категориальных данных.

   d) Histogram bins: Это обязательное поле появляется при выборе слоя GeoTIFF с категорией непрерывных данных. Метрика будет использовать гистограмму для расчёта зональной статистики по слоям непрерывных данных. Поэтому необходимо указать количество интервалов (бинов) вычисляемой гистограммы. Бины — это интервалы, которые делят диапазон числовых данных в слое GeoTIFF на группы равной ширины. Выберите число, обеспечивающее достаточное количество интервалов для диапазона и разброса ваших данных. В большинстве случаев оптимально от 5 до 20 бинов, однако это зависит от конкретного диапазона данных.

   e) Calculate for place types (optional): При необходимости можно выбрать тип места, для которого пользовательская метрика должна отображать статистику. Это полезно, например, для метрики прибрежной эвтрофикации, охватывающей только места морской категории. Однако если слой данных для метрики не предназначен для конкретной территории, это поле следует оставить пустым.

   f) После указания всех параметров кнопка «SAVE AND VIEW DETAILS» выделится синим цветом при условии, что все введённые данные корректны. Нажмите эту кнопку, чтобы настроить метрику в рабочем пространстве.

   

4. На появившейся странице редактирования метрики включите переключатель «Published», чтобы опубликовать метрику.

Шаг 4: Создайте виджет

После настройки пользовательской метрики необходимо создать виджет для неё. Виджет определяет, как данные метрики будут визуализироваться и какую информацию они будут показывать в представлении карты UNBL. Для создания виджета:

1. Нажмите кнопку «Home» на странице администратора вашего рабочего пространства, чтобы развернуть выпадающее меню. Выберите «Widgets».

2. Нажмите появившуюся кнопку «CREATE NEW WIDGET».

   

3. На странице нового виджета заполните следующую информацию:

   a) Title: В идеале название виджета должно совпадать с названием метрики, настроенной на шаге 3. Это чётко связывает виджет с его метрикой.

   b) Widget slug: Слаг — это уникальный идентификатор виджета в рабочем пространстве. Он должен содержать только буквы, цифры и дефисы («-»). Для генерации уникального идентификатора на основе указанного названия метрики можно использовать кнопку «GENERATE SLUG NAME». В идеале слаг виджета должен совпадать со слагом метрики из шага 3.

   c) Description (optional): Создайте краткое описание виджета. Это должно быть общее описание данных, которые метрика отображает на UNBL. Поле необязательное.

   d) Metric: Выберите метрику, созданную на шаге 3, для связи с виджетом.

   e) Widget Layer(s): В этом поле указывается слой данных, который можно визуализировать на карте UNBL вместе с метрикой. Оно автоматически заполняется слоем GeoTIFF, связанным с выбранной метрикой. При необходимости можно добавить дополнительные слои из выпадающего меню. Однако это не рекомендуется, если только в рабочем пространстве нет дополнительных слоёв, не используемых для расчёта метрики, но полезных для добавления контекстной геопространственной информации.

   f) Widget Chart: Определяет тип диаграммы для визуализации статистики метрики для вашего места. В таблице ниже представлен обзор доступных типов диаграмм в зависимости от типа виджета, который автоматически определяется на основе а) типа данных слоя GeoTIFF — категориальные (дискретные классы) или непрерывные (диапазон числовых значений), и б) количества слоёв в метрике — один слой или несколько (метрика временного ряда).

   	Непрерывные данные	Категориальные данные
   Один слой	Гистограмма	Круговая диаграмма Столбчатая диаграмма
   Временной ряд	Линейный график Диаграмма с областями	Диаграмма с областями

   Тип диаграммы виджета	Отображение данных
   Гистограмма	Разделяет числовой диапазон данных на интервалы равной ширины (бины). Количество отображаемых бинов соответствует числу бинов, настроенных на странице метрики в серверной части. Ось X отображает измеряемую переменную, ось Y — измеренную площадь в км2 области интереса.
   Диаграмма с областями	Для непрерывных данных также разделяет числовой диапазон на бины, соответствующие числу бинов, настроенных на странице метрики. Для категориальных данных используются отдельные классы. Ось X отображает время, ось Y — процент от общей площади области интереса.
   Круговая диаграмма	Отображает пропорциональный охват каждого категориального класса в области интереса в виде секторов, в сумме составляющих 100%.
   Столбчатая диаграмма	Отображает каждый категориальный класс в виде столбца; ось X показывает измеряемые данные, ось Y — измеренную площадь в км2 области интереса.
   Линейный график	Отображает изменение среднего значения между различными непрерывными наборами данных в метрике временного ряда. Ось X отображает время, ось Y — измеренное среднее значение каждого набора данных.

   f)i) Widget summary (optional): Создаёт сводку ключевых статистических показателей метрики, которая будет отображаться виджетом. Список доступных полей сводки предоставляет параметры, которые можно использовать в тексте сводки. Пример сводки виджета для метрики временного ряда с тремя слоями, показывающими Индекс антропогенной трансформации за три периода, показан ниже.

   

   Когда эта метрика и связанный с ней виджет активны на UNBL, поля сводки в тексте автоматически заполняются необходимыми параметрами, как показано ниже.

   

   В качестве альтернативы, сводка виджета для метрики с одним слоем Индекса антропогенной трансформации будет использовать следующие поля:

   • {location}: название текущего места
   • {areaKm2}: картируемая площадь в квадратных километрах
   • {mean}: среднее значение в виде числа

   Сводка виджета будет выглядеть примерно так:

   "In {location}, {areaKm2} square kilometers had a mean HMI score of {mean} in 2022."
   

   

   f)ii) Для метрик, созданных с использованием категориального слоя, доступна дополнительная опция переключателя Use layer categories.

   По умолчанию опция включена и указывает, что категориальный график виджета должен использовать те же категории слоя, что и настроенные для связанного растрового слоя на UNBL. Если пользователи хотят использовать категории графика виджета, отличные от указанных в связанном растровом слое, им следует отключить опцию Use layer categories. После этого пользователю будет предложено указать исчерпывающий список категорий для графика, причём для каждой категории необходимо заполнить следующие параметры:

   • Label: Название категории

   • Colour: Палитра цветов для выбора цвета отображения соответствующей категории на графике виджета

   • Values: Уникальное(ые) число(а) в исходном слое данных, обозначающее(ие) настроенную категорию. Пользователь может указать несколько чисел для одной категории.

   

   g) X-Axis Label (optional): Для типов метрик с гистограммой, линейным графиком или диаграммой с областями можно указать подпись оси X. Подпись должна соответствовать отображаемой переменной данных. Поле необязательное.

   h) X-Axis Unit (optional): Для типов метрик с гистограммой, линейным графиком или диаграммой с областями можно указать единицы измерения переменной данных. Поле необязательное.

   i) После указания всех параметров кнопка «SAVE AND VIEW DETAILS» выделится синим цветом при условии, что все введённые данные корректны. Нажмите эту кнопку, чтобы создать виджет.

   

4. На появившейся странице редактирования виджета включите переключатель «Published», чтобы опубликовать виджет.

Шаг 5: Создайте дашборд

Дашборд служит пользовательским интерфейсом, который отображает метрику и связанный виджет в представлении карты UNBL при выборе места для просмотра метрик. Важно учитывать, что пользователи могут создавать любое количество метрик и виджетов, но все они могут быть размещены в одном дашборде. Поэтому достаточно создать один дашборд для всех метрик. Если в вашем рабочем пространстве ещё нет дашборда, выполните следующие шаги для его создания:

1. Нажмите кнопку «Home» на странице администратора вашего рабочего пространства, чтобы развернуть выпадающее меню. Выберите «Dashboards».

2. Нажмите появившуюся кнопку «CREATE NEW DASHBOARD».

   

3. На странице нового дашборда заполните следующую информацию:

   a) Title: Дашборд должен иметь название, чётко определяющее тематическую группу пользовательских метрик, связанных с ним. Например, дашборд может содержать все пользовательские метрики, определённые конкретным пользователем, и называться «Custom metrics by user x». Или дашборд может содержать метрики для конкретного места, например «Custom metrics for country x».

   b) Dashboard slug: Слаг — это уникальный идентификатор дашборда в рабочем пространстве. В рабочем пространстве не может быть нескольких дашбордов с одинаковым слагом. Он должен содержать только буквы, цифры и дефисы («-»). Для генерации уникального идентификатора на основе указанного названия дашборда можно использовать кнопку «GENERATE SLUG NAME».

   c) Dashboard description: Здесь можно дать краткое описание группы метрик. Например, «This dashboard contains custom metrics defined by user x.» Поле необязательное.

   d) Included Widgets: Выберите виджет(ы) для включения в дашборд.

   e) После указания всех параметров кнопка «SAVE AND VIEW DETAILS» выделится синим цветом при условии, что все введённые данные корректны. Нажмите эту кнопку, чтобы создать дашборд.

   

4. На появившейся странице редактирования дашборда включите переключатель «Published», чтобы опубликовать дашборд.

Note

Если у вас уже есть дашборд и вы хотите добавить в него новые виджеты, отредактируйте существующий дашборд и добавьте виджеты, нажав на значок карандаша рядом с записью дашборда в списке, который появляется на странице администратора после выбора «Dashboards» в выпадающем меню.

Просмотр дашбордов и виджетов

Для просмотра пользовательских метрик:

1. В представлении карты UNBL убедитесь, что ваше рабочее пространство включено.

   

2. Выберите место для просмотра пользовательских метрик на вкладке «PLACES».

   

3. Если наряду с вашим рабочим пространством активированы публичная платформа UNBL и/или другие рабочие пространства, возможно, потребуется выбрать дашборд с вашими пользовательскими метриками. В этом случае появится выпадающее меню со списком дашбордов и связанных рабочих пространств. Выберите свой дашборд из выпадающего меню.

   Note

   Если пользовательские метрики в вашем дашборде не перекрываются с активированным местом, ваш дашборд не появится в выпадающем меню.

   

4. Теперь вы можете просматривать пользовательские метрики, настроенные для выбранного слоя GeoTIFF и места. Все функциональные возможности динамических метрик UNBL по умолчанию доступны и для пользовательских метрик, включая переключение связанного слоя, просмотр информации и загрузку данных метрики в форматах .csv, .tsv и .json.