Add Data To BIS (Bathymetry)

Zusammenfassung

Registers raster and feature class data to a Bathymetric Information System (BIS).

Verwendung

  • The Target Workspace parameter value must be a workspace that contains a BIS.

  • Inputs can be datasets, spatial data types, or workspaces. Nonspatial data types, such as tables, are not valid inputs.

  • Multiple datasets can be added to the BIS at the same time; however, datasets with elevation values should share the same Vertical Units and Directionality parameter values. The vertical units and directionality values that are provided will be used for all datasets added at once.

  • You must have read access to both the input workspace and the target workspace to add data to the BIS.

  • Refresh the layers in the List By Data Source tab of the Contents pane to see datasets added by other users when adding data to an enterprise geodatabase BIS.

Parameter

BeschriftungErläuterungDatentyp
Target Workspace

The enterprise or file geodatabase where the BIS is located.

Workspace
Input Data

The input workspaces, datasets, layers, or feature classes that contain the data that will be added to the target BIS.

Workspace; Feature Layer; Image Service; Raster Layer; Mosaic Layer; Layer File; ServerConnection; TIN Layer
Input Types
(optional)

Specifies the types of data that will be included from any workspaces provided in the Input Data parameter. All data types are included by default.

  • Feature ClassFeature classes will be included.
  • Feature ServiceFeature services will be included.
  • Image ServiceImage services will be included.
  • Layer FileLayer files will be included.
  • Map ServiceMap services will be included.
  • Mosaic DatasetMosaic datasets will be included.
  • Raster DatasetRaster datasets will be included.
  • Scene Layer PackageScene layer packages will be included.
  • TINTIN datasets will be included.
String
Include Subfolders
(optional)

Specifies whether the contents of a workspace subfolder will be added to the BIS. This parameter is not applicable to file or enterprise geodatabases.

  • Checked—Valid data found in the subfolders will be added to the BIS.
  • Unchecked— Subfolder contents will not be added to the BIS. This is the default.
Boolean
Footprint Type
(optional)

Specifies whether the footprint will be the full extent of the dataset or a convex hull representing the minimum bounding box for all features.

  • Envelope The footprint will be the full extent of the dataset. This is the default.
  • Convex Hull The footprint will be a convex polygon representing the minimum bounding box for all features.
String
Vertical Units

Specifies the vertical units that will be used for the depth data.

  • Meters The vertical units will be meters.
  • Feet The vertical units will be feet.
  • US Survey Feet The vertical units will be U.S. Survey feet.
  • Fathoms The vertical units will be fathoms.
String
Directionality
(optional)

Specifies the directionality of the elevation data.

  • Positive UpThe directionality of elevation data will be positive up.
  • Positive DownThe directionality of elevation data will be positive down.
String
BAG Metadata Mapping File
(optional)

The metadata mapping file that contains the XML element tree mapping information for Bathymetric Attributed Grid (BAG) internal metadata. This metadata mapping file can be used if the add_bag_metadata_fields.py script has first been run on the BIS. Both the Python script and the mapping file are in the ArcGIS Bathymetry product data files at <installation location>\ArcGIS Bathymetry\Product Files\<version>\BAGSupport. If the BAG metadata mapping file is used, internal BAG metadata will be extracted from input BAGs and the values will be populated in the BIS Catalog.

File
Update Overviews
(optional)

Specifies whether overviews and statistics for a mosaic dataset will be calculated and updated.

  • Checked—Overviews and statistics will be calculated and updated. This is the default.
  • Unchecked—Overviews and statistics will not be calculated and updated.

Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Updated BIS

The updated BIS workspace.

Workspace

arcpy.bathymetry.AddDataToBIS(target_workspace, in_data, {input_types}, {include_subfolders}, {footprint_type}, vertical_units, {directionality}, {in_bag_metadata_mapping_file}, {update_overviews})
NameErläuterungDatentyp
target_workspace

The enterprise or file geodatabase where the BIS is located.

Workspace
in_data
[in_data,...]

The input workspaces, datasets, layers, or feature classes that contain the data that will be added to the target BIS.

Workspace; Feature Layer; Image Service; Raster Layer; Mosaic Layer; Layer File; ServerConnection; TIN Layer
input_types
[input_types,...]
(optional)

Specifies the types of data that will be included from any workspaces provided in the input_data parameter. All data types are included by default.

  • FEATURE_CLASSFeature classes will be included.
  • FEATURE_SERVICEFeature services will be included.
  • IMAGE_SERVICEImage services will be included.
  • LAYER_FILELayer files will be included.
  • MAP_SERVICEMap services will be included.
  • MOSAIC_DATASETMosaic datasets will be included.
  • RASTER_DATASETRaster datasets will be included.
  • SCENE_LAYER_PACKAGEScene layer packages will be included.
  • TINTIN datasets will be included.
String
include_subfolders
(optional)

Specifies whether the contents of a workspace subfolder will be added to the BIS. This parameter is not applicable to file or enterprise geodatabases.

  • INCLUDE_SUBFOLDERSValid data found in the subfolders will be added to the BIS.
  • NOT_INCLUDE_SUBFOLDERS Subfolder contents will not be added to the BIS. This is the default.
Boolean
footprint_type
(optional)

Specifies whether the footprint will be the full extent of the dataset or a convex hull representing the minimum bounding box for all features.

  • ENVELOPE The footprint will be the full extent of the dataset. This is the default.
  • CONVEX_HULL The footprint will be a convex polygon representing the minimum bounding box for all features.
String
vertical_units

Specifies the vertical units that will be used for the depth data.

  • METERS The vertical units will be meters.
  • FEET The vertical units will be feet.
  • FEET_US The vertical units will be U.S. Survey feet.
  • FATHOMS The vertical units will be fathoms.
String
directionality
(optional)

Specifies the directionality of the elevation data.

  • POSITIVE_UPThe directionality of elevation data will be positive up.
  • POSITIVE_DOWNThe directionality of elevation data will be positive down.
String
in_bag_metadata_mapping_file
(optional)

The metadata mapping file that contains the XML element tree mapping information for Bathymetric Attributed Grid (BAG) internal metadata. This metadata mapping file can be used if the add_bag_metadata_fields.py script has first been run on the BIS. Both the Python script and the mapping file are in the ArcGIS Bathymetry product data files at <installation location>\ArcGIS Bathymetry\Product Files\<version>\BAGSupport. If the BAG metadata mapping file is used, internal BAG metadata will be extracted from input BAGs and the values will be populated in the BIS Catalog.

File
update_overviews
(optional)

Specifies whether overviews and statistics for a mosaic dataset will be calculated and updated.

  • UPDATE_OVERVIEWSOverviews and statistics will be calculated and updated. This is the default.
  • NOT_UPDATE_OVERVIEWSOverviews and statistics will not be calculated and updated.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
updated_bis

The updated BIS workspace.

Workspace

Codebeispiel

AddDataToBIS example (stand-alone script)

The following stand-alone script demonstrates how to use the AddDataToBIS function.

# Import arcpy module and toolbox
import arcpy
arcpy.CheckOutExtension("Bathymetry")

# Identify tool parameters
target_workspace = r"C:\Data\BIS.gdb"
input_data = r"C:\Data\datasets"
input_types = None
include_subfolders = "NOT_INCLUDE_SUBFOLDERS"
footprint_type = "ENVELOPE"
vertical_units = "METERS"
directionality = "POSITIVE_UP"
bag_metadata_mapping_file = r"C:\ArcGIS Bathymetry\Product Files\version\BAGSupport\bag_metadata_mapping.txt"
update_overviews = "UPDATE_OVERVIEWS"

# Run the tool
updated_bis = arcpy.bathymetry.AddDataToBIS(target_workspace, input_data, input_types, include_subfolders, footprint_type, vertical_units, directionality, bag_metadata_mapping_file, update_overviews)
arcpy.CheckInExtension("Bathymetry")

Lizenzinformationen

  • Basic: Nein
  • Standard: Erfordert ArcGIS Bathymetry
  • Advanced: Erfordert ArcGIS Bathymetry

Verwandte Themen