/*
USGS_Profile Tool
Description:
This JavaScript provides an extension to the HTML ArcIMS viewer that will
allow the user to enter several points and request an Elevation Profile
following those points. They can specify the points, Data source, and
either an interval in decimal degrees, or a number of samples to make
between points.
Requirements:
The Elevation_Profile_Chart PHP application must be installed on the server
with the phpChartDirector from advsofteng installed on the server also. A
virtual directory should be setup so that this exists off the root of the
server. Also, the getElevation_Profile.aspx must be in the XMLWebServices
directory of the server.
These have already been done on GISDATA servers.
Created By: Chris Rusanowski
Installation:
-Copy USGS_Elevation_Profile.js into the javascript directory of the HTML Viewer
-Include the javascript/USGS_Elevation_Profile.js in MapFrame.htm
-Add a button to the toolbar that calls parent.MapFrame.setProfileTool();
-Add code below to aimsCustom.js so the map tool functions...
if (toolMode == 1089) {
Profile_Add_Point_To_Array(e);
return false;
}
-Copy Silver_Elevation_Profile.gif and Red_Elevation_Profile.gif to usgs_images directory, and add button using these to toolbar... Code similar to below:
if (parent.MapFrame.useElevationProfile) { selectToolCount++; }
if (parent.MapFrame.useElevationProfile) {
if (parent.MapFrame.modeName == "ElevationProfile") {
LocalString += WriteButton( MakeButton2( "usgs_images/red_elevation_Profile.gif", 'Elevation Profile Tool', "elevation_profile", "parent.MapFrame.modeName=\'ElevationProfile\'; parent.MapFrame.Profile_setProfileTool();", 'status=\'Elevation Profile Tool\'', "", true ) );
} else {
LocalString += WriteButton( MakeButton2( "usgs_images/silver_elevation_Profile.gif", 'Elevation Profile Tool', "elevation_profile", "parent.MapFrame.modeName=\'ElevationProfile\'; parent.MapFrame.Profile_setProfileTool();", 'status=\'Elevation Profile Tool\'', "", true ) );
}
buttonCol++;
LocalString += Table_Structure(buttonCol,selectToolCount);
}
Future Enhancements:
-Display the profile segments on the map
This is just a matter of copying what the measure tool does into this
script and adding the code to the appropriate ESRI code...
-Vertical Exaggeration
-Plotting Segment, or sample point markers on X-Axis of profile
*/
var useElevationProfile=true;
var Profile_Point_Array = new Array();
var Profile_Interval='';
var Profile_Num_Samples='10';
var Profile_Elev_DataSet='-1';
var Profile_Width="600";
var Profile_Height="400";
var Profile_Skip_Zeros="FALSE";
var Profile_Units="FEET";
/*
function Add_Point_To_Array
*/
function Profile_Add_Point_To_Array(e) {
var theX = mouseX;
var theY = mouseY;
getMapXY(theX,theY);
var Num_Points = Profile_Point_Array.length;
Profile_Point_Array[Num_Points] = mapX;
Profile_Point_Array[Num_Points+1] = mapY;
Profile_Generate_User_Prompt_HTML();
// draw click points and lines between them on map
clickPointX[clickCount]=mapX;
clickPointY[clickCount]=mapY;
clickCount += 1;
legendTemp=legendVisible;
legendVisible=false;
var theString = writeXML();
var theNum = 99;
sendToServer(imsURL,theString,theNum);
}
/*
function Reset_Point_Array
*/
function Profile_Reset_Point_Array() {
Profile_Point_Array = new Array();
Profile_Generate_User_Prompt_HTML();
}
/*
function Profile_Open_Chart
*/
function Profile_Open_Chart() {
var temp_URL="http://"+ parent.USGShost + "/XMLWebServices/getElevation_Profile.aspx?Chart=1";
temp_URL += "&POINTS_LIST=" + Profile_Point_Array.join(',');
temp_URL += "&INTERVAL=" + Profile_Interval;
temp_URL += "&NUM_SAMPLES=" + Profile_Num_Samples;
temp_URL += "&ELEV_DATASET=" + Profile_Elev_DataSet;
temp_URL += "&ELEV_UNITS=" + Profile_Units;
temp_URL += "&WIDTH=" + Profile_Width;
temp_URL += "&HEIGHT=" + Profile_Height;
temp_URL += "&SKIP_ZEROS=" + Profile_Skip_Zeros;
//prompt("temp_URL" , temp_URL);
var temp_Window_Settings='titlebar=no,personalbar=no,directories=no,toolbar=no,location=no,directories=no,status=no,menubar=no,scrollbars=yes,resizable=yes,copyhistory=no,width='+Profile_Width+',height='+Profile_Height;
window.open(temp_URL, '', temp_Window_Settings);
}
/*
function Generate_User_Prompt_HTML
*/
function Profile_Generate_User_Prompt_HTML() {
var Num_Points = Profile_Point_Array.length;
var theFrame = "parent.MapFrame";
var WindowContent='';
if ((useExternalWindow) || (!useTextFrame)) {
theFrame = "opener";
if (parent.MapFrame!==null) { theFrame = "opener.parent.MapFrame"; }
}
var HTML_Content = '';
if (Num_Points<1) {
HTML_Content += 'Please Select a starting Point for the Elevation Profile by clicking on the map';
} else if (Num_Points>0 && Num_Points<3) {
HTML_Content += 'Please Select a second Point for the Elevation Profile by clicking on the map';
} else {
//HTML_Content += 'Generate a Profile between the ' + Num_Points / 2 + ' points by using the form below, or add additional points by clicking on the map.
';
HTML_Content += '';
}
Create_Pop_Up_Window("Elevation_Profile", "", HTML_Content, "Elevation_Profile", "", false)
}
/*
function setProfileTool
*/
function Profile_setProfileTool() {
var isOk;
var j;
if (hasLayer("measureBox")) {
hideLayer("measureBox");
}
panning=false;
zooming=false;
selectBox=false;
shapeSelectBuffer = false;
toolMode = 1089;
if (canQuery) {
if (isIE) {
document.all.theTop.style.cursor = "crosshair";
theCursor = document.all.theTop.style.cursor;
}
modeBlurb = "USGS Elevation Profile";
} else {
alert(msgList[46]);
}
showGeocode=false;
drawSelectBoundary=false;
//if (useTextFrame) { parent.TextFrame.document.location= appDir + "getElevation.htm"; }
//Profile_Point_Array.length=0
//Profile_Generate_User_Prompt_HTML();
Profile_Reset_Point_Array();
hideLayer("measureBox");
resetProfileClick();
}
// zero out all clicks in Num_Points
function resetProfileClick() {
clickCount=0;
clickPointX.length=1;
clickPointY.length=1;
legendTemp=legendVisible;
legendVisible=false;
var theString = writeXML();
var theNum = 99;
sendToServer(imsURL,theString,theNum);
}
function Process_Profile() {
Profile_Open_Chart();return false;
}
function Profile_Clear_Points() {
resetProfileClick();
Profile_Reset_Point_Array();return false;
}
function Profile_Set_Interval(Interval) {
Profile_Interval=Interval.value;return false;
}
function Profile_Process_Num_Samples(Num_Samples) {
Profile_Num_Samples=Num_Samples.value;return false;
}
function Profile_Process_Elev_DataSet(Elev_DataSet) {
Profile_Elev_DataSet=Elev_DataSet.value;return false;
}
function Profile_Set_Height(Height) {
Profile_Height=Height.value;return false;
}
function Profile_Set_Width(Width) {
Profile_Width=Width.value;return false;
}
function Profile_Set_Units(Units) {
Profile_Units=Units.value;return false;
}
function Profile_Set_Zeroes(Skip_Zeroes) {
Profile_Skip_Zeroes=Skip_Zeroes.value;return false;
}
function Profile_Options_Help() {
var HTML_Content = '';
HTML_Content += 'The default elevation profile options will generate a fast chart. The options below allow the user to generate a custom chart that may portray the elevation profile more accurately, or at a different size. A description of each option is below:
';
HTML_Content += 'DatasetThe Best Available Query will tell the USGS Elevation Web Service to return the first matching dataset at each point, starting from the Highest resolution data and proceeding to the lowest resolution dataset. This means a query that crosses multiple datasets will have the results from multiple datasets combined into one chart. It does not give any indication of which dataset each point comes from. The other dataset options will query only a single dataset, and if that dataset does not have coverage or values, then it will display a 0 or null value at that point on the profile.
';
HTML_Content += 'SamplesA profile is generated by calculating an increment along a line drawn between each point in the points list. The number of samples specifies how many elevation queries (samples) will be made between each set of points.
';
HTML_Content += 'IntervalThe Interval setting over-rides the samples option, if it is set. This is used to calculate a Samples value based upon the segment and the distance in decimal degrees specified in this option. This allows for each segment to have a similar sample ratio based upon the length of the segment and thus makes the profile proportional to the actual length of the lines.
';
HTML_Content += 'NOTE: Setting a small Interval, or large number of samples can make generating the profile take a long time, or time-out. Each segment is limited to a maximum of 500 samples, no matter which option above is specified.';
HTML_Content += '
UnitsThe USGS Elevation Web Service can return values in Feet or Meters, so you can specify which one your profile should use.
';
HTML_Content += 'Height and WidthThis is the height and width (in pixels) of the pop-up window that contains the profile.
';
Create_Pop_Up_Window("Elevation_Profile_Option_Help", "", HTML_Content, "Elevation_Profile_Option_Help", 'titlebar=no,personalbar=no,directories=no,toolbar=no,location=no,directories=no,status=no,menubar=no,scrollbars=yes,resizable=yes,copyhistory=no,width='+Profile_Width+',height='+Profile_Height, true)
}