AHGW:Import XS2D Image Wizard: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
No edit summary
 
Line 1: Line 1:
{{TOC right}}
{{TOC right}}
The ''XS2D Cross Section Image'' pane is accessed by clicking [[File:AHGW Build XS2D Background Icon.png]] '''2D Cross Section Image''' on the [[AHGW:Arc Hydro Groundwater Toolbar|Arc Hydro Groundwater Ribbon]]. This tool helps register a digital cross section image for use in building 2D cross sections in ArcGIS Pro.
[[File:ArcGIS Pro XS2D Cross Section Image.png|thumb|350px|right|''XS2D Cross Section Image'' pane]]
The following sections, options, and fields are available:
==SectionLine and Cross Section Setup==
*''SectionLine'' section – Contains tools for selecting the desired SectionLine. Also, lists attributes of the selected SectionLine.
**''SectionLine Layer'' – Select the desired SectionLine layer from the drop-down.
**[[File:Arcgispro Slct.png|16 px]] – Select this icon to activate the select tool. Then, left-click on the SectionLine feature that will be used to create the XS2D cross section. Once the SectionLine is selected, its attributes will appear in the ''ID'', ''Length'', and ''Name'' fields.
*''Cross Section Setup'' section
**''XS2D Catalog Table'' – Select the XS2D catalog table from the drop-down. The default is "XS2D_Catalog".
==Image File==
*''Image File'' section
**''Image file used'' – Displays the absolute path to an image file for creating the XS2D cross section. Click [[File:Arcgispro AddData.png|16 px]] to bring up the ''Choose XS2D Image'' dialog where an image file can be selected. After selecting an image in that dialog, click '''OK''' to close it and open the ''XS2D Image'' dialog.
***''XS2D Image'' dialog – This dialog has two sections.
****''Image'' section – Displays the image selected in the ''Choose XS2D Image'' dialog.
*****Referencing sliders – Use the sliders—labeled ''XLeft'', ''ZTop'', ''ZBottom'', and ''XRight''—to move the referencing lines (in green and red) to the referencing locations on the image.
****''Coordinates'' section – Displays coordinates for the X left and right and Z top and bottom of the image. Only the ''Z Top'' and ''Z Bottom'' are editable.
****''Finish'' – Saves the settings and closes the ''XS2D Image'' dialog.
[[File:ArcGIS Pro XS2D Image.png|thumb|350px|left|''XS2D Image'' dialog]]
{{-}}
==Panel Dividers, Grid settings, and Running the Tool==
*''Panel Divider Elevations'' section
**''Minimum'' – A decimal value for the minimum elevation at which to draw the panel divider.
**''Maximum'' – A decimal value for the maximum elevation at which to draw the panel divider.
**'''Suggest Elevations''' – Click to populate the above two fields with suggested values based on the image registration being used.
*''Grid Extent'' section
**''Top'' – Enter a decimal value for the maximum elevation.
**''Bottom'' – Enter a decimal value for the minimum elevation.
**''Left'' – Enter a decimal value for the left extent.
**''Right'' – Enter a decimal value for the right extent.
**'''Suggest Grid Extent''' – Click to populate the above four fields with suggested values based on the image registration being used.
*''Grid Spacing'' section
**''Distance between major grid lines''
***''Horizontal'' – A decimal value for the horizontal distance between vertical major grid lines.
***''Vertical'' – A decimal value for the vertical distance between horizontal major grid lines.
**''Number of minor grid lines''
***''Vertical'' – Integer value for number of minor grid lines between major vertical grid lines.
***''Horizontal'' – Integer value for number of minor grid lines between major horizontal grid lines.
**'''Suggest Grid Spacing''' – Click to populate the above four fields with suggested grid spacing values.
*'''Create XS2D Data''' – Runs the ''Create XS2D Cross Section'' tool. The tool uses the information entered to create an XS2D data frame and a map view representing the features entered. Once the XS2D data frame has been created, ArcGIS Pro drawing tools can be used to digitize a cross section.
{{-}}
==ArcGIS Notes==
While many of the features of this tool are the same between ArcGIS Pro and ArcGIS, there are some major differences. So for the convenience of those using Arc Hydro Groundwater in ArcGIS, all the documentation relevant to ArcGIS is found below, even if it's a repeat from documentation above.
The ''Import XS2D Image Wizard'' dialog is accessed by clicking [[File:AHGW Build XS2D Background Icon.png]] '''Import XS2D Image Wizard''' on the [[AHGW:Arc Hydro Groundwater Toolbar|Arc Hydro Groundwater Toolbar]]. This tool helps register a digital cross section image for use in building 2D cross sections in [[ArcGIS]].  
The ''Import XS2D Image Wizard'' dialog is accessed by clicking [[File:AHGW Build XS2D Background Icon.png]] '''Import XS2D Image Wizard''' on the [[AHGW:Arc Hydro Groundwater Toolbar|Arc Hydro Groundwater Toolbar]]. This tool helps register a digital cross section image for use in building 2D cross sections in [[ArcGIS]].  


Line 8: Line 52:
*Step 4: Grid Lines
*Step 4: Grid Lines


==Cross Section Setup==
===Cross Section Setup===
[[File:AHGW Import XS2D Image Wizard dialog Step 1.png|350px|thumb|right|The ''Step 1'' page of the ''Import XS2D Image Wizard'' dialog]]
[[File:AHGW Import XS2D Image Wizard dialog Step 1.png|350px|thumb|right|The ''Step 1'' page of the ''Import XS2D Image Wizard'' dialog]]
The following sections, options, and fields are available:
The following sections, options, and fields are available:
Line 22: Line 66:
*'''Cancel''' – Cancels any changes and exits the ''Import XS2D Image Wizard'' dialog.
*'''Cancel''' – Cancels any changes and exits the ''Import XS2D Image Wizard'' dialog.
{{-}}
{{-}}
==Image Registration==
===Image Registration===
[[File:AHGW Import XS2D Image Wizard Step 2.png|350px|thumb|right|The ''Step 2'' page of the ''Import XS2D Image Wizard'' dialog]]
[[File:AHGW Import XS2D Image Wizard Step 2.png|350px|thumb|right|The ''Step 2'' page of the ''Import XS2D Image Wizard'' dialog]]
The following sections, options, and fields are available:
The following sections, options, and fields are available:
Line 31: Line 75:
*'''Cancel''' – Cancels any changes and exits the ''Import XS2D Image Wizard'' dialog.
*'''Cancel''' – Cancels any changes and exits the ''Import XS2D Image Wizard'' dialog.
{{-}}
{{-}}
==Cross Sections Panels and Panel Dividers==
===Cross Sections Panels and Panel Dividers===
[[File:AHGW Import XS2D Image Wizard dialog Step 3.png|350px|thumb|right|The ''Step 3'' page of the ''Import XS2D Image Wizard'' dialog]]
[[File:AHGW Import XS2D Image Wizard dialog Step 3.png|350px|thumb|right|The ''Step 3'' page of the ''Import XS2D Image Wizard'' dialog]]
The following sections, options, and fields are available:
The following sections, options, and fields are available:
Line 45: Line 89:
*'''Cancel''' – Cancels any changes and exits the ''Import XS2D Image Wizard'' dialog.
*'''Cancel''' – Cancels any changes and exits the ''Import XS2D Image Wizard'' dialog.
{{-}}
{{-}}
==Grid Lines==
===Grid Lines===
[[File:AHGW Import XS2D Image Wizard dialog Step 4.png|350px|thumb|right|The ''Step 4'' page of the ''Import XS2D Image Wizard'' dialog]]
[[File:AHGW Import XS2D Image Wizard dialog Step 4.png|350px|thumb|right|The ''Step 4'' page of the ''Import XS2D Image Wizard'' dialog]]
The following sections, options, and fields are available:
The following sections, options, and fields are available:

Latest revision as of 19:02, 14 April 2023


The XS2D Cross Section Image pane is accessed by clicking AHGW Build XS2D Background Icon.png 2D Cross Section Image on the Arc Hydro Groundwater Ribbon. This tool helps register a digital cross section image for use in building 2D cross sections in ArcGIS Pro.

XS2D Cross Section Image pane

The following sections, options, and fields are available:

SectionLine and Cross Section Setup

  • SectionLine section – Contains tools for selecting the desired SectionLine. Also, lists attributes of the selected SectionLine.
    • SectionLine Layer – Select the desired SectionLine layer from the drop-down.
    • Arcgispro Slct.png – Select this icon to activate the select tool. Then, left-click on the SectionLine feature that will be used to create the XS2D cross section. Once the SectionLine is selected, its attributes will appear in the ID, Length, and Name fields.
  • Cross Section Setup section
    • XS2D Catalog Table – Select the XS2D catalog table from the drop-down. The default is "XS2D_Catalog".

Image File

  • Image File section
    • Image file used – Displays the absolute path to an image file for creating the XS2D cross section. Click Arcgispro AddData.png to bring up the Choose XS2D Image dialog where an image file can be selected. After selecting an image in that dialog, click OK to close it and open the XS2D Image dialog.
      • XS2D Image dialog – This dialog has two sections.
        • Image section – Displays the image selected in the Choose XS2D Image dialog.
          • Referencing sliders – Use the sliders—labeled XLeft, ZTop, ZBottom, and XRight—to move the referencing lines (in green and red) to the referencing locations on the image.
        • Coordinates section – Displays coordinates for the X left and right and Z top and bottom of the image. Only the Z Top and Z Bottom are editable.
        • Finish – Saves the settings and closes the XS2D Image dialog.
XS2D Image dialog


Panel Dividers, Grid settings, and Running the Tool

  • Panel Divider Elevations section
    • Minimum – A decimal value for the minimum elevation at which to draw the panel divider.
    • Maximum – A decimal value for the maximum elevation at which to draw the panel divider.
    • Suggest Elevations – Click to populate the above two fields with suggested values based on the image registration being used.
  • Grid Extent section
    • Top – Enter a decimal value for the maximum elevation.
    • Bottom – Enter a decimal value for the minimum elevation.
    • Left – Enter a decimal value for the left extent.
    • Right – Enter a decimal value for the right extent.
    • Suggest Grid Extent – Click to populate the above four fields with suggested values based on the image registration being used.
  • Grid Spacing section
    • Distance between major grid lines
      • Horizontal – A decimal value for the horizontal distance between vertical major grid lines.
      • Vertical – A decimal value for the vertical distance between horizontal major grid lines.
    • Number of minor grid lines
      • Vertical – Integer value for number of minor grid lines between major vertical grid lines.
      • Horizontal – Integer value for number of minor grid lines between major horizontal grid lines.
    • Suggest Grid Spacing – Click to populate the above four fields with suggested grid spacing values.
  • Create XS2D Data – Runs the Create XS2D Cross Section tool. The tool uses the information entered to create an XS2D data frame and a map view representing the features entered. Once the XS2D data frame has been created, ArcGIS Pro drawing tools can be used to digitize a cross section.


ArcGIS Notes

While many of the features of this tool are the same between ArcGIS Pro and ArcGIS, there are some major differences. So for the convenience of those using Arc Hydro Groundwater in ArcGIS, all the documentation relevant to ArcGIS is found below, even if it's a repeat from documentation above.


The Import XS2D Image Wizard dialog is accessed by clicking AHGW Build XS2D Background Icon.png Import XS2D Image Wizard on the Arc Hydro Groundwater Toolbar. This tool helps register a digital cross section image for use in building 2D cross sections in ArcGIS.

The dialog contains the following pages:

  • Step 1: Cross Section Setup
  • Step 2: Image Registration
  • Step 3: Cross Sections Panels and Panel Dividers
  • Step 4: Grid Lines

Cross Section Setup

The Step 1 page of the Import XS2D Image Wizard dialog

The following sections, options, and fields are available:

  • Section Line Properties section – Not user editable. Lists attributes of the selected section line.
  • Cross Section Setup section
    • XS2D Catalog Table – Select the XS2D catalog table from the drop-down. The default is "XS2D_Catalog".
    • Default output workspace – Displays the absolute path to the output workspace. Click Dot dot dot button.png to bring up the Select Output Workspace dialog where a new output workspace can be created.
  • Image File section
    • Image file used for creating the XS2D Cross Section – Displays the absolute path to an image file. Click Dot dot dot button.png to bring up the Open XS2D Image File dialog where an image file can be selected.
  • Image Registration Options section
    • Horizontal (X-Coordinate) registration option – Radio button. Select either "Use endpoints of section line" or "Use selected intermediate registration points".
  • Next – Switches to the second page of the Import XS2D Image Wizard dialog.
  • Cancel – Cancels any changes and exits the Import XS2D Image Wizard dialog.


Image Registration

The Step 2 page of the Import XS2D Image Wizard dialog

The following sections, options, and fields are available:

  • Image section – Displays the image entered in the Image file used for creating the XS2D Cross Section field of the previous page.
  • Coordinates section – Displays coordinates for the X left and right and Z top and bottom of the image.Only the Z Top and Z Bottom are editable.
  • Back – Switches back to the first page of the Import XS2D Image Wizard dialog.
  • Next – Switches to the third page of the Import XS2D Image Wizard dialog.
  • Cancel – Cancels any changes and exits the Import XS2D Image Wizard dialog.


Cross Sections Panels and Panel Dividers

The Step 3 page of the Import XS2D Image Wizard dialog

The following sections, options, and fields are available:

  • Cross Section Panels section
    • Output panel feature class – An optional path. Click Dot dot dot button.png to bring up the Save Panel Features As dialog where a new feature class can be entered and saved.
  • Panel Dividers section
    • Output panel divider feature class – An optional path. Click Dot dot dot button.png to bring up the Save Panel Divider Features As dialog where a new feature class can be entered and saved.
    • Maximum elevation to draw the panel divider – A decimal value for the maximum elevation at which to draw the panel divider.
    • Minimum elevation to draw the panel divider – A decimal value for the minimum elevation at which to draw the panel divider.
    • Suggest Values Based on Image Registration – Click to populate the above two fields with suggested values based on the image registration being used.
  • Back – Switches back to the second page of the Import XS2D Image Wizard dialog.
  • Next – Switches to the fourth page of the Import XS2D Image Wizard dialog.
  • Cancel – Cancels any changes and exits the Import XS2D Image Wizard dialog.


Grid Lines

The Step 4 page of the Import XS2D Image Wizard dialog

The following sections, options, and fields are available:

  • Output major grid feature class – An optional path. Click Dot dot dot button.png to bring up the Save Major Grid Features As dialog where a new feature class can be entered and saved.
  • Output minor grid feature class – An optional path. Click Dot dot dot button.png to bring up the Save Minor Grid Features As dialog where a new feature class can be entered and saved.
  • Grid Extent section – Listed clockwise from the top:
    • Maximum elevation – Enter a decimal value for the maximum elevation.
    • Right – Enter a decimal value for the right extent.
    • Minimum elevation – Enter a decimal value for the minimum elevation.
    • Left – Enter a decimal value for the left extent.
    • Suggest Extent Based on Image Registration – Click to populate the above four fields with suggested values based on the image registration being used.
  • Grid Spacing section
    • Horizontal distance between vertical major grid lines – Integer value.
    • Vertical distance between horizontal major grid lines – Integer value.
    • Number of minor grid lines between major vertical grid lines – Integer value.
    • Number of minor grid lines between major horizontal grid lines – Integer value.
    • Suggest Grid Spacing – Click to populate the above four fields with suggested grid spacing values.
  • Back – Switches back to the third page of the Import XS2D Image Wizard dialog.
  • Finish – Saves the values and closes the Import XS2D Image Wizard dialog.
  • Cancel – Cancels any changes and exits the Import XS2D Image Wizard dialog.