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

eclipse

衛星、地上局、またはプラットフォームに日食解析オブジェクトを追加する

R2023b 以降

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

    構文

    eclipse(asset)
    eclipse(___,Name=Value)
    ecl = eclipse(___)

    説明

    eclipse(asset) は、 asset 内の各 Satellite、GroundStation、または Platform オブジェクトに対して日食分析オブジェクトを追加します。asset 内のすべてのオブジェクトは、同じ satelliteScenario オブジェクトに属している必要があります。日食分析オブジェクトは、asset 内の対応する Satellite、GroundStation、または Platform オブジェクトの Eclipse プロパティに割り当てられます。

    eclipse(___,Name=Value) は、名前と値の引数に従って Eclipse 分析オブジェクトを追加します。

    ecl = eclipse(___) は、ベクトル ecl 内の Eclipse 分析オブジェクトのベクトルを返します。

    メモ

    この機能を使用するには、アドオン エクスプローラーを使用してエフェメリス データをダウンロードする必要があります。アドオン エクスプローラーを起動するには、MATLAB® コマンド ウィンドウで「aeroDataPackage」と入力します。

    例

    例

    すべて折りたたむ

    ライブ スクリプトを開く

    衛星 sat と地上局 gs に日食解析オブジェクトを追加し、日食間隔 intvls を計算します。

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

    startTime = datetime(2023,4,20);
stopTime = startTime + days(1);
sampleTime = 10; % seconds
sc = satelliteScenario(startTime,stopTime,sampleTime);

    シナリオscに地上局gsを追加します。

    gs = groundStation(sc, ...
    1.038102, ... % latitude, degrees
    135.980085);  % longitude, degrees

    シナリオscに衛星satを追加します。軌道伝播関数を二体ケプラーとして設定します。

    sat = satellite(sc, ...
    10000000, ... % semimajor axis, meters
    0, ...        % eccentricity
    0, ...        % inclination, degrees
    0, ...        % right ascension of ascending node, degrees
    0, ...        % argument of periapsis, degrees
    0, ...        % true anomaly, degrees
    OrbitPropagator="two-body-keplerian");

    日食解析オブジェクトを地上局 gs に追加します。分析に月食を含めます。デフォルトでは、Eclipse モデルはデュアルコーン用です。

    eclGs = eclipse(gs,IncludeLunarEclipse=true)
    eclGs = 
  Eclipse with properties:

           EclipseModel: "dual-cone"
    IncludeLunarEclipse: 1

    衛星 sat に日食解析オブジェクトを追加します。分析に月食を含めます。デフォルトでは、Eclipse モデルはデュアルコーン用です。

    eclSat = eclipse(sat,IncludeLunarEclipse=true)
    eclSat = 
  Eclipse with properties:

           EclipseModel: "dual-cone"
    IncludeLunarEclipse: 1

    衛星および地上局オブジェクトのプロパティを検査します。Eclipse プロパティが空ではないことに注意してください。これは、Eclipse 分析が追加されたことを示しています。

    Eclipse: [1x1 Aero.satellitescenario.Eclipse]

    sat
    sat = 
  Satellite with properties:

                  Name:  Satellite 2
                    ID:  2
        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:  [1x1 Aero.satellitescenario.Eclipse]
           GroundTrack:  [1x1 matlabshared.satellitescenario.GroundTrack]
                 Orbit:  [1x1 matlabshared.satellitescenario.Orbit]
        CoordinateAxes:  [1x1 matlabshared.satellitescenario.CoordinateAxes]
       OrbitPropagator:  two-body-keplerian
           MarkerColor:  [0.059 1 1]
            MarkerSize:  6
             ShowLabel:  true
        LabelFontColor:  [1 1 1]
         LabelFontSize:  15
         Visual3DModel:  
    Visual3DModelScale:  1


    gs
    gs = 
  GroundStation with properties:

                 Name:  Ground station 1
                   ID:  1
             Latitude:  1.0381 degrees
            Longitude:  135.98 degrees
             Altitude:  0 meters
    MinElevationAngle:  0 degrees
       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:  [1x1 Aero.satellitescenario.Eclipse]
       CoordinateAxes:  [1x1 matlabshared.satellitescenario.CoordinateAxes]
          MarkerColor:  [1 0.4118 0.1608]
           MarkerSize:  6
            ShowLabel:  true
       LabelFontColor:  [1 1 1]
        LabelFontSize:  15

    ベクトル [eclGs eclSat] として指定される、両方の日食オブジェクトの日食間隔を計算します。

    intvls = eclipseIntervals(eclSat)
    intvls=12×9 table
        Asset         EclipsingBody      IntervalNumber         StartTime                EndTime           Duration    MinimumEclipseStatus    StartOrbit    EndOrbit
    _____________    ________________    ______________    ____________________    ____________________    ________    ____________________    __________    ________

    "Satellite 2"    "Earth"                    1          20-Apr-2023 01:17:50    20-Apr-2023 01:53:10      2120                  0               1            1    
    "Satellite 2"    "Moon"                     2          20-Apr-2023 02:43:30    20-Apr-2023 02:56:40       790            0.87839               1            2    
    "Satellite 2"    "Earth"                    3          20-Apr-2023 04:03:50    20-Apr-2023 04:39:10      2120                  0               2            2    
    "Satellite 2"    "Moon"                     4          20-Apr-2023 05:53:50    20-Apr-2023 06:49:40      3350            0.17465               3            3    
    "Satellite 2"    "Earth and Moon"           5          20-Apr-2023 06:49:40    20-Apr-2023 06:51:20       100                  0               3            3    
    "Satellite 2"    "Earth"                    6          20-Apr-2023 06:51:20    20-Apr-2023 07:25:00      2020                  0               3            3    
    "Satellite 2"    "Earth"                    7          20-Apr-2023 09:35:40    20-Apr-2023 10:11:00      2120                  0               4            4    
    "Satellite 2"    "Earth"                    8          20-Apr-2023 12:21:30    20-Apr-2023 12:56:50      2120                  0               5            5    
    "Satellite 2"    "Earth"                    9          20-Apr-2023 15:07:30    20-Apr-2023 15:42:50      2120                  0               6            6    
    "Satellite 2"    "Earth"                   10          20-Apr-2023 17:53:20    20-Apr-2023 18:28:40      2120                  0               7            7    
    "Satellite 2"    "Earth"                   11          20-Apr-2023 20:39:20    20-Apr-2023 21:14:40      2120                  0               8            8    
    "Satellite 2"    "Earth"                   12          20-Apr-2023 23:25:10    21-Apr-2023 00:00:00      2090                  0               9            9

    入力引数

    すべて折りたたむ

    Satellite、GroundStation、または Platform オブジェクト。スカラーまたはベクトルとして指定されます。これらのオブジェクトは同じ satelliteScenario オブジェクトに属している必要があります。この関数は、Eclipse 分析オブジェクトを asset 内の対応するアセットの Eclipse プロパティに追加します。

    名前と値の引数

    すべて折りたたむ

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

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

    例: 'EclipseModel=dual-cone'

    親資産の位置から観測される太陽掩蔽を計算する日食モデル。次のように指定します。

    • dual-cone — 分数は 0.0 (本影)、0.0 ～ 1.0 (半影または前影)、または 1.0 (日光) になります。

    • cylindrical — 分数は 0.0 (Umbra) または 1.0 (Sunlight) になります。 - 領域は 0 (Umbra) または 1 (Sunlight) になります。

      - 領域は 0 (本影)、1 (日光)、2 (半影)、または 3 (暗影) になります。

    例: 'EclipseModel=dual-cone'

    データ型: char | string

    月食計算に月食を有効にするには、この値を true に設定します。それ以外の場合は、false に設定します。

    例: 'IncludeLunarEclipse=false'

    データ型: logical

    出力引数

    すべて折りたたむ

    スカラーまたはベクトルとして返される Eclipse オブジェクト。

    制限

    • 衛星シナリオの AutoSimulate プロパティが false の場合、 SimulationStatus が NotStarted の場合にのみ eclipse を呼び出すことができます。それ以外の場合は、restart 関数を呼び出して SimulationStatus を NotStarted にリセットする必要があります。restart を呼び出すとシミュレーション データが削除されます。

    • この関数は以下を無視します:

      • 大気の屈折。

      • 太陽光の通過時間が遅れます。

    • この関数は、地球、月、太陽が球形の形状を持ち、その半径が赤道半径に等しいことを前提としています。

    • 太陽掩蔽間隔表の EclipsingBody の値が Earth and Moon の場合、MinimumEclipseStatus の予測値は実際の値よりも低くなります。

    バージョン履歴

    R2023b で導入

    参考

    オブジェクト

    関数