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

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 オブジェクトの行ベクトルとして指定されます。

名前と値の引数

すべて折りたたむ

オプションの引数のペアを 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

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`