メインコンテンツ

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

GroundStation

衛星シナリオに属する地上局オブジェクト

R2021a 以降

    説明

    GroundStation オブジェクトは、衛星シナリオに属する地上局オブジェクトを定義します。

    作成

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

    プロパティ

    すべて展開する

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

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

    • GroundStation を 1 つだけ追加する場合は、Name を文字列スカラーまたは文字ベクトルとして指定します。

    • 複数の GroundStation を追加する場合は、 Name を文字列スカラー、文字ベクトル、文字列ベクトル、または文字ベクトルのセル配列として指定します。文字列スカラーまたは文字ベクトルとして追加されたすべての GroundStation には、同じ指定された名前が割り当てられます。文字列ベクトルまたは文字ベクトルのセル配列内の要素数は、追加される GroundStation の数と等しくなければなりません。各 GroundStation には、ベクトルまたはセル配列から対応する名前が割り当てられます。

    デフォルト値では、idx は衛星シナリオによって割り当てられた ID です。

    データ型: char | string

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

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

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

    地上局の測地緯度。スカラーとして指定されます。値は[-90, 90]の範囲内でなければなりません。

    • 地上局を 1 つだけ追加する場合は、緯度をスカラー double として指定します。

    • 複数の地上局を追加する場合は、追加する地上局の数に等しい長さのベクトル double として Latitude を指定します。

    緯度と経度が GroundStation への lat, lon 入力として指定されている場合、名前値引数として指定された緯度が優先されます。

    データ型: double

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

    地上局の測地経度。スカラーまたはベクトルとして指定されます。値は[-180, 180]の範囲内でなければなりません。

    • 地上局を 1 つだけ追加する場合は、経度をスカラーとして指定します。

    • 複数の地上局を追加する場合は、追加する地上局の数に等しい長さのベクトルとして経度を指定します。

    GroundStation への lat, lon 入力として経度と経度が指定されている場合、名前値引数として指定された経度が優先されます。

    データ型: double

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

    地上局の高度。スカラーまたはベクトルとして指定します。

    • Altitude をスカラーとして指定すると、その値は GroundStation 内の各地上局に割り当てられます。

    • Altitude をベクトルとして指定する場合、ベクトルの長さは GroundStation 内の地上局の数と等しくなければなりません。

    緯度と経度が lat, lon 入力として GroundStation に指定されている場合、名前値引数として指定された緯度が優先されます。

    データ型: double

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

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

    衛星が地上局から見える最小仰角、および地上局が衛星から見える最小仰角(度)。スカラーまたは行ベクトルとして指定します。値は[-90, 90]の範囲でなければなりません。アクセスとリンク クロージャーを可能にするには、仰角が少なくとも MinElevationAngle で指定された値と等しくなければなりません。

    • MinElevationAngle をスカラーとして指定すると、その値は GroundStation 内の各地上局に割り当てられます。

    • MinElevationAngle をベクトルとして指定する場合、ベクトルの長さは GroundStation 内の地上局の数と等しくなければなりません。

    衛星シナリオの AutoSimulate プロパティが false の場合、SimulationStatusNotStarted または InProgress であるときに MinElevationAngle プロパティを変更できます。

    データ型: double

    可視性マスクの仰角(度単位)。スカラー、N 要素の行ベクトル、または 2 次元行列として指定します。このプロパティは MaskAzimuthEdges と連携して可視性マスクを作成します。MaskElevationAngle 行ベクトルの長さは、MaskAzimuthEdges 行ベクトルより 1 短くする必要があります。

    すべての MaskElevationAngle 角度の値は -90 から 90 まででなければなりません。Nm-1 です。ここで、mMaskAzimuthEdges 内の要素の数です。

    • MaskElevationAngle がスカラー double または行ベクトル double の場合、この値は GroundStation オブジェクト内の各地上局に割り当てられます。

    • MaskElevationAngle が 2 次元行列 double の場合、行数は GroundStation オブジェクト内の地上局の数と等しくなければなりません。

    衛星シナリオの AutoSimulate プロパティが false の場合、SimulationStatusNotStarted または InProgress であるときに MaskElevationAngle プロパティを変更できます。

    データ型: double

    可視性マスクの方位角角(度単位)。角度の行ベクトルまたは 2 次元行列として指定します。このパラメーターはMaskElevationAngle プロパティと連携して可視性マスクを作成します。MaskAzimuthEdges プロパティ行ベクトルの長さは、MaskElevationAngle プロパティ行ベクトルより 1 長くする必要があります。すべての MaskAzimuthEdges 角度の値は 0 度から 360 度までの範囲でなければなりません。

    • MaskAzimuthEdges が行ベクトルの場合、この値は GroundStation オブジェクトに追加された各地上局に割り当てられます。

    • MaskAzimuthEdges が 2 次元行列の場合、行列の行数は GroundStation オブジェクト内の地上局の数と等しくなければなりません。

    • MaskAzimuthEdges が指定されていない場合、この値は 0 度から 360 度までの線形間隔の行ベクトルとして各地上局に対して自動的に生成されます。行ベクトルは、対応する MaskElevationAngle 行ベクトルよりも 1 つ長い値です。

    衛星シナリオの AutoSimulate プロパティが false の場合、SimulationStatusNotStarted または InProgress であるときに MaskAzimuthEdges プロパティを変更できます。

    データ型: double

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

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

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

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

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

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

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

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

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

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

    マーカーの色。'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 未満の実数の正のスカラーで構成されるコンマ区切りのペアとして指定します。単位はピクセルです。

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

    データ型: logical

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

    GroundStation ラベルのフォント色。'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

    オブジェクト関数

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

    すべて折りたたむ

    衛星シナリオを作成し、緯度と経度から地上局を追加します。

    startTime = datetime(2020,5,1,11,36,0);
    stopTime = startTime + days(1);
    sampleTime = 60;
    sc = satelliteScenario(startTime,stopTime,sampleTime);
    lat = 10;
    lon = -30;
    gs = groundStation(sc,lat,lon);

    ケプラーの要素を使用して衛星を追加します。

    semiMajorAxis = 10000000;
    eccentricity = 0;
    inclination = 10; 
    rightAscensionOfAscendingNode = 0; 
    argumentOfPeriapsis = 0; 
    trueAnomaly = 0; 
    sat = satellite(sc,semiMajorAxis,eccentricity,inclination, ...
            rightAscensionOfAscendingNode,argumentOfPeriapsis,trueAnomaly);

    シナリオにアクセス解析を追加し、衛星と地上局間のアクセス間隔の表を取得します。

    ac = access(sat,gs);
    intvls = accessIntervals(ac)
    intvls=8×8 table
           Source              Target          IntervalNumber         StartTime                EndTime           Duration    StartOrbit    EndOrbit
        _____________    __________________    ______________    ____________________    ____________________    ________    __________    ________
    
        "Satellite 2"    "Ground station 1"          1           01-May-2020 11:36:00    01-May-2020 12:04:00      1680          1            1    
        "Satellite 2"    "Ground station 1"          2           01-May-2020 14:20:00    01-May-2020 15:11:00      3060          1            2    
        "Satellite 2"    "Ground station 1"          3           01-May-2020 17:27:00    01-May-2020 18:18:00      3060          3            3    
        "Satellite 2"    "Ground station 1"          4           01-May-2020 20:34:00    01-May-2020 21:25:00      3060          4            4    
        "Satellite 2"    "Ground station 1"          5           01-May-2020 23:41:00    02-May-2020 00:31:00      3000          5            5    
        "Satellite 2"    "Ground station 1"          6           02-May-2020 02:50:00    02-May-2020 03:39:00      2940          6            6    
        "Satellite 2"    "Ground station 1"          7           02-May-2020 05:58:00    02-May-2020 06:47:00      2940          7            7    
        "Satellite 2"    "Ground station 1"          8           02-May-2020 09:06:00    02-May-2020 09:56:00      3000          8            9    
    
    

    シナリオを再生して地上局を可視化します。

    play(sc)

    バージョン履歴

    R2021a で導入

    すべて展開する