メインコンテンツ

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

Platform

衛星シナリオにおけるプラットフォーム

R2024a 以降

    説明

    Platform オブジェクトは、衛星シナリオのプラットフォームを定義します。プラットフォームは、移動する場所、航空機、または船舶である場合があります。

    作成

    satelliteScenario オブジェクトの platform 関数を使用して Platform オブジェクトを作成できます。

    プロパティ

    すべて展開する

    このプロパティは、platform 関数を呼び出すときにのみ設定できます。platform 関数を呼び出した後、このプロパティは読み取り専用になります。

    プラットフォーム名。'Name' と文字列スカラー、文字列ベクトル、文字ベクトル、または文字ベクトルのセル配列で構成されるコンマ区切りのペアとして指定されます。

    • プラットフォームを 1 つだけ追加する場合は、文字列スカラーまたは文字ベクトル。

    • 複数のプラットフォームを追加し、すべてのプラットフォームの名前が同じである場合の文字列スカラーまたは文字ベクトル。

    • 複数のプラットフォームを追加し、各プラットフォームに一意の名前がある場合の文字列ベクトルまたは文字ベクトルのセル配列。文字列ベクトルまたは文字ベクトルのセル配列内の要素数は、プラットフォームの数と等しくなければなりません。

    データ型: string

    このプロパティはシミュレータによって内部的に設定され、読み取り専用です。

    Platform シミュレータによって割り当てられた ID。正のスカラーとして指定されます。

    このプロパティは、conicalSensor を呼び出すときにのみ設定できます。conicalSensor 関数を呼び出した後、このプロパティは読み取り専用になります。

    Platform に取り付けられたコニカル センサー。コニカル センサーの行ベクトルとして指定されます。

    このプロパティは、gimbal を呼び出すときにのみ設定できます。gimbal を呼び出した後、このプロパティは読み取り専用になります。

    Platform に取り付けられたジンバル。'Gimbals'Gimbal オブジェクトの行ベクトルで構成されるコンマ区切りのペアとして指定されます。

    このプロパティは、transmitter 関数を呼び出すときにのみ設定できます。transmitter 関数を呼び出した後、このプロパティは読み取り専用になります。

    Platform に接続された送信機。Transmitter オブジェクトの行ベクトルとして指定されます。

    このプロパティは、receiver を呼び出すときにのみ設定できます。receiver 関数を呼び出した後、このプロパティは読み取り専用になります。

    衛星に取り付けられた受信機。Receiver オブジェクトの行ベクトルとして指定されます。

    このプロパティは、access を呼び出すときにのみ設定できます。access を呼び出した後、このプロパティは読み取り専用になります。

    アクセス解析オブジェクト。Access オブジェクトの行ベクトルとして指定されます。

    このプロパティは、groundTrack 関数を呼び出すときにのみ設定できます。groundTrack 関数を呼び出した後、このプロパティは読み取り専用になります。

    Platform のグラウンド トラック。GroundTrack オブジェクトの行ベクトルとして指定されます。

    このプロパティは、coordinateAxes を呼び出すときにのみ設定できます。coordinateAxes を呼び出した後、このプロパティは読み取り専用になります。

    座標軸トライアドグラフィック オブジェクト。CoordinateAxes オブジェクトとして指定されます。

    Path オブジェクトとして指定された、プラットフォームのパスの可視化。この機能に関係するのはこれらのオブジェクト プロパティのみです。

    パスの色。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"

    Sample of the color red

    "green""g"[0 1 0]"#00FF00"

    Sample of the color green

    "blue""b"[0 0 1]"#0000FF"

    Sample of the color blue

    "cyan" "c"[0 1 1]"#00FFFF"

    Sample of the color cyan

    "magenta""m"[1 0 1]"#FF00FF"

    Sample of the color magenta

    "yellow""y"[1 1 0]"#FFFF00"

    Sample of the color yellow

    "black""k"[0 0 0]"#000000"

    Sample of the color black

    "white""w"[1 1 1]"#FFFFFF"

    Sample of the color white

    "none"該当なし該当なし該当なし色なし

    次の表に、プロット用のライト テーマとダーク テーマの既定のカラー パレットを示します。

    パレットパレットの色

    "gem" — ライト テーマの既定値

    R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。

    Sample of the "gem" color palette

    "glow" — ダーク テーマの既定値

    Sample of the "glow" color palette

    orderedcolors 関数と rgb2hex 関数を使用すると、これらのパレットの RGB 3 成分および 16 進数カラー コードを取得できます。たとえば、"gem" パレットの RGB 3 成分を取得し、16 進数カラー コードに変換します。

    RGB = orderedcolors("gem");
    H = rgb2hex(RGB);

    R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。

    R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラー コードを取得します。

    例: 'blue'

    例: [0 0 1]

    例: '#0000FF'

    パスの視覚的な幅(ピクセル単位)。範囲(0, 10) のスカラーとして指定します。

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

    衛星シナリオ ビューアー内のパス グラフィックの表示モード。次のいずれかの値として指定されます。

    • 'inherit' — パス グラフィックの可視性は親プラットフォームの可視性と一致します。

    • 'manual' — パス グラフィックの可視性は継承されず、親プラットフォームから独立しています。

    メモ

    パス グラフィックは 2D ビューアでは常に表示されません。

    データ型: char | string

    マーカーの色。'MarkerColor' と RGB トリプレット、または色名の文字文字列または文字ベクトルのいずれかで構成されるコンマ区切りのペアとして指定します。

    カスタム色を使用する場合は、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"

    Sample of the color red

    "green" "g" [0 1 0] "#00FF00"

    Sample of the color green

    "blue" "b" [0 0 1] "#0000FF"

    Sample of the color blue

    "cyan" "c" [0 1 1] "#00FFFF"

    Sample of the color cyan

    "magenta" "m" [1 0 1] "#FF00FF"

    Sample of the color magenta

    "yellow" "y" [1 1 0] "#FFFF00"

    Sample of the color yellow

    "black" "k" [0 0 0] "#000000"

    Sample of the color black

    "white" "w" [1 1 1] "#FFFFFF"

    Sample of the color white

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

    RGB 3 成分16 進数カラー コード外観
    [0 0.4470 0.7410] "#0072BD"

    Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

    [0.8500 0.3250 0.0980] "#D95319"

    Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

    [0.9290 0.6940 0.1250] "#EDB120"

    Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

    [0.4940 0.1840 0.5560] "#7E2F8E"

    Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

    [0.4660 0.6740 0.1880] "#77AC30"

    Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

    [0.3010 0.7450 0.9330] "#4DBEEE"

    Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

    [0.6350 0.0780 0.1840] "#A2142F"

    Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

    マーカーのサイズ。'MarkerSize' と 30 未満の実数の正のスカラーで構成されるコンマ区切りのペアとして指定します。単位はピクセルです。

    Platform ラベルの可視性の状態。'ShowLabel' と、1 (true) または 0 (false) の数値または論理値で構成されるコンマ区切りのペアとして指定されます。

    データ型: logical

    Platform ラベルのフォント色。'LabelFontColor' と RGB トリプレットまたは色名の文字列または文字ベクトルのいずれかで構成されるコンマ区切りのペアとして指定します。

    カスタム色を使用する場合は、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"

    Sample of the color red

    "green" "g" [0 1 0] "#00FF00"

    Sample of the color green

    "blue" "b" [0 0 1] "#0000FF"

    Sample of the color blue

    "cyan" "c" [0 1 1] "#00FFFF"

    Sample of the color cyan

    "magenta" "m" [1 0 1] "#FF00FF"

    Sample of the color magenta

    "yellow" "y" [1 1 0] "#FFFF00"

    Sample of the color yellow

    "black" "k" [0 0 0] "#000000"

    Sample of the color black

    "white" "w" [1 1 1] "#FFFFFF"

    Sample of the color white

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

    RGB 3 成分16 進数カラー コード外観
    [0 0.4470 0.7410] "#0072BD"

    Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

    [0.8500 0.3250 0.0980] "#D95319"

    Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

    [0.9290 0.6940 0.1250] "#EDB120"

    Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

    [0.4940 0.1840 0.5560] "#7E2F8E"

    Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

    [0.4660 0.6740 0.1880] "#77AC30"

    Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

    [0.3010 0.7450 0.9330] "#4DBEEE"

    Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

    [0.6350 0.0780 0.1840] "#A2142F"

    Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

    Platformラベルのフォントサイズ。'LabelFontSize'と[6 30]の範囲の正のスカラーで構成されるコンマ区切りのペアとして指定します。

    ビューアーでレンダリングするビジュアル 3D モデル ファイルの名前。拡張子が .GLTF、.GLB、または .STL の文字文字列として指定します。GLB および GLTF モデルの場合、gITF は右手座標系を使用します。gITF は、+Y を上、+Z を前、-X を右と定義します。gITF アセットは +Z に面しています。詳細については、https://registry.khronos.org/glTF/specs/2.0/glTF-2.0.html#coordinate-system-and-units を参照してください。GLB のメッシュはメートル単位です。

    メモ

    このプロパティ NarrowBodyAirliner.glb を設定すると、航空機の 3D モデルを衛星シナリオ ビューアーに追加できます。

    3-D Model of an aircraft

    データ型: string

    ビューアでレンダリングされるビジュアル 3D モデルの線形スケーリング。負でない整数として指定します。スケーリングでは、GLB モデルがメートル単位であることを前提としています。

    データ型: double

    オブジェクト関数

    accessサテライトシナリオにアクセス解析オブジェクトを追加する
    aerNEDフレーム内の他の衛星または地上局の方位角角、仰角、範囲を計算します。
    dopplershift衛星シナリオにおけるターゲット アセットのドップラーシフトを計算する
    latencyCalculate propagation delay from one asset to another asset
    conicalSensor衛星シナリオにコニカル センサーを追加する
    gimbal衛星、プラットフォーム、地上局にジンバルを追加する
    groundTrackシナリオ内の衛星またはプラットフォームにグラウンド トラックオブジェクトを追加する
    coordinateAxes衛星シナリオ アセットの座標軸トライアドを可視化する
    receiverAdd receiver to satellite scenario
    transmitterAdd transmitter to satellite scenario
    states衛星またはプラットフォームの位置と速度を取得する
    path衛星シナリオでプラットフォームの経路を可視化する
    show衛星シナリオビューアでオブジェクトを表示する
    hide衛星シナリオエンティティをビューアーから非表示にする

    すべて折りたたむ

    satelliteScenario を使用してシナリオを作成します。

    sc = satelliteScenario();
    viewer = satelliteScenarioViewer(sc);

    デリー国際空港から離陸し、バンガロール上空を飛行してドバイに着陸する航空機を考えてみます。合計飛行時間は3時間です。 geoTrajectory を使用して軌跡を作成します。

    trajectory = geoTrajectory([28.5567,77.1006,10600;13.1989,77.7068,30600;25.2566,55.3641,5600],[0,3600,3*3600],AutoPitch=true,AutoBank=true);

    軌跡に基づいて衛星シナリオにプラットフォームを追加します。

    pltf = platform(sc,trajectory)
    pltf = 
      Platform with properties:
    
                      Name:  Platform 1
                        ID:  1
            ConicalSensors:  [1x0 matlabshared.satellitescenario.ConicalSensor]
                   Gimbals:  [1x0 matlabshared.satellitescenario.Gimbal]
              Transmitters:  [1x0 satcom.satellitescenario.Transmitter]
                 Receivers:  [1x0 satcom.satellitescenario.Receiver]
                  Accesses:  [1x0 matlabshared.satellitescenario.Access]
                   Eclipse:  [1x0 Aero.satellitescenario.Eclipse]
               GroundTrack:  [1x1 matlabshared.satellitescenario.GroundTrack]
                      Path:  [1x1 matlabshared.satellitescenario.Path]
            CoordinateAxes:  [1x1 matlabshared.satellitescenario.CoordinateAxes]
               MarkerColor:  [0.7176 0.2745 1]
                MarkerSize:  6
                 ShowLabel:  true
            LabelFontColor:  [1 1 1]
             LabelFontSize:  15
             Visual3DModel:  
        Visual3DModelScale:  1
    
    
    hide(pltf.Path);
    show(pltf.GroundTrack);

    ビューアーを再生します。

    play(sc);

    platform_example_1.png

    参照

    [1] Hoots, Felix R., and Ronald L. Roehrich. Models for propagation of NORAD element sets. Aerospace Defense Command Peterson AFB CO Office of Astrodynamics, 1980.

    バージョン履歴

    R2024a で導入