Method from_tle

backend/orbit.py:194–255

由 TLE 两行根数构造 OrbitalElements，轨道根数从 TLE 解析填充。 SGP4 传播时直接使用 TLE 数据；轨道根数字段仅用于回退和元数据。 参数 ---- name : str 卫星名称。 sat_id : str 系统内部卫星 ID。 tle_line1 : str TLE 第一行。 tle_line2 : str TLE 第二行。 epoch

(cls, name: str, sat_id: str,
                 tle_line1: str, tle_line2: str,
                 epoch=None,
                 j2_perturbation=True)

    @classmethod
    def from_tle(cls, name: str, sat_id: str,
                 tle_line1: str, tle_line2: str,
                 epoch=None,
                 j2_perturbation=True) -> "OrbitalElements":
        """由 TLE 两行根数构造 OrbitalElements，轨道根数从 TLE 解析填充。

        SGP4 传播时直接使用 TLE 数据；轨道根数字段仅用于回退和元数据。

        参数
        ----
        name : str
            卫星名称。
        sat_id : str
            系统内部卫星 ID。
        tle_line1 : str
            TLE 第一行。
        tle_line2 : str
            TLE 第二行。
        epoch : datetime, optional
            TLE 历元（None 则从 TLE 解析，回退 datetime.now()）。

        返回
        ----
        OrbitalElements
            带有 TLE 字段的实例，propagate() 将走 SGP4 路径。
        """
        # 从 TLE 第二行解析轨道根数（用于回退/元数据）
        try:
            fields = tle_line2.split()
            inclination = float(fields[2])
            raan = float(fields[3])
            eccentricity = float("0." + fields[4])
            arg_perigee = float(fields[5])
            mean_anomaly = float(fields[6])
            mean_motion_rev_day = float(fields[7][:11])
            # 由平运动推算半长轴 (km)
            mu = 398600.4418
            n_rad_s = mean_motion_rev_day * 2.0 * math.pi / 86400.0
            semi_major_axis = (mu / (n_rad_s ** 2)) ** (1.0 / 3.0)
        except (IndexError, ValueError):
            # TLE 解析失败时使用保守默认值（SGP4 仍可正常运行）
            inclination = 0.0
            raan = 0.0
            eccentricity = 0.0
            arg_perigee = 0.0
            mean_anomaly = 0.0
            semi_major_axis = 7000.0  # ~629 km LEO

        return cls(
            name=name,
            sat_id=sat_id,
            semi_major_axis=semi_major_axis,
            eccentricity=eccentricity,
            inclination=inclination,
            raan=raan,
            arg_perigee=arg_perigee,
            mean_anomaly=mean_anomaly,
            epoch=epoch,