ArcMap

Building Offsets

Summary

ArcGIS Defense Mapping cartographic production tool that aligns, moves, or hides building marker symbols based on a specification defined in an .xml file.

The .xml file contains settings for the following Defense Mapping cartographic products:

  • MTM50
  • MTM100
  • TM50
  • TM100

Usage

  • The Defense Mapping installation directory contains .xml product files you can use for cartographic production, and can be found in the <Installation location>\ArcGIS\EsriDefenseMapping\Desktop10.x\<product>\Cartography\Symbology directory.

  • Data referenced in the Product File must have representations for buildings and the linear features used for symbol alignment and conflict resolution.

  • Distances and units used in symbol alignment and conflict resolution are defined in the Product File.

  • Features are displayed based on the visibility field and definition query defined in the map template.

Syntax

arcpy.defense.BuildingOffsets(Product_File, Dataset, Coordinate_System)
ParameterExplanationData Type
Product_File

The .xml file that contains settings specific to Defense Mapping cartographic products.

File
Dataset
[Dataset,...]

Workspaces or feature datasets that contain the buildings and linear features referenced in the .xml Product File.

Workspace; Feature Dataset
Coordinate_System

Sets the geoprocessing Cartographic Coordinate System environment setting. This setting determines the size, extent, and spatial relationships of features when making cartographic–related calculations.

Coordinate System

Code sample

BuildingOffsets example 1 (stand-alone script)

The following code example demonstrates how to execute the BuildingOffsets tool. 

# Name: BuildingOffsets_Example.py
# Description: Executes Building Offsets Defense Mapping tool using an input XML specification file.
# Requirements: ArcGIS Defense Mapping 

import arcpy

# check out a defense license & set gp environment
arcpy.CheckOutExtension("defense")
arcpy.env.workspace="c:/data/mgcp.gdb"

# variables for tool parameters
productFile="c:/data/defense_carto_spec.xml"
dataset="MGCP"
coordsys="PROJCS['GCS WGS 1984 UTM Zone 11N (Calculated)',GEOGCS['GCS_WGS_1984',DATUM['D_WGS_1984',SPHEROID['WGS_1984',6378137.0,298.257223563]],PRIMEM['Greenwich',0.0],UNIT['Degree',0.0174532925199433]],PROJECTION['Transverse_Mercator'],PARAMETER['False_Easting',500000.0],PARAMETER['False_Northing',0.0],PARAMETER['Central_Meridian',-117.0],PARAMETER['Scale_Factor',0.9996],PARAMETER['Latitude_Of_Origin',0.0],UNIT['Meter',1.0]];IsHighPrecision"

# execute the tool
arcpy.BuildingOffsets_defense(productFile,dataset,coordsys)

# check in the defense license
arcpy.CheckInExtension("defense")
BuildingOffsets example 2 (stand-alone script)

The following code example demonstrates how to execute the BuildingOffsets tool. 

# Running Building Offsets using a coordinate system object from a dataset
# Importing arcpy module
import arcpy

# Checking out Defnese Extension
arcpy.CheckOutExtension('defense')

# Setting variables for input parameters
product_file = r'C:\DefenseProductFiles\Tds\Cartography\Symbology\TM50_TDS_6_1_BuildingOffsets.xml'
input_dataset = r'C:\Data\TDS_6_1.gdb\TDS'

# Getting coordinate system from dataset
descobj = arcpy.Describe(input_dataset)
coordinate_sytem = descobj.spatialReference

# Calling Building Offests tool
arcpy.defense.BuildingOffsets(product_file, input_dataset, coordinate_sytem)

# Checking in Defense extension
arcpy.CheckInExtension('defense')

Environments

Licensing information

  • Basic: No
  • Standard: No
  • Advanced: Requires Defense Mapping

Related topics