Memecahkan masalah ephemerides yang tidak valid - AWS Ground Station
Memahami kesalahan validasi ephemerisKesalahan validasi umum untuk ephemerides TLEKesalahan validasi umum untuk ephemerides OEMKesalahan validasi umum untuk ephemerides elevasi azimuthLangkah pemecahan masalahReferensi kode kesalahan lengkap

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memecahkan masalah ephemerides yang tidak valid

Saat Anda mengunggah data ephemeris ke AWS Ground Station, data tersebut akan melalui alur kerja validasi asinkron. Jika validasi gagal, status ephemeris akan berubah menjadi. INVALID Pesan kesalahan dalam DescribeEphemerisrespons memberikan informasi terperinci untuk membantu Anda mengidentifikasi dan menyelesaikan masalah.

Memahami kesalahan validasi ephemeris

Ketika ephemeris gagal validasi, respons DescribeEphemerisAPI mencakup dua bidang untuk membantu mendiagnosis masalah:

errorCode

Kode yang dapat dibaca mesin yang mengidentifikasi kesalahan validasi spesifik. Ini dapat digunakan untuk penanganan kesalahan terprogram.

errorMessage

Deskripsi kesalahan validasi yang dapat dibaca manusia dengan detail spesifik tentang apa yang salah dan panduan tentang cara memperbaikinya.

Contoh DescribeEphemerisrespons untuk ephemeris yang tidak valid: 

{
    "ephemerisId": "abc12345-6789-def0-1234-567890abcdef",
    "name": "My Invalid Ephemeris",
    "status": "INVALID",
    "creationTime": 1620254718.765,
    "invalidReason": "METADATA_INVALID",
    "errorCode": "OBJECT_NAME_MISSING",
    "errorMessage": "Metadata field missing: OBJECT_NAME",
    "suppliedData": {
        "tle": {
            "ephemerisData": "[...]"
        }
    }
}

Kesalahan validasi umum untuk ephemerides TLE

Berikut ini adalah kesalahan validasi umum yang ditemui saat mengunggah ephemerides TLE:

Nomor katalog satelit yang tidak cocok

Kesalahan: “Nomor katalog satelit yang ada di ephemeris tidak cocok dengan nomor katalog satelit satelit terkait”

Solusi: Verifikasi bahwa nomor ID/satellite katalog NORAD di baris TLE Anda cocok dengan nomor katalog satelit satelit satelit Anda. Gunakan 00000 untuk satelit tanpa nomor katalog yang ditetapkan.

Gerakan rata-rata tidak valid

Kesalahan: “Gerakan rata-rata dari ephemeris yang disediakan sangat berbeda dari referensi ephemeris terbaru”

Solusi: Verifikasi bahwa data TLE Anda benar dan mewakili orbit yang valid. Ground Station menggunakan ephemerides Space-Track sebagai referensi selama validasi.

Kesalahan validasi umum untuk ephemerides OEM

Berikut ini adalah kesalahan validasi umum yang ditemui saat mengunggah ephemerides OEM:

Kerangka referensi tidak valid

Kesalahan: “REF_FRAME tidak didukung”

Solusi: Perbarui file OEM Anda untuk menggunakan salah satu kerangka referensi yang didukung: EME2 000 atau ITRF2 000.

Kolom wajib tidak ada

Kesalahan: “Bidang metadata hilang: INTERPOLASI”

Solusi: Tambahkan bidang INTERPOLASI dan INTERPOLATION_DEGREE ke bagian metadata OEM Anda. Ini diperlukan AWS Ground Station untuk menghasilkan sudut penunjuk antena yang akurat.

Sistem waktu yang tidak didukung

Kesalahan: “TIME_SYSTEM tidak didukung”

Solusi: Pastikan file OEM Anda menggunakan UTC sebagai sistem waktu.

Versi OEM yang tidak didukung

Kesalahan: “CCSDS_OEM_VERS tidak didukung”

Solusi: Pastikan file OEM Anda menggunakan CCSDS OEM versi 2.0.

Kesalahan validasi umum untuk ephemerides elevasi azimuth

Berikut ini adalah kesalahan validasi umum yang ditemui saat mengunggah ephemerides elevasi azimuth:

azimuth/elevation Data hilang

Kesalahan: “Tidak ada TimeAzEl bidang yang ada di setidaknya satu AzElSegment”

Solusi: Pastikan setiap segmen dalam data elevasi azimuth Anda berisi setidaknya satu pasangan yang diberi tag waktu. azimuth/elevation

Rentang sudut azimuth (derajat) tidak valid

Kesalahan: "AzEl az harus lebih besar dari atau sama dengan -180 dan kurang atau sama dengan 360 derajat”

Solusi: Verifikasi bahwa sudut azimuth berada dalam [-180, 360] derajat.

Rentang sudut elevasi (derajat) tidak valid

Kesalahan: "AzEl el harus lebih besar dari atau sama dengan -90 dan kurang dari atau sama dengan 90 derajat”

Solusi: Verifikasi bahwa sudut elevasi berada dalam [-90, 90] derajat.

Rentang sudut azimuth (radian) tidak valid

Kesalahan: "AzEl az harus lebih besar dari atau sama dengan -pi dan kurang dari atau sama dengan 2pi radian”

Solusi: Verifikasi bahwa sudut azimuth berada dalam radian [-π, 2π].

Rentang sudut elevasi tidak valid (radian)

Kesalahan: "AzEl el harus lebih besar dari atau sama dengan -pi/2 dan kurang dari atau sama dengan pi/2 radian”

Solusi: Verifikasi bahwa sudut elevasi berada dalam radian [-π/2, π/2].

Nilai waktu non-monotonik

Kesalahan: “ TimeAzEl Item di dalam a AzElSegment harus berurutan sementara”

Solusi: Pastikan bahwa nilai waktu di setiap segmen meningkat secara ketat.

Segmen rusak

Kesalahan: "AzElSegments harus secara temporal dalam urutan”

Solusi: Pastikan segmen disusun dalam urutan kronologis.

Segmen yang tumpang tindih

Kesalahan: “Rentang waktu setidaknya satu segmen tumpang tindih dengan rentang waktu segmen lainnya”

Solusi: Pastikan setiap segmen memiliki rentang waktu yang unik dan tidak tumpang tindih. Satu endTime segmen tidak boleh melebihi startTime segmen berikutnya.

Langkah pemecahan masalah

Jika ephemeris Anda gagal validasi, ikuti langkah-langkah berikut untuk mengatasi masalah:

  1. Panggil DescribeEphemerisdengan ID ephemeris Anda untuk mengambil dan. errorCode errorMessage

  2. Tinjau pesan galat untuk detail spesifik tentang pemeriksaan validasi yang gagal.

  3. Perbaiki masalah yang diidentifikasi dalam data ephemeris Anda.

  4. Unggah ephemeris baru dengan data yang dikoreksi menggunakan. CreateEphemeris

  5. Pantau status ephemeris baru hingga mencapai keadaan. ENABLED

  6. Hapus ephemeris yang tidak valid menggunakan DeleteEphemerisjika tidak lagi diperlukan.

Referensi kode kesalahan lengkap

Bagian berikut memberikan pemetaan komprehensif dari semua errorCode nilai yang dapat dikembalikan ketika validasi ephemeris gagal, diatur oleh kategori tingkat tinggi. invalidReason

Alasan Tidak Valid: METADATA_INVALID

Kesalahan ini terjadi ketika bidang metadata yang diperlukan hilang, salah diformat, atau berisi nilai yang tidak didukung dalam data ephemeris.

Kode Kesalahan Pesan Kesalahan
MISMATCHED_SATCAT_ID Nomor katalog satelit yang ada di ephemeris TLE tidak cocok dengan nomor katalog satelit satelit terkait
OEM_VERSION_TIDAK DIDUKUNG CCSDS_OEM_VERSDalam ephemeris OEM tidak didukung. Nilai yang didukung: [2.0]
ORIGINATOR_MISSING Bidang ORIGINATOR header hilang dari ephemeris OEM
CREATION_DATE_MISSING Bidang CREATION_DATE header hilang dari ephemeris OEM
OBJECT_NAME_MISSING Bidang OBJECT_NAME metadata hilang dari ephemeris OEM
OBJECT_ID_MISSING Bidang OBJECT_ID metadata hilang dari ephemeris OEM
REF_FRAME_UNSUPPORTED REF_FRAMEDalam ephemeris OEM tidak didukung. Nilai yang didukung: [EME2000,ITRF2000]
REF_FRAME_EPOCH_UNSUPPORTED Bidang REF_FRAME_EPOCH metadata di ephemeris OEM tidak didukung. Harap hapus bidang ini dari ephemeris
TIME_SYSTEM_UNSUPPORTED TIME_SYSTEMDalam ephemeris OEM tidak didukung. Nilai yang didukung: [UTC]
CENTER_BODY_UNSUPPORTED CENTER_BODYDalam ephemeris OEM tidak didukung. Nilai yang didukung: [Earth]
INTERPOLASI_HILANG Bidang INTERPOLATION metadata hilang dari ephemeris OEM
INTERPOLATION_DEGREE_INVALID Tingkat interpolasi dalam ephemeris OEM harus lebih besar dari 0 untuk metode interpolasi
AZ_EL_SEGMENT_LIST_MISSING azElSegmentListBidang hilang
INSUFFICIENT_TIME_AZ_EL Tidak ada TimeAzElbidang yang ada di setidaknya satu azElSegmentList

Alasan Tidak Valid: TIME_RANGE_INVALID

Kesalahan ini terjadi ketika ephemeris berisi rentang waktu yang tidak valid, termasuk masalah dengan start/end waktu, urutan segmen, segmen yang tumpang tindih, atau inkonsistensi temporal.

Kode Kesalahan Pesan Kesalahan
START_TIME_IN_FUTURE Waktu mulai Ephemeris ada di masa depan, tetapi harus di masa lalu
END_TIME_IN_PAST Waktu akhir Ephemeris ada di masa lalu, tetapi harus di masa depan
KEDALUWARSA_TIME_TOO_EARLY Waktu kedaluwarsa yang diberikan lebih awal dari waktu akhir ephemeris
START_TIME_METADATA_TOO_EARLY Nilai START_TIME metadata lebih awal dari waktu paling awal yang ada dalam data ephemeris OEM
STOP_TIME_METADATA_TOO_LATE Nilai STOP_TIME metadata lebih lambat dari waktu terakhir yang ada dalam data ephemeris OEM
AZ_EL_SEGMENT_END_TIME_BEFORE_START_TIME Setidaknya satu segmen data sebelum segmen endTimestartTime
AZ_EL_SEGMENT_TIMES_TUMPANG TINDIH Rentang waktu setidaknya satu segmen tumpang tindih dengan rentang waktu segmen lainnya
AZ_EL_SEGMENTS_OUT_OF_ORDER Segmen tidak diurutkan secara temporal
TIME_AZ_EL_ITEMS_OUT_OF_ORDER TimeAzElItem di dalam a AzElSegmentharus secara temporal dalam urutan
AZ_EL_SEGMENT_REFERENCE_EPOCH_TIDAK VALID Epoch referensi untuk segmen tidak valid atau salah diformat
AZ_EL_SEGMENT_START_TIME_TIDAK VALID Waktu mulai dalam rentang waktu valid segmen tidak dimulai setelah segmen pertama
AZ_EL_SEGMENT_END_TIME_TIDAK VALID Waktu akhir dalam rentang waktu valid segmen tidak berakhir setelah segmen terakhir
AZ_EL_SEGMENT_VALID_TIME_RANGE_TIDAK VALID Rentang waktu yang valid untuk segmen tidak valid
AZ_EL_SEGMENT_END_TIME_TOO_LATE Waktu akhir suatu segmen melebihi durasi maksimum yang diizinkan dari zaman referensi
AZ_EL_TOTAL_DURATION_TERLAMPAUI Total durasi di semua segmen melebihi durasi sudut penunjuk maksimum yang diizinkan

Alasan Tidak Valid: TRAJECTORY_INVALID

Kesalahan ini terjadi ketika ephemeris berisi data lintasan yang tidak valid, termasuk masalah dengan parameter orbital, rentang sudut, atau unit.

Kode Kesalahan Pesan Kesalahan
MEAN_MOTION_INVALID Gerakan rata-rata ephemeris TLE yang disediakan sangat berbeda dari ephemeris referensi terbaru. Catatan: Ground Station menggunakan ephemerides Space-Track sebagai referensi selama validasi
TIME_AZ_EL_AZ_RADIAN_RANGE_TIDAK VALID AzEl azharus lebih besar dari atau sama dengan -π dan kurang dari atau sama dengan 2π radian
TIME_AZ_EL_EL_RADIAN_RANGE_TIDAK VALID AzEl elharus lebih besar dari atau sama dengan -π/2 dan kurang dari atau sama dengan π/2 radian
TIME_AZ_EL_AZ_DEGREE_RANGE_INVALID AzEl azharus lebih besar dari atau sama dengan -180 dan kurang atau sama dengan 360 derajat
TIME_AZ_EL_EL_DEGREE_RANGE_INVALID AzEl elharus lebih besar dari atau sama dengan -90 derajat dan kurang dari atau sama dengan 90 derajat
TIME_AZ_EL_ANGLE_UNITS_TIDAK VALID Satuan sudut tidak valid AzEl

Alasan Tidak Valid: KMS_KEY_INVALID

Kesalahan ini terjadi ketika ada masalah dengan kunci AWS Key Management Service (KMS) AWS Management Service yang digunakan untuk mengenkripsi data ephemeris.

Kode Kesalahan Pesan Kesalahan
INSUFFICIENT_KMS_PERMISSIONS Ground Station tidak memiliki izin yang cukup untuk mengakses kunci KMS ephemeris ini

Alasan Tidak Valid: VALIDATION_ERROR

Kesalahan ini terjadi ketika ada masalah validasi umum dengan data ephemeris yang tidak termasuk dalam kategori spesifik lainnya.

Kode Kesalahan Pesan Kesalahan
INTERNAL_ERROR Kesalahan internal terjadi selama validasi ephemeris
FILE_FORMAT_TIDAK VALID Format file ephemeris tidak valid atau rusak. Verifikasi file sesuai dengan format yang diharapkan untuk jenis ephemeris