主要内容

comm.Ray

传播射线容器对象

描述

comm.Ray对象是用于传播射线属性的容器对象。该对象包含从一个点传播到空间中的另一个点的无线电波的几何和电磁信息。

创建

通常,您创建comm.Ray对象,使用光线跟踪功能。

描述

示例

= Comm.Ray.创建一个容器对象,该对象初始化传播射线的属性。

= comm.Ray (名称,价值使用一个或多个名称-值对参数设置属性。将每个属性名用引号括起来。例如,Comm.Ray('coordinateystem','地理','变送器位置',[40.730610,-73.935242,0])指定地理坐标系和位于纽约市的发射机。

属性

全部展开

传播路径规范方法,指定为这些值之一。

  • “位置”- 航点之间的光线对象路径被传送为(X.yZ.)的坐标点TransmitterLocationReceiverLocation,如果适用,ReflectorLocations属性。

  • 延迟和角度的-路径点之间的射线物体路径由PropagationDelayAngleOfDeparture,AngleOfArrival属性。

数据类型:字符|字符串

坐标系统,指定为笛卡儿的“地理”.当你设置CoordinateSystem财产“地理”,定义相对于WGS-84地球椭球模型的坐标系,并定义相对于发射机和接收机局地East-North-Up (ENU)坐标系的角度。

依赖关系

要启用此属性,请设置Pathspecification.财产“位置”

数据类型:字符|字符串

以米为单位的笛卡尔坐标系标量,指定为正标量。

依赖关系

要启用此属性,请设置Pathspecification.财产“位置”CoordinateSystem财产笛卡儿的

数据类型:

发射机位置,指定为其中一种形式的坐标的三元素数字列向量。

  • [X.;y;Z.-此表单适用于设置CoordinateSystem财产笛卡儿的.该对象不执行范围验证X.y,Z.

  • [纬度;经度;高度-此表单适用于设置CoordinateSystem财产“地理”纬度必须在[- 90,90]范围内。该对象不执行范围验证经度

依赖关系

要启用此属性,请设置Pathspecification.财产“位置”

数据类型:

接收器位置,指定为这些形式之一的坐标的三元素数字列向量。

  • [X.;y;Z.-此表单适用于设置CoordinateSystem财产笛卡儿的.该对象不执行范围验证X.y,Z.

  • [纬度;经度;高度-此表单适用于设置CoordinateSystem财产“地理”纬度必须在[- 90,90]范围内。该对象不执行范围验证经度

依赖关系

要启用此属性,请设置Pathspecification.财产“位置”

数据类型:

视线,指定为逻辑值1真正的)或0.)指示光线是否是视线射线。

依赖关系

要启用此属性,请设置Pathspecification.财产“位置”

数据类型:逻辑

反射器位置,指定为3-by-N包含光线反射点坐标的数值矩阵。N光线反射点的数量是由NumReflections财产。每一列表示从发射机到接收机的传播路径上一个反射点的坐标位置。列的顺序和路径上点的顺序是一样的。列(反射点坐标)是这些形式之一。

  • [X.;y;Z.-当CoordinateSystem属性设置为笛卡儿的.该对象不执行范围验证X.y,Z.

  • [纬度;经度;高度-当CoordinateSystem属性设置为“地理”纬度必须在[- 90,90]范围内。该对象不执行范围验证经度

依赖关系

要启用此属性,请设置Pathspecification.财产“位置”LineOfSight财产0.).

数据类型:

以秒为单位的传播延迟,指定为非负标量。使用默认值计算默认值TransmitterLocationReceiverLocation视线射线的属性。

  • 当你设置Pathspecification.财产“位置”,此属性是只读的,值源自TransmitterLocationReceiverLocation并且,如果适用,ReflectionLocations

  • 当你设置Pathspecification.财产延迟和角度的,此属性是可配置的。

数据类型:

此属性是只读的。

传播距离,单位为米,指定为非负标量。使用默认值计算默认值TransmitterLocationReceiverLocation视线射线的属性。

  • 当你设置Pathspecification.财产“位置”,该值来自于TransmitterLocationReceiverLocation并且,如果适用,ReflectionLocations

  • 当你设置Pathspecification.财产延迟和角度的,该值来自于PropagationDelay

数据类型:

发送器的光线的偏离角度,指定为表格的数字矢量[AZ.;el].方位角,AZ.,从正x轴逆时针方向测量,必须在范围内(- 180,180)。仰角,el,从x-y平面测量,必须在[- 90,90]范围内。使用默认值计算默认值TransmitterLocationReceiverLocation视线射线的属性。

  • 当你设置Pathspecification.财产延迟和角度的,此属性是可配置的。

  • 当你设置Pathspecification.财产“位置”,此属性是只读的,值源自TransmitterLocationReceiverLocation并且,如果适用,ReflectionLocations

  • CoordinateSystem被设置为“地理”,角度是参考发射机当地的East-North-Up (ENU)坐标系统定义的。

数据类型:

射入接收器的角度,以射线在接收器处的度数表示,指定为形式为[AZ.;el].方位角,AZ.,从正x轴逆时针方向测量,必须在范围内(- 180,180)。仰角,el,从x-y平面测量,必须在[- 90,90]范围内。使用默认值计算默认值TransmitterLocationReceiverLocation视线射线的属性。

  • 当你设置Pathspecification.财产延迟和角度的,此属性是可配置的。

  • 当你设置Pathspecification.财产“位置”,此属性是只读的,值源自TransmitterLocationReceiverLocation并且,如果适用,ReflectionLocations

  • CoordinateSystem被设置为“地理”,角度的定义参考当地的东-北-上(ENU)坐标系统在接收机。

数据类型:

此属性是只读的。

射线对象从发射器到接收器的反射点数,指定为非负整数。该值派生自LineOfSight并且,如果适用,ReflectionLocations

依赖关系

要启用此属性,请设置Pathspecification.财产“位置”

数据类型:

Hz中的信号频率指定为正标量。

数据类型:

路径损耗源,指定为“自由空间模型”“自定义”

数据类型:字符|字符串

DB的路径损耗,指定为非负标量。使用默认值计算默认值TransmitterLocationReceiverLocation视线射线的属性。

  • 当你设置pathlosssource.财产“自由空间模型”,这pathloss.属性是只读的,并派生自PropagationDistance频率属性使用自由空间传播模型。

  • 当你设置pathlosssource.财产“自定义”,可以设置pathloss.属性,独立于几何属性。

数据类型:

弧度的相移,指定为数字标量。使用默认值计算默认值TransmitterLocationReceiverLocation视线射线的属性。

  • 当你设置pathlosssource.财产“自由空间模型”,这拼凑属性是只读的,并派生自PropagationDistance频率属性使用自由空间传播模型。

  • 当你设置pathlosssource.财产“自定义”,可以设置拼凑属性,独立于几何属性。

数据类型:

对象功能

情节(射线) 地点查看器地图中的情节射线

例子

全部折叠

在香港的两个站点之间进行射线跟踪,产生包含的单元格数组comm.Ray对象。当comm.Ray物体包含从发射站点到接收站点的无线电波传播路径的几何和电磁信息。

创建一个网站查看器地图,加载香港的建筑数据。有关OSM文件的详细信息,请参阅[1]

观众= siteviewer (“建筑”“hongkong.osm”);

指定发送器和接收器站点。

tx = txsite (“纬度”, 22.2789,'经度',114.1625,...“AntennaHeight”10'变送器发动机'5,...“TransmitterFrequency”,28E9);rx = rxsite(“纬度”, 22.2799,'经度',114.1617,...“AntennaHeight”1);

在站点之间执行射线追踪,生成comm.Ray单元格数组中的对象。对于指定的发射器和接收器位置,在一个行向量中包含三个射线对象的1 × 1单元阵列中执行射线跟踪结果。

射线=光线跟踪(tx,处方,“类型”“pathloss”“ColorLimits”250年[100])
射线=1×1单元阵列{1×3 comm.Ray}

显示第一个的属性comm.Ray对象。当LineOfSight属性值是1,NumReflections属性值是0..这种组合表明光线定义了一条视线路径。

射线{1}(1)
ANS = Ray属性:Pathspecification:'位置'坐标系统:'地理'变送器位置:[3×1双]接收:[3×1双] LINEOFSIGHT:1频率:2.8000E + 10 Pathlosssource:'自定义'pathloss:104.2656 phaseShift:4.6390只读属性:传播:4.6442E-07传播:139.2294 AngleOfDeparture:[2×1双]倾斜载体:[2×1双] Numreflections:0

显示第二个和第三个的属性comm.Ray对象。当LineOfSight属性值是0.,NumReflections属性值大于0..这种组合表明光线定义了反射路径。

射线{1}(2)
ANS = Ray属性:Pathspecification:'位置'坐标系统:'地理'变送器位置:[3×1双]接收分配:[3×1双] Lineofsight:0射线划分:[3×1双]频率:2.8000e + 10 pathlosssource:'自定义'Pathloss:106.2545 PhaseShift:0.3951只读属性:传播:4.6490E-07传播:139.3720 AnclationOfdeparture:[2×1双]倾斜载体:[2×1双] Numreflections:1
射线{1}(3)
ans = Ray with properties: PathSpecification: 'Locations' CoordinateSystem: 'Geographic' TransmitterLocation: [3×1 double] ReceiverLocation: [3×1 double] LineOfSight: 0 ReflectionLocations: [3×1 double] Frequency: 2.8000e+10 pathlossource: 'Custom' PathLoss: 120.0733 phasesshift: 0.3965 Read-only properties: PropagationDelay:1.1327e-06传播距离:3395692出发角度:[2×1 double]到达角度:[2×1 double] NumReflections: 1

可视化射线追踪结果。

绘图(光线{1});

附录

[1]从中下载OSM文件https://www.openstreetmap.org.,它提供对世界各地的人群地图数据的访问。数据在开放数据公共场合打开数据库许可证(ODBL)下进行许可,https://opendatacommons.org/licenses/dbl/

返回射线追踪结果comm.Ray对象并在重新启动站点查看器地图后绘制射线传播路径。

创建站点查看器地图,为芝加哥加载建筑数据。有关OSM文件的详细信息,请参阅[1]

观众= siteviewer (“建筑”'chicago.osm');

在一个建筑物上创建并显示另一个建筑物的接收器站点。

tx = txsite (“纬度”, 41.8800,'经度', -87.6295,...“TransmitterFrequency”, 2.5 e9);显示(tx);rx = rxsite(“纬度”, 41.881352,'经度', -87.629771,...“AntennaHeight”, 30);显示(rx);

执行RAY跟踪,返回RAY对象结果。对于定义的配置,RAY跟踪返回包含一个光线对象的单元数组。显示RAY对象属性。然后,关闭站点查看器地图。

射线=光线跟踪(tx, rx)
射线=1×1单元阵列{1×1 comm.ray}
射线{1}
ans = Ray with properties: PathSpecification: 'Locations' CoordinateSystem: 'Geographic' TransmitterLocation: [3×1 double] ReceiverLocation: [3×1 double] LineOfSight: 0 ReflectionLocations: [3×1 double] Frequency: 2.5000e+09 pathlossource: 'Custom' PathLoss: 94.0915 phasesshift: 1.2939 Read-only properties: PropagationDelay:5.7088e-07传播距离:171.1462出发角度:[2×1 double]到达角度:[2×1 double] NumReflections: 1
关闭(查看者);

你可以在不进行光线追踪的情况下绘制光线。用相同的建筑创建另一个站点查看器地图。显示发射机和接收机的位置。使用先前返回的射线对象单元阵列,绘制发射站点和接收站点之间的反射射线。plot函数可以一次绘制一个射线对象的路径。

siteviewer (“建筑”'chicago.osm');显示(tx);显示(rx);情节(射线{1},“类型”“权力”...“TransmitterSite”tx,'接收'、rx);

附录

[1]从中下载OSM文件https://www.openstreetmap.org.,它提供对世界各地的人群地图数据的访问。数据在开放数据公共场合打开数据库许可证(ODBL)下进行许可,https://opendatacommons.org/licenses/dbl/

扩展功能

C / c++代码生成
使用MATLAB®Coder™生成C和c++代码。

在R2020A中介​​绍