public class cwcoverage
extends java.lang.Object
The coverage tool creates an earth data coverage map.
cwcoverage - creates an earth data coverage map.
cwcoverage [OPTIONS] input1 [input2 ...] output
cwcoverage [OPTIONS] output
-h, --help
-v, --verbose
--version
-a, --noantialias
-b, --background=COLOR
-c, --center=LATITUDE/LONGITUDE
-f, --foreground=COLOR
-s, --size=PIXELS
-H, --highlight=PATTERN
-l, --labels=LABEL1/LABEL2/...
-m, --map=OUTPUT
-x, --box=COLOR
-C, --stationcolor=COLOR
-e, --elevation=DEGREES
-E, --height=KILOMETERS
-L, --stationlabels=LABEL1/LABEL2/...
-S, --stations=LAT1/LON1/LAT2/LON2/...
The coverage tool creates an earth data coverage map by accessing a number of user-specified earth data sets and tracing the boundaries onto an orthographic map projection. The map is output as a PNG graphics file. Approximate satellite ground station coverage boundaries may also be added to the map.
<map name="coverage_map"> <area shape="poly" id="region_0" coords="111,64,170,63,179,132,108,134,111,64" /> <area shape="poly" id="region_1" coords="75,106,132,109,133,179,66,174,75,106" /> <area shape="poly" id="region_2" coords="121,124,183,121,192,188,119,191,121,124" /> </map>The map may be used in an HTML document in conjunction with the output PNG coverage image to provide users with a clickable interface for area of interest selection.
0 on success, > 0 on failure. Possible causes of errors:
As an example, the following command shows the creation of a coverage plot of the ER and SR CoastWatch regions covering the US East coast:
phollema$ cwcoverage -v --labels ER/SR 2004_155_1147_n15_er.hdf 2004_155_1147_n15_sr.hdf east_coast.png cwcoverage: Reading input 2004_155_1147_n15_er.hdf cwcoverage: Reading input 2004_155_1147_n15_sr.hdf cwcoverage: Writing east_coast.png
Modifier and Type | Method and Description |
---|---|
static LineFeature |
getCircle(EarthLocation center,
double radius,
int segments)
Creates a circle of earth locations centered at the
specified location.
|
static double |
getVisibility(double radius,
double height,
double elev)
Calculates the angle of visibility for a satellite capture station.
|
static void |
main(java.lang.String[] argv)
Performs the main function.
|
public static double getVisibility(double radius, double height, double elev)
radius
- the radius of the earth in kilometers.height
- the height of the satellite above the surface in kilometers.elev
- the elevation for the satellite receiver above the horizon
in degrees.public static LineFeature getCircle(EarthLocation center, double radius, int segments)
center
- the center location.radius
- the circle radius in degrees. The circle radius is
essentially the great circle distance between the center of the
circle and the radial points.segments
- the number of segments around the circle.public static void main(java.lang.String[] argv)
argv
- the list of command line parameters.