distance

사이트 간 거리

구문

d = distance(site1,site2)

d = distance(site1,site2,path)

d = distance(___,Name=Value)

설명

d = distance(site1,site2)는 지정된 사이트 간의 거리(단위: 미터)를 계산합니다. 기본적으로 이 함수는 유클리드 거리를 계산합니다.

d = distance(site1,site2,path)는 지정된 경로 유형(유클리드 경로 또는 대권 경로)을 사용하여 거리를 계산합니다.

d = distance(___,Name=Value)는 이름-값 인수를 사용하여 옵션을 지정합니다.

예제

송신기 사이트와 수신기 사이트 간 거리 계산하기

송신기 사이트와 수신기 사이트를 만듭니다. 지리 좌표를 사용하여 위치를 지정합니다.

tx = txsite(Name="MathWorks", ...
    Latitude=42.3001, ...
    Longitude=-71.3504);
rx = rxsite(Name="Fenway Park", ...
    Latitude=42.3467, ...
    Longitude=-71.0972);

사이트 간의 거리를 계산합니다. 이 함수는 결과를 미터 단위로 반환합니다. 기본적으로 이 함수는 유클리드 경로를 사용하여 거리를 계산합니다.

dme = distance(tx,rx)

dme = 2.1504e+04

거리를 킬로미터로 변환합니다.

dkm = dme / 1000

dkm = 21.5037

대권 경로를 사용하여 거리 계산하기

송신기 사이트와 수신기 사이트를 만듭니다. 지리 좌표를 사용하여 위치를 지정합니다.

tx = txsite(Name="MathWorks", ...
    Latitude=42.3001, ...
    Longitude=-71.3504);
rx = rxsite(Name="Fenway Park", ...
    Latitude=42.3467, ...
    Longitude=-71.0972);

대권 경로를 사용하여 사이트 간의 거리를 계산합니다. 이 함수는 결과를 미터 단위로 반환합니다. 거리를 미터에서 킬로미터로 변환합니다.

dme = distance(tx,rx,"greatcircle");
dkm = dme / 1000

dkm = 21.4515

입력 인수

site1, site2 — 송신기 또는 수신기 사이트

txsite 객체 | rxsite 객체

송신기 또는 수신기 사이트로, txsite 객체 또는 rxsite 객체로 지정됩니다. 배열 입력값을 사용하여 여러 개의 사이트를 지정합니다.

path — 측정 경로 유형

"euclidean" (디폴트 값) | "greatcircle"

측정 경로 유형으로, 다음 중 하나로 지정됩니다.

• "euclidean" — 사이트의 안테나 중심 위치를 연결하는 공간을 통과하는 최단 경로를 사용합니다. 이는 카테시안 사이트와 지리 사이트 모두에서 디폴트 옵션입니다.

• "greatcircle" — 사이트의 지리 위치를 연결하는 구형 지표면 상의 최단 경로를 사용합니다. 이 옵션을 사용하려면 해당 사이트의 CoordinateSystem 속성이 "geographic"이어야 합니다.

데이터형: char

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

예: d = distance(site1,site2,Map="myfile.stl")은 맵을 STL 파일로 지정합니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: d = distance(site1,site2,"Map","myfile.stl")은 맵을 STL 파일로 지정합니다.

Map — 시각화 또는 지표면 데이터용 맵

siteviewer 객체 | triangulation 객체 | string형 스칼라 | 문자형 벡터

시각화 또는 지표면 데이터용 맵으로, siteviewer 객체, triangulation 객체, string형 스칼라 또는 문자형 벡터로 지정됩니다. 유효한 값과 디폴트 값은 좌표계에 따라 다릅니다.

좌표계	유효한 맵 값	디폴트 맵 값
"geographic"	siteviewer 객체. a 지형 이름(함수가 출력 인수와 함께 호출되는 경우). 유효한 지형 이름은 다음과 같습니다. "none" — 모든 위치에서 지형 고도가 0입니다. "gmted2010" — USGS GMTED2010 지형 데이터. 이 옵션을 사용하려면 인터넷 연결이 필요합니다. addCustomTerrain 함수를 사용하여 추가된 사용자 지정 지형 데이터의 이름으로, string형 스칼라 또는 문자형 벡터를 사용하여 지정됩니다.	현재 siteviewer 객체(함수가 출력과 함께 호출되지 않는 경우), 또는 새 siteviewer 객체(열려 있는 객체가 없는 경우). 기본적으로 siteviewer 객체는 USGS GMTED2010 지형 데이터를 사용합니다. "gmted2010"(함수가 출력과 함께 호출되는 경우).
"cartesian"	"none" siteviewer 객체. glTF™ 파일의 이름으로, string형 스칼라 또는 문자형 벡터를 사용하여 지정됩니다. STL 파일의 이름으로, string형 스칼라 또는 문자형 벡터를 사용하여 지정됩니다. triangulation 객체.	"none"
a Alignment of boundaries and region labels are a presentation of the feature provided by the data vendors and do not imply endorsement by MathWorks®.

대부분의 경우 이 인수를 siteviewer 또는 "none" 이외의 값으로 지정하면 출력 인수도 지정해야 합니다.

출력 인수

d — 사이트 간 거리(단위: 미터)

M×N 숫자형 배열

사이트 간 거리(단위: 미터)로, M×N 숫자형 배열로 반환됩니다. 여기서 M은 site2에 포함된 사이트 수이고, N은 site1에 포함된 사이트 수입니다.

버전 내역

R2019b에 개발됨

참고 항목

함수

• angle

객체

• txsite | rxsite