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

groundTrack

シナリオ内の衛星またはプラットフォームに地上追跡オブジェクトを追加する

R2021a 以降

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

構文

groundTrack(sat)

groundTrack(pltf)

groundTrack(___,Name=Value)

説明

groundTrack(sat) は、sat 内の各衛星の現在の位置に基づいて、地上軌跡の視覚化を追加します。地上トラックはシナリオ StartTime から始まり、 StopTime で終わります。地上軌跡の視覚化を構成するサンプル間の間隔は、シナリオ SampleTime によって決定されます。ビューアーが開いていない場合は、新しいビューアーが起動され、地上トラックが表示されます。ビューアーがすでに開いている場合は、地上トラックがそのビューアーに追加されます。デフォルトでは、地上の軌跡は 2D で表示されます。

groundTrack(pltf) は、pltf 内の各プラットフォームの現在の位置に基づいて、地上の軌跡の視覚化を追加します。地上トラックはシナリオ StartTime から始まり、 StopTime で終わります。地上軌跡の視覚化を構成するサンプル間の間隔は、シナリオ SampleTime によって決定されます。ビューアーが開いていない場合は、新しいビューアーが起動され、地上トラックが表示されます。ビューアーがすでに開いている場合は、地上トラックがそのビューアーに追加されます。デフォルトでは、地上の軌跡は 2D で表示されます。

groundTrack(___,Name=Value) は、1 つ以上の名前と値のペアを使用して groundTrack オブジェクトを追加します。各プロパティ名を引用符で囲みます。

例

すべて折りたたむ

静止軌道上の衛星に地上トラックを追加する

ライブスクリプトを開く

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

startTime = datetime(2020,5,10);
stopTime = startTime + days(5);
sampleTime = 60;                                       % seconds
sc = satelliteScenario(startTime,stopTime,sampleTime);

静止衛星の半長軸を計算します。

earthAngularVelocity = 0.0000729211585530;                                             % rad/s
orbitalPeriod = 2*pi/earthAngularVelocity;                                             % seconds
earthStandardGravitationalParameter = 398600.4418e9;                                   % m^3/s^2
semiMajorAxis = (earthStandardGravitationalParameter*((orbitalPeriod/(2*pi))^2))^(1/3);

静止衛星の残りの軌道要素を定義します。

eccentricity = 0;
inclination = 60;                  % degrees
rightAscensionOfAscendingNode = 0; % degrees
argumentOfPeriapsis = 0;           % degrees
trueAnomaly = 0;                   % degrees

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

sat = satellite(sc,semiMajorAxis,eccentricity,inclination,rightAscensionOfAscendingNode,...
        argumentOfPeriapsis,trueAnomaly,"OrbitPropagator","two-body-keplerian","Name","GEO Sat");

衛星シナリオビューアーを使用してシナリオを視覚化します。

v = satelliteScenarioViewer(sc);

衛星の地上軌跡を視覚化に追加し、地上軌跡の将来と履歴をどの程度表示するかを調整します。

leadTime = 2*24*3600;                                          % seconds
trailTime = leadTime;
gt = groundTrack(sat,"LeadTime",leadTime,"TrailTime",trailTime)

gt = 
  GroundTrack with properties:

          LeadTime: 172800
         TrailTime: 172800
         LineWidth: 1
     LeadLineColor: [1 1 0.0670]
    TrailLineColor: [1 1 0.0670]
    VisibilityMode: 'inherit'

衛星の動きと地上での軌跡を視覚化します。衛星は一日のうち半分は日本周辺をカバーし、残りの半分はオーストラリアをカバーします。

play(sc);

入力引数

すべて折りたたむ

`sat` — 衛星
`Satellite` オブジェクトの行ベクトル

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

`pltf` — プラットフォーム
`Platform` オブジェクトの行ベクトル

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

名前と値の引数

すべて折りたたむ

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

例: LeadTime=3600 は、作成時に地上トラックのリードタイムを 3600 秒に設定します。

`Viewer` — 衛星シナリオビューア
`satelliteScenarioViewer` オブジェクトのベクトル (既定値) | スカラー `satelliteScenarioViewer` オブジェクト | `satelliteScenarioViewer` オブジェクトの配列

衛星シナリオビューアー。スカラー、ベクトル、または satelliteScenarioViewer オブジェクトの配列として指定されます。シナリオの AutoSimulate プロパティが false の場合、シナリオにサテライトを追加すると、以前に使用可能だったタイムラインおよび再生ウィジェットがすべて無効になります。

`LeadTime` — 地上軌跡を視覚化する期間
`StartTime` から `StopTime` または 1 軌道周期 (既定値) | 正のスカラー

衛星シナリオビューアーで視覚化される地上トラックの周期。'LeadTime' と秒単位の正のスカラーとして指定します。

既定値は次のとおりです。

衛星シナリオ StartTime から StopTime まで（OrbitPropagator が 'ephemeris' に設定されている場合）
軌道が放物線または双曲線で、OrbitPropagator が 'numerical' に設定されている場合の衛星シナリオ StartTime から StopTime
それ以外の場合は 1 軌道周期です。

`TrailTime` — 視覚化される地上軌跡の履歴の期間
`StartTime` を `StopTime` に設定する。 (既定値) | 正のスカラー

Viewer で視覚化される地上軌跡履歴の期間。'TrailTime' と秒単位の正のスカラーで指定します。

既定値は次のとおりです。

衛星シナリオ StartTime から StopTime まで（OrbitPropagator が 'ephemeris' に設定されている場合）
軌道が放物線または双曲線で、OrbitPropagator が 'numerical' に設定されている場合の衛星シナリオ StartTime から StopTime
それ以外の場合は 1 軌道周期です。

`LineWidth` — 地上軌跡の視覚的幅
`1` (既定値) | 範囲(0 10]のスカラー

地上トラックの視覚的な幅（ピクセル単位）。'LineWidth' と (0 10] の範囲のスカラーで指定します。

ライン幅をピクセルの幅より細くすることはできません。システムでライン幅をピクセルの幅より細い値に設定すると、ラインは 1 ピクセル幅で表示されます。

`LeadLineColor` — 将来の地上線路の色
`[1 0 1]` (既定値) | RGB 3 成分 | `RGB triplet` | `string scalar of color name` | `character vector of color name`

将来の地上トラックラインの色。'LeadLineColor' と RGB トリプレット、16 進カラーコード、色名、または短縮名として指定します。

カスタム色を使用する場合は、RGB 3 成分または 16 進数カラーコードを指定します。

RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。
16 進数カラーコードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く string スカラーまたは文字ベクトルです。この値は大文字と小文字を区別しません。したがって、カラーコード "#FF8800"、"#ff8800"、"#F80"、および "#f80" は等価です。

あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラーコードを示します。

色名	省略名	RGB 3 成分	16 進数カラーコード
`"red"`	`"r"`	`[1 0 0]`	`"#FF0000"`
`"green"`	`"g"`	`[0 1 0]`	`"#00FF00"`
`"blue"`	`"b"`	`[0 0 1]`	`"#0000FF"`
`"cyan"`	`"c"`	`[0 1 1]`	`"#00FFFF"`
`"magenta"`	`"m"`	`[1 0 1]`	`"#FF00FF"`
`"yellow"`	`"y"`	`[1 1 0]`	`"#FFFF00"`
`"black"`	`"k"`	`[0 0 0]`	`"#000000"`
`"white"`	`"w"`	`[1 1 1]`	`"#FFFFFF"`

MATLAB^® の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラーコードを次に示します。

RGB 3 成分	16 進数カラーコード	外観
`[0 0.4470 0.7410]`	`"#0072BD"`
`[0.8500 0.3250 0.0980]`	`"#D95319"`
`[0.9290 0.6940 0.1250]`	`"#EDB120"`
`[0.4940 0.1840 0.5560]`	`"#7E2F8E"`
`[0.4660 0.6740 0.1880]`	`"#77AC30"`
`[0.3010 0.7450 0.9330]`	`"#4DBEEE"`
`[0.6350 0.0780 0.1840]`	`"#A2142F"`

例: 'blue'

例: [0 0 1]

例: '#0000FF'

`TrailLineColor` — 地上トラックライン履歴の色
`[1 0.5 0]` (既定値) | RGB 3 成分 | `RGB triplet` | `string scalar of color name` | `character vector of color name`

地上トラックライン履歴の色。'TrailLineColor' と RGB トリプレット、16 進カラーコード、色名、または短縮名として指定します。

カスタム色を使用する場合は、RGB 3 成分または 16 進数カラーコードを指定します。

RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。
16 進数カラーコードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く string スカラーまたは文字ベクトルです。この値は大文字と小文字を区別しません。したがって、カラーコード "#FF8800"、"#ff8800"、"#F80"、および "#f80" は等価です。

色名	省略名	RGB 3 成分	16 進数カラーコード
`"red"`	`"r"`	`[1 0 0]`	`"#FF0000"`
`"green"`	`"g"`	`[0 1 0]`	`"#00FF00"`
`"blue"`	`"b"`	`[0 0 1]`	`"#0000FF"`
`"cyan"`	`"c"`	`[0 1 1]`	`"#00FFFF"`
`"magenta"`	`"m"`	`[1 0 1]`	`"#FF00FF"`
`"yellow"`	`"y"`	`[1 1 0]`	`"#FFFF00"`
`"black"`	`"k"`	`[0 0 0]`	`"#000000"`
`"white"`	`"w"`	`[1 1 1]`	`"#FFFFFF"`

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラーコードを次に示します。

RGB 3 成分	16 進数カラーコード	外観
`[0 0.4470 0.7410]`	`"#0072BD"`
`[0.8500 0.3250 0.0980]`	`"#D95319"`
`[0.9290 0.6940 0.1250]`	`"#EDB120"`
`[0.4940 0.1840 0.5560]`	`"#7E2F8E"`
`[0.4660 0.6740 0.1880]`	`"#77AC30"`
`[0.3010 0.7450 0.9330]`	`"#4DBEEE"`
`[0.6350 0.0780 0.1840]`	`"#A2142F"`

例: 'blue'

例: [0 0 1]

例: '#0000FF'

バージョン履歴

R2021a で導入

参考

オブジェクト

satelliteScenario | satelliteScenarioViewer | GroundTrack | Orbit | Satellite | Platform

関数

show | play | groundStation | access | hide | satellite | platform (Satellite Communications Toolbox)

groundTrack

構文

説明

例

静止軌道上の衛星に地上トラックを追加する

入力引数

sat — 衛星 Satellite オブジェクトの行ベクトル

pltf — プラットフォーム Platform オブジェクトの行ベクトル

名前と値の引数

Viewer — 衛星シナリオビューア satelliteScenarioViewer オブジェクトのベクトル (既定値) | スカラー satelliteScenarioViewer オブジェクト | satelliteScenarioViewer オブジェクトの配列

LeadTime — 地上軌跡を視覚化する期間 StartTime から StopTime または 1 軌道周期 (既定値) | 正のスカラー

TrailTime — 視覚化される地上軌跡の履歴の期間 StartTime を StopTime に設定する。 (既定値) | 正のスカラー

LineWidth — 地上軌跡の視覚的幅 1 (既定値) | 範囲(0 10]のスカラー

LeadLineColor — 将来の地上線路の色 [1 0 1] (既定値) | RGB 3 成分 | RGB triplet | string scalar of color name | character vector of color name

TrailLineColor — 地上トラックライン履歴の色 [1 0.5 0] (既定値) | RGB 3 成分 | RGB triplet | string scalar of color name | character vector of color name

バージョン履歴

参考

オブジェクト

関数

トピック

`sat` — 衛星
`Satellite` オブジェクトの行ベクトル

`pltf` — プラットフォーム
`Platform` オブジェクトの行ベクトル

`Viewer` — 衛星シナリオビューア
`satelliteScenarioViewer` オブジェクトのベクトル (既定値) | スカラー `satelliteScenarioViewer` オブジェクト | `satelliteScenarioViewer` オブジェクトの配列

`LeadTime` — 地上軌跡を視覚化する期間
`StartTime` から `StopTime` または 1 軌道周期 (既定値) | 正のスカラー

`TrailTime` — 視覚化される地上軌跡の履歴の期間
`StartTime` を `StopTime` に設定する。 (既定値) | 正のスカラー

`LineWidth` — 地上軌跡の視覚的幅
`1` (既定値) | 範囲(0 10]のスカラー

`LeadLineColor` — 将来の地上線路の色
`[1 0 1]` (既定値) | RGB 3 成分 | `RGB triplet` | `string scalar of color name` | `character vector of color name`

`TrailLineColor` — 地上トラックライン履歴の色
`[1 0.5 0]` (既定値) | RGB 3 成分 | `RGB triplet` | `string scalar of color name` | `character vector of color name`