addCustomTerrain

Add custom terrain data

Description

example

addCustomTerrain(name,files) adds the terrain data specified with a user-defined name and files. You can use this function to add custom terrain data in Site Viewer and other RF propagation functions. You can access the custom terrain data in the current and future sessions of MATLAB® until you call removeCustomTerrain.

addCustomTerrain(___,Name,Value) adds custom terrain data with additional options specified by one or more name-value pairs.

Examples

collapse all

Add a custom terrain using n44_w072_3arc_v1.dt1 DTED file.

addCustomTerrain('mydted5','n44_w072_3arc_v1.dt1')

Use the custom terrain name in Site Viewer.

viewer = siteviewer('Terrain','mydted5');

Create a site with the terrain region.

mtwash = txsite('Name','Mt Washington', ...
'Latitude',44.2706, ...
'Longitude',-71.3033, ...
'AntennaHeight', 30);
show(mtwash)

Create a coverage map.

coverage(mtwash)

Remove the custom terrain.

close(viewer)
removeCustomTerrain("mydted5")

Input Arguments

collapse all

User-defined identifier for terrain data, specified as a string scalar or a character vector.

Data Types: char | string

List of DTED files, specified as a string scalar, a character vector or a cell array of character vectors.

Note

If you specify multiple files, they must combine to define a complete rectangular geographic region. If not, you must set the name-value pair 'FillMissing' to 'true'.

Data Types: char | string

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: 'FillMissing',true

Attribution of custom terrain data, specified as a character vector or a string scalar. The attribution is displayed on the Site Viewer map. By default, the value is empty.

Data Types: char | string

Fill data of missing files with value 0, specified as true or false. Missing file values are required to complete a rectangular geographic region with the input files.

Data Types: logical

Name of folder to write extracted terrain files to, specified as a character vector or a string scalar. The folder must exist and have write permissions. The default value is a folder name generated using tempname.

Data Types: char | string

Introduced in R2019a