このページは機械翻訳を使用して翻訳されました。最新版の英語を参照するには、ここをクリックします。

states

衛星またはプラットフォームの位置と速度を取得する

R2021a 以降

ページ内をすべて折りたたむ

    構文

    pos = states(sat)
    pos = states(pltf)
    [pos,velocity] = states(sat)
    [pos,velocity] = states(pltf)
    [___] = states(sat,timeIn)
    [___] = states(pltf,timeIn)
    [___] = states(___,CoordinateFrame=c)
    [pos,velocity,timeOut] = states(___)

    説明

    pos = states(sat) は、ベクトル sat 内の各衛星の位置履歴 pos の 3 x n x m 配列を返します。ここで、n は時間サンプルの数、m は衛星の数です。行は、地球中心天体基準座標系 (GCRF) における衛星の x、y、および z 座標を表します。

    pos = states(pltf) は、ベクトル pltf 内の各プラットフォームの位置履歴 pos の 3 x n x p 配列を返します。ここで、n は時間サンプルの数、p はプラットフォームの数です。行は、地球中心天体基準座標系 (GCRF) におけるプラットフォームの x、y、および z 座標を表します。

    [pos,velocity] = states(sat) は、GCRF のベクトル sat 内の各衛星の慣性速度 velocity の 3 x n x m 配列を返します。

    例

    [pos,velocity] = states(pltf) は、GCRF のベクトル pltf 内の各プラットフォームの慣性速度 velocity の 3 x n x p 配列を返します。

    [___] = states(sat,timeIn) は、指定された日時 timeIn の位置に加えて、出力の 1 つまたは両方を 3 x 1 x m 配列として返します。timeIn でタイム ゾーンが指定されていない場合、タイム ゾーンは協定世界時(UTC) であると見なされます。

    [___] = states(pltf,timeIn) は、指定された日時 timeIn の位置に加えて、出力の 1 つまたは両方を 3 x 1 x p 配列として返します。timeIn でタイム ゾーンが指定されていない場合、タイム ゾーンは協定世界時(UTC) であると見なされます。

    [___] = states(___,CoordinateFrame=c) は、c で指定された座標の出力を返します。

    [pos,velocity,timeOut] = states(___) は、衛星またはプラットフォームの位置、速度履歴、および対応する日時を UTC で返します。

    例

    すべて折りたたむ

    ライブ スクリプトを開く

    衛星シナリオ オブジェクトを作成します。

    startTime = datetime(2021,5,25);                      % May 25, 2021, 12:00 AM UTC
stopTime = datetime(2021,5,26);                       % May 26, 2021, 12:00 AM UTC
sampleTime = 60;                                      % In seconds
sc = satelliteScenario(startTime,stopTime,sampleTime);

    シナリオに衛星を追加します。

    tleFile = "eccentricOrbitSatellite.tle";
sat = satellite(sc,tleFile);

    2021 年 5 月 25 日PM10 時 30 分 (UTC) に対応する地球中心の地球固定(ECEF) フレームでの衛星の位置と速度を取得します。

    time = datetime(2021,5,25,22,30,0);
[position,velocity] = states(sat,time,"CoordinateFrame","ecef")
    position = 3×1
107 ×

   -0.9001
   -3.0897
    2.6716


    velocity = 3×1
103 ×

   -1.2151
    0.4417
   -1.7198

    入力引数

    すべて折りたたむ

    衛星、Satellite オブジェクトの行ベクトルとして指定されます。

    プラットフォーム。Platform オブジェクトの行ベクトルとして指定されます。

    出力が計算される時間。datetime スカラーとして指定されます。timeIn でタイム ゾーンが指定されていない場合、タイム ゾーンは UTC であると見なされます。

    出力が返される座標系。'inertial'、'ecef'、または 'geographic' として指定されます。

    • 'inertial' オプションは、GCRF 内の位置と速度の座標を返します。

    • 'ecef' オプションは、ECEF フレーム内の位置と速度の座標を返します。ECEF フレームの詳細については、Earth-Centered Earth-Fixed Coordinates を参照してください。

    • 'geographic' オプションは位置を [lat; lon; altitude] として返します。ここで、lat と lon は度単位の緯度と経度、高度はメートル単位の地球表面からの高さです。返される速度は、North-East-Down (NED) フレームです。

    出力引数

    すべて折りたたむ

    衛星の位置履歴（メートル単位）。3 x n x m の配列として返されます。n は時間サンプルの数、m は衛星の数です。位置値のタイプは、座標系の入力値によって異なります。

    衛星シナリオの AutoSimulate プロパティが true の場合、 StartTime から StopTime までの位置履歴が返されます。それ以外の場合は、StartTime から SimulationTime までの位置履歴が返されます。

    衛星の速度履歴（メートル/秒）が、3 x n x m の配列として返されます。n は時間サンプルの数、m は衛星の数です。速度値のタイプは、座標系の入力値によって異なります。

    衛星の位置と速度の時間サンプルが、スカラーまたはベクトルとして返されます。衛星の位置と速度の時間履歴が返される場合、timeOut は行ベクトルになります。

    バージョン履歴

    R2021a で導入

    参考

    オブジェクト

    関数

    トピック