Graphics by Location

<< Click to Display Table of Contents >>

Navigation:  ArcEQuIS >

Graphics by Location

 

Prerequisites

Boring Logs

Stiff Diagrams

Piper Diagrams

Cross-Sections

Troubleshooting

 

Arc_Graphics_Locations_ButtonThe ArcEQuIS add-in for ArcGIS Pro includes the Graphics by Location button, which can be found in the top ribbon of ArcGIS Pro under the ArcEQuIS tab, in the EnviroInsite Graphics section. This button allows users to click locations on the map to dynamically generate EnviroInsite graphics, such as boring logs. The ability to generate additional types of graphics will be added in future builds.

 

 

Graphics for the selected point(s) are downloaded to the computer running ArcGIS Pro as PDF files. By default, they will be saved to the following location:
C:\Users\[Your User Name]\Documents\ArcGIS\Projects\[Your ArcPro Project Name]\EQuISDownloads

 

Notes:

The Graphics by Location button will not be active if a facility location layer has not been added.

All active buttons will remain active if a site is removed.

 

Prerequisites

 

Before generating graphics by location from ArcGIS Pro, users need to have the following prerequisites in place (in addition to those required for ArcGIS Pro and the ArcEQuIS add-in):

 

1.Install a PDF viewer, such as Adobe Acrobat Reader, on the computer running ArcGIS Pro.
 

2.Install EnviroInsite (and prerequisites) on the EQuIS Enterprise server as detailed in the EQuIS Enterprise section of the help page here. Note that this will not require an EnviroInsite license. The EnviroInsite_Enterprise_package_x64_{version #}.zip file will be available on the EarthSoft Community Center Downloads Dashboard, regardless of whether or not an EnviroInsite license has been purchased. EarthSoft hosted clients (those with an EQuIS Enterprise site hosted by EarthSoft, generally with an equisonline.com URL) can contact EarthSoft Support to have EnviroInsite installed on their EQuIS Enterprise server.
 

3.The EarthSoft.Reports.Library.EnvironInsite.dll file needs to be published to the database in EQuIS Professional; specifically, the EnviroInsite Boring Logs, EnviroInsite Cross-Section, EnviroInsite Piper Diagram, and EnviroInsite Stiff Diagram reports.
 

4.Graphics require either a saved user report or a saved template WITH THE EXACT NAME detailed in the table below. Example templates are provided below and included with EQuIS Professional (Examples folder), if the Example Files option is checked during installation. Different templates can be created in EnviroInsite and used as long as they use the correct naming convention. Templates should be uploaded to the DT_FILE table via the EQuIS Professional Docs and Photos Form or the Enterprise Explorer Widget. Saved user reports should be created in the corresponding base report listed below.
 

5.There are certain data requirements needed for these EnviroInsite graphics. Check the corresponding documentation pages listed below for these data requirements.

 

Graphic

Template vs User Report

Required Name

Location

EnviroInsite Data Requirements

Boring Logs

Template

EIBoringLogTemplate.xml

DT_FILE

Tables and Fields used to Generate Full Page Boring Logs

Stiff Diagram

User Report

EIStiffDiagram_ArcEQuISTemplate.xml

Saved as user report in EnviroInsite Stiff Diagram Report

1.EnviroInsite Stiff Diagram

2.Stiff Diagram - Chart

Piper Diagram

User Report

EIPiperDiagram_ArcEQuISTemplate.xml

Saved as user report in EnviroInsite Piper Diagram Report

1.EnviroInsite Piper Diagram

2.Piper Diagram

Cross Sections

Template

EICrossSectionTemplate.xml

DT_FILE

1.EnviroInsite Cross-Section

2.Cross-Sections

 

Note: Example XML files for Boring Logs, Stiff Diagrams, Piper Diagrams, and Cross Sections are included with the EQuIS Professional installation package, available from the EarthSoft Community Center, and are located in the *\Examples\ArcGIS Pro folder.

 

Boring Logs

 

Generate boring logs in ArcEQuIS by following these steps:

1.In ArcGIS Pro, open a new or existing Map project and connect to an EQuIS facility.

2.Use the Add Data button under the ArcEQuIS tab to add a Locations Point or Polygon layer to the map.

3.Navigate to the Graphics by Location button (under the ArcEQuIS Tab). Click the drop-down arrow and select Boring Log.

 
Arc_Ribbon

 

4.The cursor should change to the crosshair Arc_Crosshair_Icon icon. Click a location to generate a boring log as a PDF file for that location. Boring logs will automatically be saved with the following naming convention:

[SYS_LOC_CODE]_BoringLog.pdf

 

arc_pane_boring_log_zoom65

 

Notes:

When the zoom resolution renders multiple locations as a single point or multiple locations are overlapping, selecting the single point will generate boring logs for all the locations.

If a boring log is generated for the same location multiple times (without changing the file location or name of the existing boring log), the new boring log file will overwrite the existing boring log file.

 

5.To exit the Graphics by Location tool, select another tool such as the Explorer tool, available under the Map tab on the Top Ribbon.

 

 

Stiff Diagrams

 

Use the same steps outlined above for boring logs to generate a Stiff diagram, but select Stiff Diagram in the Graphics by Location drop-down. Select a location to generate a Stiff diagram as a PDF file for that location. The PDF file will automatically be saved with the following naming convention:

[SYS_LOC_CODE]_StiffDiagram.pdf

 

arc_stiff_diagram_zoom50

 

Note: The Stiff Diagram templates for these reports in Enterprise only support the Output type of PDF.

 

 

Piper Diagrams

 

Piper diagrams can be generated using the same steps as boring logs and Stiff diagrams, except that multiple locations can be selected to add to the Piper diagram. The steps to generate a Piper diagram are as follows:

 

1.In ArcGIS Pro, open a new or existing Map project and connect to an EQuIS facility.  
 

2.Use the Add Data button under the ArcEQuIS tab to add a Locations Point or Polygon layer to the map.  
 

3.Navigate to the Graphics by Location button (Under the ArcEQuIS Tab). Click the drop-down arrow and select Piper Diagram.
 

4.The cursor should change to the crosshair Arc_Crosshair_Icon icon. Click the locations(s) to include in the Piper Diagram. Two small curved lines will be displayed at each of the selected locations as shown in this example point:
Arc_Example_Point.
 

5.When all locations have been selected, click the Finish button (left, green check). To change the selected locations, click the Cancel button (right, grey x) and make new selections.
Arc_Finish_Button

 

Once the Finish button is clicked, a new Piper diagram will be generated as a PDF file for the selected locations. The PDF file will automatically be saved with the following naming convention:

[FACILITY_ID]_Piper[date-time string of current time].pdf

 

arc_piper_diagram_zoom40

 

Notes:

The Piper Diagram templates for these reports in Enterprise only support the Output type of PDF.

There is a known issue when clicking the Finish button without making selections. If nothing is selected before the Finish button is clicked, ArcGIS Pro will crash.

 

 

Cross-Sections

 

Geological cross-section diagrams can be generated using the same general steps as other Graphics by Location, however, the user must draw a line on the map to identify the cross-section to generate. The steps to generate cross-sections are as follows:

1.In ArcGIS Pro, open a new or existing Map project and connect to an EQuIS facility.

2.Use the Add Data button under the ArcEQuIS tab to add a Locations Point or Polygon layer to the map. The Facility Locations layer needs to be the top layer in the Contents Pane.

3.Navigate to the Graphics by Location button (Under the ArcEQuIS Tab). Click the drop-down arrow and select Cross-Section.

4.Draw the line to use to create the cross-section on the map. Note that the line may only contain up to 6 points (2 end points and up to 4 intermediate points). To end the cross-section segment, double-click the end point.

 

Once the endpoint is double-clicked, a message will appear stating “Graphic is being generated”. A new cross-section diagram will be generated as a PDF file. The file will automatically be saved with the following naming convention:

[FACILITY_ID]_crosssection_[date-time string of current time].pdf

 

arc_cross-section_zoom40

 

The cross-section will by default use the ArcGIS Aerial Photo when generating the overview map in the diagram. In the example template, any wells within 25 feet of the cross-section line (measured once converted to UTM coordinates) will be displayed on the cross-section. This buffer distance can be set in the template when edited or created in EnviroInsite.

 

Notes:

A large number of locations may slow down the generation of the cross-section PDF file.

The cross-section may not generate if it is not zoomed to the extent of the location point layer. To zoom to the extent of the layer, right-click on the layer and select “Zoom to extent”.

 

 

Troubleshooting

 

If a "Graphics are being generated" message is displayed, but no graphics are rendered, please try the following:

 

1.Wait. Depending on the number of locations in the database, graphics may take several minutes to be generated.

 

2.Confirm that all the conditions covered in the Prerequisites section above have been met. Specifically, that the template file is appropriately named and located, and that EnviroInsite has been installed on the Enterprise server.

 

If ArcEQuIS exports a graphic, but it is blank or missing data, the underlying data required to generate the figure may not be present in the database. Check the underlying "EnviroInsite..." report that is being used in EQuIS Professional, and update the template files (covered in the Prerequisites section above) accordingly.

 

For Piper diagrams, ensure that the three analytes used in the report have data for the selected location(s), and that equivalent weights for each analyte are populated in the RT_ANALYTE_DETAIL.EQUIVALENT_WEIGHT fields. To ensure all the required data are present, run the Analytical Results II report for the analytes where RT_ANALYTE_DETAIL.EQUIVALENT_WEIGHT is populated. Then review this report output to ensure the following:

At least six analytes (three cations and three anions) are chosen that contain data from the same sample.

DT_RESULT.RESULT_UNIT cannot be null for any of the selected analytes.

DT_TEST.FRACTION should match across the selected analytes and this FRACTION should be selected as a parameter.

Duplicate records do not exist in RT_ANALYTE.CHEMICAL_NAME for any of the selected analytes.

 

For cross-sections, make sure that the extents (X_MIN, X_MAX, Y_MIN and Y_MAX) in the DT_FACILITY table are set correctly. These are used as the extents for the inset overview map, and if they are incorrect can result in an invalid output.