📝 Help & Feedback

EN: We kindly ask you to take a minute and share your feedback about using the plugin. It will help us improve the project. Please fill out the form by the link below:

RU: Пожалуйста, уделите минуту и поделитесь обратной связью об использовании плагина. Это поможет нам улучшить проект. Заполните форму по ссылке ниже:

👉 Submit Feedback / Отправить отзыв

Form includes:

EN | RU

Space Trace Plugin for QGIS — User Guide

Introduction

Space Trace is a QGIS plugin for visualizing and analyzing satellite orbits. It allows you to fetch, process, and display orbital tracks using TLE or OMM data from the SpaceTrack API or local files. The plugin supports advanced search, custom queries, and flexible export options for geospatial analysis.

Installation & Dependencies

  1. Open the OSGeo4W Shell (included with QGIS).
  2. Install required Python libraries: 
    python3 -m pip install pyorbital -U --user
python3 -m pip install spacetrack -U --user
python3 -m pip install poliastro -U --user
python3 -m pip install skyfield -U --user
  3. Restart QGIS after installation.
If you encounter import errors, ensure you are using the correct Python environment bundled with QGIS.

Features Overview

Step-by-Step Usage

  1. Open the plugin: Vector menu → Space Trace > Draw flight path.
  2. Select data source:
    • Local File: Browse and select one or more TLE/OMM files.
    • SpaceTrack API: Enter your SpaceTrack login and password.
  3. Set satellite(s):
    • For API: Enter NORAD IDs (single, range, or comma-separated list), or use the Search button.
    • For local: Satellite IDs are inferred from files.
  4. Configure Date/Time, Duration, and Step (min).
  5. Choose Output:
    • Leave blank for temporary layers, or specify file/folder and format.
    • For multiple satellites, use directory|format (e.g., C:/output|shp).
  6. Enable Add to project and Create line layer as needed.
  7. Optionally enable Save TLE/OMM data and specify path.
  8. Click Execute to generate tracks. Progress and logs appear in the Log tab.
Use the Help tab in the plugin for quick access to this guide.

Advanced Options & Tips

FAQ & Troubleshooting

Q: I get an error about missing dependencies.
A: Make sure you installed all required Python packages in the QGIS Python environment.
Q: My output file is not created or is empty.
A: Check that the output path is valid and writable. For multiple satellites, use a directory with format (e.g., C:/output|shp).
Q: SpaceTrack login fails.
A: Double-check your credentials and internet connection. SpaceTrack may block accounts after too many failed attempts.
Q: The plugin UI is in the wrong language.
A: The language is set by QGIS. Change your QGIS locale in settings and restart.
Q: How do I process a custom list of satellites?
A: Use the search or custom query dialog, select satellites, and confirm. Their NORAD IDs will be used for track generation.
Q: Where are logs saved?
A: See the Log tab in the plugin, or open SpaceTracePlugin.log in the plugin directory.

Feedback & Support

We value your feedback! Please fill out our form to help us improve the plugin:

Submit Feedback / Отправить отзыв

Плагин Space Trace для QGIS — Руководство пользователя

Введение

Space Trace — это плагин для QGIS, предназначенный для визуализации и анализа орбит спутников. Позволяет получать, обрабатывать и отображать траектории по данным TLE или OMM из SpaceTrack API или локальных файлов. Поддерживает расширенный поиск, пользовательские запросы и гибкий экспорт для геоаналитики.

Установка и зависимости

  1. Откройте OSGeo4W Shell (идет в комплекте с QGIS).
  2. Установите необходимые библиотеки Python: 
    python3 -m pip install pyorbital -U --user
python3 -m pip install spacetrack -U --user
python3 -m pip install poliastro -U --user
python3 -m pip install skyfield -U --user
  3. Перезапустите QGIS после установки.
Если возникают ошибки импорта, убедитесь, что используете правильную среду Python из QGIS.

Обзор возможностей

Пошаговое использование

  1. Откройте плагин: меню Вектор → Space Trace > Нарисовать траекторию полета.
  2. Выберите источник данных:
    • Локальный файл: выберите один или несколько файлов TLE/OMM.
    • SpaceTrack API: введите логин и пароль от SpaceTrack.
  3. Укажите спутники:
    • Для API: введите NORAD ID (один, диапазон или список через запятую) или используйте кнопку Поиск.
    • Для локальных файлов: спутники определяются по файлам.
  4. Настройте дату/время, длительность и шаг (мин.).
  5. Выберите вывод:
    • Оставьте пустым для временных слоев или укажите файл/папку и формат.
    • Для нескольких спутников используйте папка|формат (например, C:/output|shp).
  6. Включите Добавить в проект и Создать линейный слой по необходимости.
  7. При необходимости включите Сохранить TLE/OMM и укажите путь.
  8. Нажмите Выполнить для построения траекторий. Прогресс и логи — во вкладке Лог.
Для быстрого доступа к справке используйте вкладку Help в плагине.

Расширенные опции и советы

Вопросы и решения

В: Ошибка о недостающих зависимостях.
О: Убедитесь, что все необходимые библиотеки Python установлены в среде QGIS.
В: Файл вывода не создается или пустой.
О: Проверьте, что путь вывода существует и доступен для записи. Для нескольких спутников используйте папку с форматом (например, C:/output|shp).
В: Не удается войти в SpaceTrack.
О: Проверьте правильность логина и пароля, а также интернет-соединение. После нескольких неудачных попыток аккаунт может быть временно заблокирован.
В: Интерфейс плагина не на том языке.
О: Язык определяется настройками QGIS. Измените локаль в настройках и перезапустите QGIS.
В: Как обработать список спутников?
О: Используйте окно поиска или конструктор запросов, выберите спутники и подтвердите. Их NORAD ID будут использованы для построения траекторий.
В: Где хранятся логи?
О: Смотрите вкладку Лог в плагине или откройте SpaceTracePlugin.log в папке плагина.

Обратная связь и поддержка

Мы ценим ваши отзывы! Пожалуйста, заполните форму, чтобы помочь нам улучшить плагин:

Отправить отзыв / Submit Feedback