The distcomp application is used to calculate and display the differences between two data sets, or one data set and a series of other data sets. The distcomp application is composed of three sections (Figure 7.1); the main menu- bar, the status and log text area, and the drawing or graph area. The menu-bar is used to select all distcomp commands, the log/status area is used by the program to report important messages or results, and the drawing area is the display area for the histograms and probability plots.

 Figure 7.1

The Main Menu:

File:

 Figure 7.2

View:

WARNING: if "distcomp.prf" already exists, you will be warned that it is about to be over- written. If you do not want the old version destroyed you must move it to a new file (e.g. the UNIX command mv distcomp.prf distcomp.old.prf would be sufficient). When you press OK, the old version will be over-written! This cannot be done from within the application. To rename the file you will have to execute the UNIX mv command from a UNIX prompt in another window.

If "distcomp.prf" does not exist in the current directory, it is created. This is an ASCII file and can be edited by the user. See Appendix C for details.

Print Setup:

[TOP] [SYNTAX]

 Figure 7.3

[TOP] [SYNTAX]

 Figure 7.4 and

Cumulative Distributions:

 Figure 7.5

1.0 - Cumulative Distributions:

 Figure 7.6

Probability Plots:

The Exceedence Type only affects the labeling on the X-axis. An Exceedence plot indicates the percentage of points which exceed a specified value. A Nonexceedence plot indicates the percentage of points which do not exceed a specified value. The appearance of the graphs otherwise is identical.

The Hazen and Weibull methods are two methods for determining the Rank Order of one data value within the data set. For further details see the histo Mathematics section (Equations 6-12 and 6-13), or refer to McCuen (1989).

It is common in nature that the distribution of a measured parameter has a log distribution (This is set with the Style:Transform Type:Log menu option discussed below). If this is the case, a Normal probability plot will show a curved line (Figure 6.7a). From the curved line, though one can say the data is not normally distributed, but little more. By Log transforming the data, if the line becomes "straight," the probability plot suggests that the data is log-normally distributed (Figure 6.7b).

 Figure 7.7a and  Figure 7.7b

P-P Plots:

 Figure 7.8a

 Figure 7.8b

 Figure 7.8c

Q-Q Plots:

 Figure 7.9a

 Figure 7.9b

 Figure 7.9c

Y-Axis Type:

NOTE: The transforms use the log base 10, not natural log.

[TOP] [SYNTAX]

Line #1 = Mean Value Data Line
Line #2 = Standard Deviation Error-Bars
Line #3+ = Histogram bars

This dialog is described in the Graph:Style section of Chapter 5 (Figure 5.14).

Mesh:

[TOP] [SYNTAX]

[TOP] [SYNTAX]

[TOP] [SYNTAX]

[TOP] [SYNTAX]

[TOP]

Running From the Command Line:

Syntax:

distcomp [-dive #.#] [-divn #] [-divr #] [-divs #.#] [-divw #.#] [-dm #] [-dme #] [-dsd #] [-esp #] [-exceed #] [-ft #] [-help] [-lc #] [-leg #] [-lgf " "] [-lglp #] [-lgmw #] [-lpbm #.#] [-lpc #] [-lpd #] [-lpf " "] [-lph #] [-lplm #.#] [-lppsext " "] [-lpo #] [-lpq " "] [-lpr] [-lprm #.#] [-lps #] [-lptm #.#] [-lsc #] [-lsfl #] [-lssz #.#] [-lsty #] [-ltk #.#] [-lty #] [-md #.#] [-moy #.#] [-ms #] [-mx #.#] [-my #.#] [-nt #] [-prf " "] [-pt #] [-rfh #] [-ro #] [-se #.#] [-ss #.#] [-sttl " "] [-tt #] [-ttl " "] [-xfmt " "] [-xlabel " "] [-xmax #.#] [-xmin #.#] [-xMt #.#] [-xmt #] [-xto #.#] [-xy #.#] [-yfmt " "] [-ylabel " "] [-ymax #.#] [-ymin #.#] [-yMt #.#] [-ymt #] [-ys #] [-yto #.#] [filename]

# = integer
#.# = float
" " = character string.
{} = variable is an array. Values must be seperated by a ',' and no spaces are allowed. Do not use the "{ }" symbols on the command line.

NOTES:

1). All parameters in [] brackets are optional.
2). Quotes must be used around character strings.
3). Filename, if given, must be listed last.
4). If no default is given, the feature is not currently supported on command line.

If no entry is required for flag, flag command executed.

Flag Definitions:

-dive	=	histogram bar ending location	default = data maximum
-divn	=	number of divisions (histogram bars)	default = 10
-divr	=	division method	default = 0
		0 1 2 = = = number of divisions equal division width equal percentage divisions
-divs	=	histogram bar starting location	default = data minimum
-divw	=	division width (histogram bars)	default = data range / 10.0
-dm	=	draw mean	default = 1
		0 1 = = False True
-dme	=	draw median	default = 1
		0 1 = = False True
-dsd	=	draw standard deviation	default = 1
		0 1 = = False True
-esp	=	exageration scale priority	default = 0
		0 1 = = favor y-exageration scale (-ys) favor x/y ratio
-exceed	=	exceedence on nonexceedence switch	default = 0
		0 1 = = Exceedence Nonexceedence
-fnt1	=	main title font	default = Helvetica-Bold
-fnt2	=	secondary title font	default = Helvetica-Bold
-fnt3	=	axes label font	default = Helvetica
-fnt4	=	division font	default = Helvetica
-fnt5	=	annotation font	default = Helvetica
-fnt6	=	mouse position font	default = Helvetica
-fnts1	=	main title font size	default = 24.0
-fnts2	=	main title font size	default = 15.0
-fnts3	=	main title font size	default = 15.0
-fnts4	=	main title font size	default = 12.0
-fnts5	=	main title font size	default = 10.0
-fnts6	=	main title font size	default = 12.0
-ft	=	frequency type	default = 0
		0 1 = = Count Percentage
-help	=	give this help menu
-lc {}	=	line color	default = variable
		0 1 2 3 4 5 6 7 = = = = = = = = Black White Red Green Blue Magenta Yellow Cyan
-leg	=	draw line legend	default =1
		0 1 = = False True
-lgf	=	log file name	defalut = "log.dat"
-lglp	=	line legend position	default = 1
		0 1 2 3 = = = = Top left Top right Bottom left Bottom right
-lgmw	=	maximum line legend width	default = 200
-lpbm	=	page bottom margin	default = 1.5
-lpc	=	number of copies to print	default = 1
-lpd	=	print destination	default = 0
		0 1 = = Printer File
-lpf	=	print filename	default = "junk.ps"
-lph	=	print header page	default = 0
		0 1 = = False True
-lplm	=	page left margin	default = 1.5
-lpo	=	print orientation	default = 0
		0 1 = = Portrait Landscape
-lppsext	=	search extention for postscript files	default = "*.ps"
-lpq	=	print queue	default = "ps"
-lpr	=	print file at specified orientations
-lprm	=	page right margin	default = 1.0
-lps	=	print output	default = 0
		0 1 = = Black & white Color
-lptm	=	page top margin	default = 1.5
-lsfl {}	=	fill line symbol	default = 0
		0 1 = = False True
-lsc {}	=	line symbol color	default = variable
		1 2 3 4 5 6 7 = = = = = = = Black White Red Green Blue Magenta Yellow Cyan
-lssz {}	=	line synbol size	default = 9.0
-lsty {}	=	line symbol type	default = 0
		-1 0 1 2 3 4 = = = = = = No Symbol Circle Cross Diamond Square X
-ltk {}	=	line thickness	default = 1.0
-lty {}	=	line type	default = 0
		-1 0 1 2 = = = = No Line Solid Dashed Double Dashed
-md	=	dash mesh	default = 0
		0 1 = = False True
-mox	=	X mesh origin	default = 0.0
-moy	=	Y mesh origin	default = 0.0
-ms	=	use mesh	default = 0
		0 1 = = False True
-mx	=	X mesh frequency	default = 1/10 DX
-my	=	Y mesh frequency	default = 1/10 DY
-nt	=	show normal curve(s)	default = 1
		0 1 = = Show Hide
-prf	=	preference file name	defalut = "distcomp.prf"
-pt	=	plot type	default = 0
		0 1 2 3 4 5 6 = = = = = = = Histogram Cumulative Distribution Function 1 - CDF Probability P-P Plot Q-Q Plot
-rfh	=	screen refresh	default = 0
		0 1 = = On exposure On update
-ro	=	rank order option	default = 1
		0 1 = = Hazen (2i - 1) / 2n Weibull 1 / (n - 1)
-se	=	series file ending ID	default = last series ID
-ss	=	series file starting ID	default = 1
-sttl	=	Secondary title	default = " "
-tt	=	transform type	default = 0
		0 1 = = Normal Log (Base 10)
-ttl	=	Main title	default = Filename
-xMt	=	X main tic frequency	default = 1/10 DX
-xfmt	=	Number of decimal places for X-axis	default = ".2f"
-xlabel	=	X-axis label	default = "X"
-xmax	=	Graph X-maximum	default = Data Maximum
-xmin	=	Graph X-minimum	default = Data Minimum
-xmt	=	Number of minor X tics	default = 5
-xto	=	X axis label origin	default = 0.0
-xy	=	xy ratio	default = 1.5
-yMt	=	X main tic frequency	default = 1/10 DY
-yfmt	=	Number of decimal places for X-axis	default = ".2f"
-ylabel	=	X-axis label	default = "Y"
-ymax	=	Graph Y-maximum	default = Data Maximum
-ymin	=	Graph Y-minimum	default = Data Minimum
-ymt	=	Number of minor Y tics	default = 5
-ys	=	Y-axis exageration relative to X-axis	default = Calculated
-yto	=	X axis label origin	default = 0.0

distcomp -lpr -xmin 0.0 -ymin 0.0 -ymax 12.0 -md 1 -ms 1 -mx 1.0 -my 1.0 -xMt 1.0 - yMt 1.0 -ttl "Semivariogram of Elevation Data" -sttl "UNCERT histo module" - xlabel "distance (feet)" -ylabel "gamma h" -xfmt ".1f" -yfmt ".1f" -esp 1 -xy 1.0 finfac.dat

[TOP]