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

groundStation

R2024a

衛星シナリオに地上局を追加する

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

構文

groundStation(scenario)
groundStation(scenario,lat,lon)
groundStation(___,Name,Value)
gs = groundStation(___)

説明

groundStation(scenario) は、指定された衛星シナリオにデフォルトの GroundStation オブジェクトを追加します。

例

groundStation(scenario,lat,lon) は、地上局の Latitude および Longitude プロパティをそれぞれ lat および lon に設定します。lat と lon は同じ長さである必要があります。この長さは、関数が入力シナリオに追加する地上局の数を指定します。lat と lon は一緒に地上局の位置を示します。

groundStation(___,Name,Value) は、以前の構文からの任意の入力引数の組み合わせに加えて、1 つ以上の名前と値の引数を使用してオプションを設定します。たとえば、'MinElevationAngle',10 は最小仰角 10 度を指定します。

gs = groundStation(___) は、追加された地上局へのハンドルのベクトルを返します。前の構文からの任意の入力引数の組み合わせを指定します。

例

すべて折りたたむ

ライブ スクリプトを開く

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

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:32:00      3060          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:59:00    02-May-2020 06:47:00      2880          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)

入力引数

すべて折りたたむ

satelliteScenario オブジェクトとして指定された衛星シナリオ。

地上局の緯度と経度。実数値のスカラーまたは実数値のベクトルとして指定されます。

名前と値の引数

すべて折りたたむ

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

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。

例: 'MinElevationAngle',10 は最小仰角 10 度を指定します。

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

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

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

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

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

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

データ型: char | string

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

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

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

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

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

データ型: double

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

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

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

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

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

データ型: double

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

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

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

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

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

データ型: double

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

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

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

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

データ型: double

出力引数

すべて折りたたむ

シナリオ内の地上局。入力 scenario で指定された衛星シナリオに属する GroundStation オブジェクトとして返されます。

プロパティ値を変更することで、GroundStation オブジェクトを変更できます。この関数を呼び出すときに使用される名前と値の引数は、プロパティ名に対応します。

バージョン履歴

R2021a で導入

参考

オブジェクト

  • satelliteScenario | satelliteScenarioViewer

関数

  • show | play | hide | satellite | access

トピック