referenceSphere

参考球体

全页展开

说明

一个 referenceSphere 对象表示一个具有特定名称和半径的球体，您可以在地图投影和其他大地测量操作中使用它。

创建对象

创建参考球体对象有多种方法，包括：

创建一个 geocrs 对象，然后查询其 Spheroid 属性。
创建一个 projcrs 对象，访问其 GeographicCRS 属性中包含的 geocrs 对象，然后查询 geocrs 的 Spheroid 属性。
使用 referenceSphere 函数（详见此处说明）。

语法

S = referenceSphere

S = referenceSphere(name)

S = referenceSphere(name,lengthUnit)

描述

S = referenceSphere 创建了一个名为 referenceSphere 的对象，该对象表示单位球体。

示例

S = referenceSphere(name) 会创建一个 referenceSphere 对象，该对象对应于由 name 指定的球体。参考球的半径以米为单位。

示例

S = referenceSphere(name,lengthUnit) 创建一个半径为指定长度单位 (LengthUnit) 的 referenceSphere 对象。长度单位可以是 validateLengthUnit 函数支持的任何长度单位。

输入参量

全部展开

`name` — 预定义参考球体的名称
`'Unit Sphere'` (默认) | `'earth'` | `'sun'` | `'moon'` | ...

预定义参考球体的名称，指定为 'earth'、'sun'、'moon'、'mercury'、'venus'、'mars'、'jupiter'、'saturn'、'uranus'、'neptune'、'pluto' 或 'unit sphere'。name 参量不区分大小写。

数据类型: char | string

`lengthUnit` — 长度单位
`''` (默认) | 字符向量 | 字符串标量

长度单位，指定为字符向量或字符串标量。您可以指定 validateLengthUnit 函数支持的任何长度单位。

值	单位名称
`"m"`, `"meter"`, `"meters"`, `"metre"`, `"metres"`	米
`"cm"`, `"centimeter"`, `"centimeters"`, `"centimetre"`, `"centimetres"`	厘米
`"mm"`, `"millimeter"`, `"millimeters"`, `"millimetre"`, `"millimetres"`	毫米
`"micron"`, `"microns"`	微米
`"km"`, `"kilometer"`, `"kilometers"`, `"kilometre"`, `"kilometers"`	公里
`"nm"`, `"naut mi"`, `"nautical mile"`, `"nautical miles"`	海里
`"ft"`, `"international ft"`, `"foot"`, `"international foot"`, `"feet"`, `"international feet"`	英尺
`"in"`, `"inch"`, `"inches"`	英寸
`"yd"`, `"yds"`, `"yard"`, `"yards"`	码
`"mi"`, `"mile"`, `"miles"`, `"international mile"`, `"international miles"`	英里
`"sf"`, `"survey ft"`, `"US survey ft"`, `"U.S. survey ft"`, `"survey foot"`, `"US survey foot"`, `"U.S. survey foot"`, `"survey feet"`, `"US survey feet"`, `"U.S. survey feet"`	美国测量英尺
`"sm"`, `"survey mile"`, `"survey miles"`, `"statute mile"`, `"statute miles"`, `"US survey mile"`, `"US survey miles"`, `"U.S. survey mile(s)"`, `"U.S. survey miles"`	美国测量英里（法定英里）
`"Clarke's foot"`, `"Clarkes foot"`	克拉克英尺
`"German legal metre"`, `"German legal meter"`	德国法定米制
`"Indian foot"`	印度英尺

数据类型: char | string

属性

全部展开

`Name` — 参考球体名称
`'Unit Sphere'` (默认) | 字符向量 | 字符串标量

参考球体的名称，指定为字符串标量或字符向量。

示例: 'Sun'

数据类型: char | string

`LengthUnit` — 半径的长度单位
`''` (默认) | 字符向量 | 字符串标量

半径的长度单位，指定为字符串标量或字符向量。您可以指定 validateLengthUnit 函数支持的任何长度单位。当参考球面表示单位球面时，LengthUnit 即为空字符向量 ' '。

示例: 'km'

数据类型: char | string

`Radius` — 球的半径
正有限标量

球体的半径，指定为正的、有限的标量。

数据类型: double

`SemimajorAxis` — 该球体的赤道半径
只读: 1 (默认) | 正有限标量

此属性为只读。

球体的赤道半径，指定为一个正的、有限的标量。SemimajorAxis 的值等于 Radius 的值。

数据类型: double

`SemiminorAxis` — 从球心到极点的距离
只读: 1 (默认) | 正有限标量

此属性为只读。

从球心到极点的距离，指定为一个正的、有限的标量。SemiminorAxis 的值等于 Radius 的值。

数据类型: double

`InverseFlattening` — 扁率的倒数
只读: `Inf` (默认)

此属性为只读。

展平的倒数，指定为值 Inf。

数据类型: double

`Eccentricity` — 球体的第一偏心率
只读: 0 (默认)

此属性为只读。

球体的第一偏心率，指定为值 0。

数据类型: double

`Flattening` — 球体的扁率
只读: 0 (默认)

此属性为只读。

球体的扁平化程度，指定为值 0。

数据类型: double

`ThirdFlattening` — 球体的第三扁率
只读: 0 (默认)

此属性为只读。

球体的第三次展平，指定值为 0 的值。

数据类型: double

`MeanRadius` — 球体的平均半径
只读: 正有限标量

此属性为只读。

球体的平均半径，指定为正的、有限的标量。MeanRadius 的值等于 Radius 的值。

数据类型: double

`SurfaceArea` — 球体的表面积
只读: 正有限标量

此属性为只读。

球体的表面积，指定为正的、有限的标量。

SurfaceArea 属性单位的单位应与 LengthUnit 属性指定的长度单位保持一致。

数据类型: double

`Volume` — 球体的体积
只读: 正有限标量

此属性为只读。

球体的体积，指定为正的、有限的标量。

Volume 属性以与 LengthUnit 属性指定的长度单位相一致的体积单位表示。

数据类型: double

示例

全部折叠

创建以公里为单位的地球模型

构造一个参考球体，将地球建模为半径为 6371000 米的球体。请注意，长度的单位是米。

s = referenceSphere('Earth')

s = 

referenceSphere with defining properties:

          Name: 'Earth'
    LengthUnit: 'meter'
        Radius: 6371000

  and additional properties:

    SemimajorAxis
    SemiminorAxis
    InverseFlattening
    Eccentricity
    Flattening
    ThirdFlattening
    MeanRadius
    SurfaceArea
    Volume

将参考球体中的长度单位切换为公里。

s.LengthUnit = 'kilometer'

s = 

referenceSphere with defining properties:

          Name: 'Earth'
    LengthUnit: 'kilometer'
        Radius: 6371

  and additional properties:

    SemimajorAxis
    SemiminorAxis
    InverseFlattening
    Eccentricity
    Flattening
    ThirdFlattening
    MeanRadius
    SurfaceArea
    Volume

求该球体的表面积（单位：平方公里）。

s.SurfaceArea

ans =

   5.1006e+08

求该球体的体积（单位：立方公里）。

s.Volume

ans =

   1.0832e+12

为行星创建自定义模型

通过修改默认参考球体的属性，为行星创建一个自定义参考球体。

customPlanet = referenceSphere;
customPlanet.Name = 'Tiny Planet';
customPlanet.LengthUnit = 'meter';
customPlanet.Radius = 8000

customPlanet = 

referenceSphere with defining properties:

          Name: 'Tiny Planet'
    LengthUnit: 'meter'
        Radius: 8000

  and additional properties:

    SemimajorAxis
    SemiminorAxis
    InverseFlattening
    Eccentricity
    Flattening
    ThirdFlattening
    MeanRadius
    SurfaceArea
    Volume

从坐标参考系获取参考球体

打开实时脚本

为月球创建一个地理坐标参考系统 (CRS)，其 ESRI 代码为 104903。然后，通过查询地理坐标参考系统 (CRS) 的 Spheroid 属性来获取参考球体。

gcrs1 = geocrs(104903,"Authority","ESRI");
S1 = gcrs1.Spheroid

S1 = 
referenceSphere with defining properties:

          Name: 'Moon_2000_IAU_IAG'
    LengthUnit: 'meter'
        Radius: 1737400

  and additional properties:

    SemimajorAxis
    SemiminorAxis
    InverseFlattening
    Eccentricity
    Flattening
    ThirdFlattening
    MeanRadius
    SurfaceArea
    Volume

版本历史记录

在 R2012a 中推出

另请参阅

oblateSpheroid | referenceEllipsoid | validateLengthUnit

referenceSphere

说明

创建对象

语法

描述

输入参量

name — 预定义参考球体的名称 'Unit Sphere' (默认) | 'earth' | 'sun' | 'moon' | ...

lengthUnit — 长度单位 '' (默认) | 字符向量 | 字符串标量

属性

Name — 参考球体名称 'Unit Sphere' (默认) | 字符向量 | 字符串标量

LengthUnit — 半径的长度单位 '' (默认) | 字符向量 | 字符串标量

Radius — 球的半径 正有限标量

SemimajorAxis — 该球体的赤道半径 只读: 1 (默认) | 正有限标量

SemiminorAxis — 从球心到极点的距离 只读: 1 (默认) | 正有限标量

InverseFlattening — 扁率的倒数 只读: Inf (默认)

Eccentricity — 球体的第一偏心率 只读: 0 (默认)

Flattening — 球体的扁率 只读: 0 (默认)

ThirdFlattening — 球体的第三扁率 只读: 0 (默认)

MeanRadius — 球体的平均半径 只读: 正有限标量

SurfaceArea — 球体的表面积 只读: 正有限标量

Volume — 球体的体积 只读: 正有限标量

示例

创建以公里为单位的地球模型

为行星创建自定义模型

从坐标参考系获取参考球体

版本历史记录

另请参阅

`name` — 预定义参考球体的名称
`'Unit Sphere'` (默认) | `'earth'` | `'sun'` | `'moon'` | ...

`lengthUnit` — 长度单位
`''` (默认) | 字符向量 | 字符串标量

`Name` — 参考球体名称
`'Unit Sphere'` (默认) | 字符向量 | 字符串标量

`LengthUnit` — 半径的长度单位
`''` (默认) | 字符向量 | 字符串标量

`Radius` — 球的半径
正有限标量

`SemimajorAxis` — 该球体的赤道半径
只读: 1 (默认) | 正有限标量

`SemiminorAxis` — 从球心到极点的距离
只读: 1 (默认) | 正有限标量

`InverseFlattening` — 扁率的倒数
只读: `Inf` (默认)

`Eccentricity` — 球体的第一偏心率
只读: 0 (默认)

`Flattening` — 球体的扁率
只读: 0 (默认)

`ThirdFlattening` — 球体的第三扁率
只读: 0 (默认)

`MeanRadius` — 球体的平均半径
只读: 正有限标量

`SurfaceArea` — 球体的表面积
只读: 正有限标量

`Volume` — 球体的体积
只读: 正有限标量