В данном разделе описаны функции, использующиеся для получения ответов от сервиса и примеры их работы.
В первой ячейке раздела описаны следующие функции:
- Функция get_root() — используется для проверки работоспособности соединения возвращает json-файл с сообщением «Welcome to API!», если работоспособность сервиса не нарушена, иначе возвращает код ошибки и ее описание.
- Функция get_last_forecast() — используется для получения прогноза на последнюю доступную дату в формате xarray.Dataset, если работоспособность сервиса не нарушена, иначе возвращает код ошибки и ее описание. Получаемый датасет содержит прогнозные значения для четырех переменных: sithick_GLORYS, usi_vsi_GLORYS_speed, usi_vsi_GLORYS_direct, sea_ice_fraction_OSTIA — на следующие трое суток, относительно последней известной даты. Пример прогноза приведён на Рисунке 1.
- Функция get_forecast_on_the_date(date) — используется для получения прогноза на заданную дату — date (передаётся в функцию в формате строки вида “YYYY-MM-DD”), в формате xarray.Dataset, если работоспособность сервиса не нарушена, иначе возвращает код ошибки и ее описание. Получаемый датасет содержит прогнозные значения для четырех переменных: sithick_GLORYS, usi_vsi_GLORYS_speed, usi_vsi_GLORYS_direct, sea_ice_fraction_OSTIA — на следующие трое суток, относительно заданной даты. Пример прогноза приведён на Рисунке 2
- Функция get_forecast_info() — используется для получения json-файла со справочной информацией, содержащей словарь доступных дат, граничные координаты рассматриваемого региона по широте и долготе, значение частоты обновления и дату последнего обновления, если работоспособность сервиса не нарушена, иначе возвращает код ошибки и ее описание.
- Функция get_last_assim_forecast() — используется для получения ассимилированного прогноза на последнюю доступную дату в формате xarray.Dataset, если работоспособность сервиса не нарушена, иначе возвращает код ошибки и ее описание. Получаемый датасет содержит ассимилированные прогнозные значения для переменной sea_ice_fraction_OSTIA на следующие трое суток, относительно последней известной даты. Пример прогноза приведён на Рисунке 3.
- Функция get_assim_forecast_on_the_date(date) — используется для получения ассимилированного прогноза на заданную дату — date (передаётся в функцию в формате строки вида “YYYY-MM-DD”), в формате xarray.Dataset, если работоспособность сервиса не нарушена, иначе возвращает код ошибки и ее описание. Получаемый датасет содержит ассимилированные прогнозные значения для переменной sea_ice_fraction_OSTIA на следующие трое суток, относительно заданной даты. Пример прогноза приведён на Рисунке 4.
- Функция get_assim_forecast_info() — используется для получения json-файла со справочной информацией, содержащей словарь доступных дат, граничные координаты рассматриваемого региона по широте и долготе, значение частоты обновления и дату последнего обновления, если работоспособность сервиса не нарушена, иначе возвращает код ошибки и ее описание.
- Функция get_model_metrics() — используется для получения json-файла со справочной информацией, содержащей список словарей с id модели и словарём её метрик: ice_conc_mae, ice_drift_speed_mae, ice_drift_speed_rmse, ise_thickness_rmse, если работоспособность сервиса не нарушена, иначе возвращает код ошибки и ее описание.
- Функция get_model_architectures() — используется для получения json-файла со справочной информацией, содержащей словарь с id модели и описанием её архитектуры и если работоспособность сервиса не нарушена, иначе возвращает код ошибки и ее описание.
- Функция get_datasets() — используется для получения json-файла со справочной информацией, содержащей словарь с id датасета и словарём его метаданных со следующими ключами: названием, описанием, словарём с источниками данных, словарём с используемыми переменными из этих источников, словарём со ссылками на эти источники, словарём с временными разрешениями источников и словарём с пространственными разрешениями источников. Если работоспособность сервиса нарушена, то функция возвращает код ошибки и ее описание.
- Функция login(email: str, password: str) — используется для авторизации пользователя в системе. Значения email и password передаются в функцию в виде строк. Если работоспособность сервиса нарушена, то функция возвращает код ошибки и ее описание.
- Функция logout() — используется для выхода пользователя из системы в текущей сессии. Если работоспособность сервиса нарушена, то функция возвращает код ошибки и ее описание.
- Функция register(email: str, password: str, username: str) — используется для регистрации пользователя с соответствующими почтой, паролем и ником в системе. Значения email, password и username передаются в функцию в виде строк. Если работоспособность сервиса нарушена, то функция возвращает код ошибки и ее описание.
- Функция get_ping(email: str, password: str, username: str) — используется для проверки качества и скорости соединения с сервером, на котором развернут сервис. Если работоспособность сервиса нарушена, то функция возвращает код ошибки и ее описание.
Во второй по счёту ячейке с кодом приведены примеры исполнения функций login(), get_root(), get_forecast_info(), get_model_metrics(), get_model_architectures(), get_datasets(). Результаты исполнения выведены в под ячейкой.
В третьей, четвёртой и пятой ячейках с кодом приведены время работы функции get_last_forecst(), get_forecast_on_the_date('2024-06-15') и get_last_forecast() соответственно. Результаты выведены под ячейками.