Search icon CANCEL
Subscription
0
Cart icon
Your Cart (0 item)
Close icon
You have no products in your basket yet
Arrow left icon
Explore Products
Best Sellers
New Releases
Books
Videos
Audiobooks
Learning Hub
Conferences
Free Learning
Arrow right icon
Programming ArcGIS with Python Cookbook, Second Edition
Programming ArcGIS with Python Cookbook, Second Edition

Programming ArcGIS with Python Cookbook, Second Edition: Over 85 hands-on recipes to teach you how to automate your ArcGIS for Desktop geoprocessing tasks using Python

eBook
$27.98 $39.99
Paperback
$48.99
Subscription
Free Trial
Renews at $19.99p/m

What do you get with eBook?

Product feature icon Instant access to your Digital eBook purchase
Product feature icon Download this book in EPUB and PDF formats
Product feature icon Access this title in our online reader with advanced features
Product feature icon DRM FREE - Read whenever, wherever and however you want
OR
Modal Close icon
Payment Processing...
tick Completed

Billing Address

Table of content icon View table of contents Preview book icon Preview Book

Programming ArcGIS with Python Cookbook, Second Edition

Chapter 2. Managing Map Documents and Layers

In this chapter, we will cover the following recipes:

  • Referencing the current map document
  • Referencing map documents on a disk
  • Getting a list of layers in a map document
  • Restricting the list of layers
  • Zooming in to selected features
  • Changing the map extent
  • Adding layers to a map document
  • Inserting layers into a map document
  • Updating layer symbology
  • Updating layer properties
  • Working with time-enabled layers in a data frame

Introduction

The ArcPy mapping module provides some really exciting features for mapping automation, including the ability to manage map documents and layer files, as well as the data within these files. Support is provided to automate map export and print, to create PDF map books, and publish map documents to ArcGIS Server map services. This is an incredibly useful module for accomplishing many of the day-to-day tasks performed by GIS analysts.

In this chapter, you will learn how to use the ArcPy mapping module to manage map documents and layer files. You will also learn how to add and remove geographic layers and tables from map document files, insert layers into data frames, and move layers around within the map document. Finally, you will learn how to update layer properties and symbology.

Referencing the current map document

When running a geoprocessing script from the ArcGIS Python window or a custom script tool, you will often need to make a reference to the map document which is currently loaded in ArcMap. This is typically the first step in your script before you perform geoprocessing operations against layers and tables in a map document. In this recipe, you will learn how to reference the current map document from your Python geoprocessing script.

Getting ready

Before you can actually perform any operations on a map document file, you need to make a reference to it in your Python script. This is done by calling the MapDocument() method on the arcpy.mapping module. You can reference either the currently running document or a document at a specific location on disk. To reference the currently active document, you simply supply the keyword CURRENT as a parameter to the MapDocument() function. This loads the currently active document in ArcMap. The following code example...

Referencing map documents on a disk

In addition to being able to reference the currently active map document file in ArcMap, you can also access map document files that are stored on a local or remote drive by using the MapDocument() constructor. In this recipe, you'll learn how to access these map documents.

Getting ready

As I mentioned earlier, you can also reference a map document file that resides somewhere on your computer or a shared server. This is done simply by providing a path to the file. This is a more versatile way of obtaining a reference to a map document because it can be run outside the ArcGIS Python window. Later, when we will discuss parameters in a script, you'll understand that you can make this path a parameter so that the script is even more versatile, with the ability to input a new path each time it is needed.

How to do it…

Follow these steps to learn how to access a map document stored on a local or remote drive:

  1. Open the IDLE development environment...

Getting a list of layers in a map document

Frequently, one of the first steps in a geoprocessing script is to obtain a list of layers in the map document. Once obtained, your script may then cycle through each of the layers and perform some type of processing. The mapping module contains a ListLayers() function, which provides the capability of obtaining this list of layers. In this recipe, you will learn how to get a list of layers contained within a map document.

Getting ready

The arcpy.mapping module contains various list functions to return lists of layers, data frames, broken data sources, table views, and layout elements. These list functions normally function as the first step in a multistep process, in which the script needs to get one or more items from a list for further processing. Each of these list functions returns a Python list, which, as you know from earlier in the book, is a highly functional data structure for storing information.

Normally, the list functions are used as...

Restricting the list of layers

In the previous recipe, you learned how to get a list of layers by using the ListLayers() function. There will be times when you will not want a list of all the layers in a map document, but rather only a subset of the layers. The ListLayers() function allows you to restrict the list of layers that is generated. In this recipe, you will learn how to restrict the layers returned using a wildcard and a specific data frame from the ArcMap table of contents.

Getting ready

By default, if you only pass a reference to the map document or layer file, the ListLayers() function will return a list of all the layers in these files. However, you can restrict the list of layers returned by this function by using an optional wildcard parameter or by passing in a reference to a specific data frame. A wildcard is a character that will match any character or sequence of characters in a search. This will be demonstrated in this recipe.

Note

If you're working with a layer file...

Zooming in to selected features

Creating selection sets in ArcMap is a common task. Selection sets are often created as the result of an attribute or spatial query, but they can also occur when a user manually selects features and sometimes, under some additional circumstances. To better visualize selection sets, users often zoom to the extent of the selected feature. This can be accomplished programmatically with Python in several ways. In this recipe, you will learn how to zoom to all the selected features in a data frame as well as an individual layer.

Getting ready

The DataFrame.zoomToSelectedFeatures property zooms to the extent of all the selected features from all the layers in the data frame. Essentially, it performs the same operation as the Selection | Zoom to Selected Features operation. One difference is that it will zoom to the full extent of all the layers if no features are selected.

Zooming to the extent of selected features in an individual layer requires you to use the Layer...

Introduction


The ArcPy mapping module provides some really exciting features for mapping automation, including the ability to manage map documents and layer files, as well as the data within these files. Support is provided to automate map export and print, to create PDF map books, and publish map documents to ArcGIS Server map services. This is an incredibly useful module for accomplishing many of the day-to-day tasks performed by GIS analysts.

In this chapter, you will learn how to use the ArcPy mapping module to manage map documents and layer files. You will also learn how to add and remove geographic layers and tables from map document files, insert layers into data frames, and move layers around within the map document. Finally, you will learn how to update layer properties and symbology.

Referencing the current map document


When running a geoprocessing script from the ArcGIS Python window or a custom script tool, you will often need to make a reference to the map document which is currently loaded in ArcMap. This is typically the first step in your script before you perform geoprocessing operations against layers and tables in a map document. In this recipe, you will learn how to reference the current map document from your Python geoprocessing script.

Getting ready

Before you can actually perform any operations on a map document file, you need to make a reference to it in your Python script. This is done by calling the MapDocument() method on the arcpy.mapping module. You can reference either the currently running document or a document at a specific location on disk. To reference the currently active document, you simply supply the keyword CURRENT as a parameter to the MapDocument() function. This loads the currently active document in ArcMap. The following code example...

Referencing map documents on a disk


In addition to being able to reference the currently active map document file in ArcMap, you can also access map document files that are stored on a local or remote drive by using the MapDocument() constructor. In this recipe, you'll learn how to access these map documents.

Getting ready

As I mentioned earlier, you can also reference a map document file that resides somewhere on your computer or a shared server. This is done simply by providing a path to the file. This is a more versatile way of obtaining a reference to a map document because it can be run outside the ArcGIS Python window. Later, when we will discuss parameters in a script, you'll understand that you can make this path a parameter so that the script is even more versatile, with the ability to input a new path each time it is needed.

How to do it…

Follow these steps to learn how to access a map document stored on a local or remote drive:

  1. Open the IDLE development environment from Start | All...

Getting a list of layers in a map document


Frequently, one of the first steps in a geoprocessing script is to obtain a list of layers in the map document. Once obtained, your script may then cycle through each of the layers and perform some type of processing. The mapping module contains a ListLayers() function, which provides the capability of obtaining this list of layers. In this recipe, you will learn how to get a list of layers contained within a map document.

Getting ready

The arcpy.mapping module contains various list functions to return lists of layers, data frames, broken data sources, table views, and layout elements. These list functions normally function as the first step in a multistep process, in which the script needs to get one or more items from a list for further processing. Each of these list functions returns a Python list, which, as you know from earlier in the book, is a highly functional data structure for storing information.

Normally, the list functions are used as...

Restricting the list of layers


In the previous recipe, you learned how to get a list of layers by using the ListLayers() function. There will be times when you will not want a list of all the layers in a map document, but rather only a subset of the layers. The ListLayers() function allows you to restrict the list of layers that is generated. In this recipe, you will learn how to restrict the layers returned using a wildcard and a specific data frame from the ArcMap table of contents.

Getting ready

By default, if you only pass a reference to the map document or layer file, the ListLayers() function will return a list of all the layers in these files. However, you can restrict the list of layers returned by this function by using an optional wildcard parameter or by passing in a reference to a specific data frame. A wildcard is a character that will match any character or sequence of characters in a search. This will be demonstrated in this recipe.

Note

If you're working with a layer file (.lyr...

Zooming in to selected features


Creating selection sets in ArcMap is a common task. Selection sets are often created as the result of an attribute or spatial query, but they can also occur when a user manually selects features and sometimes, under some additional circumstances. To better visualize selection sets, users often zoom to the extent of the selected feature. This can be accomplished programmatically with Python in several ways. In this recipe, you will learn how to zoom to all the selected features in a data frame as well as an individual layer.

Getting ready

The DataFrame.zoomToSelectedFeatures property zooms to the extent of all the selected features from all the layers in the data frame. Essentially, it performs the same operation as the Selection | Zoom to Selected Features operation. One difference is that it will zoom to the full extent of all the layers if no features are selected.

Zooming to the extent of selected features in an individual layer requires you to use the Layer...

Left arrow icon Right arrow icon

Description

The book kicks off with the fundamentals of starting to use Python with ArcGIS, followed by recipes on managing map documents and layers, including how to find and fix broken data links in these files. In the second part of the book, you will learn to create custom geoprocessing tools and how to use the Attribute and Location tools to select specific features. The third part of the book covers topics for advanced users including the REST API, and also teaches you how to use Python with ArcGIS Pro. The book finishes with appendices covering how to automate Python scripts, and the five things that should be at the back of every GIS programmer's mind.

What you will learn

  • Manage your map document files, layer files, feature classes, and tables
  • Programmatically update layer properties and symbology
  • Find and fix broken data links in your map document files
  • Automate map production, printing, and the creation of PDF map books
  • Develop custom geoprocessing tools that can be shared with others
  • Query and select data from feature classes and tables
  • Create new feature classes or tables and add, update, and delete records
  • Customize the ArcGIS Desktop interface with Python addins

Product Details

Country selected
Publication date, Length, Edition, Language, ISBN-13
Publication date : Jul 28, 2015
Length: 366 pages
Edition : 1st
Language : English
ISBN-13 : 9781785281259
Category :
Languages :
Tools :

What do you get with eBook?

Product feature icon Instant access to your Digital eBook purchase
Product feature icon Download this book in EPUB and PDF formats
Product feature icon Access this title in our online reader with advanced features
Product feature icon DRM FREE - Read whenever, wherever and however you want
OR
Modal Close icon
Payment Processing...
tick Completed

Billing Address

Product Details

Publication date : Jul 28, 2015
Length: 366 pages
Edition : 1st
Language : English
ISBN-13 : 9781785281259
Category :
Languages :
Tools :

Packt Subscriptions

See our plans and pricing
Modal Close icon
$19.99 billed monthly
Feature tick icon Unlimited access to Packt's library of 7,000+ practical books and videos
Feature tick icon Constantly refreshed with 50+ new titles a month
Feature tick icon Exclusive Early access to books as they're written
Feature tick icon Solve problems while you work with advanced search and reference features
Feature tick icon Offline reading on the mobile app
Feature tick icon Simple pricing, no contract
$199.99 billed annually
Feature tick icon Unlimited access to Packt's library of 7,000+ practical books and videos
Feature tick icon Constantly refreshed with 50+ new titles a month
Feature tick icon Exclusive Early access to books as they're written
Feature tick icon Solve problems while you work with advanced search and reference features
Feature tick icon Offline reading on the mobile app
Feature tick icon Choose a DRM-free eBook or Video every month to keep
Feature tick icon PLUS own as many other DRM-free eBooks or Videos as you like for just $5 each
Feature tick icon Exclusive print discounts
$279.99 billed in 18 months
Feature tick icon Unlimited access to Packt's library of 7,000+ practical books and videos
Feature tick icon Constantly refreshed with 50+ new titles a month
Feature tick icon Exclusive Early access to books as they're written
Feature tick icon Solve problems while you work with advanced search and reference features
Feature tick icon Offline reading on the mobile app
Feature tick icon Choose a DRM-free eBook or Video every month to keep
Feature tick icon PLUS own as many other DRM-free eBooks or Videos as you like for just $5 each
Feature tick icon Exclusive print discounts

Frequently bought together


Stars icon
Total $ 158.97
ArcPy and ArcGIS: Geospatial Analysis with Python
$48.99
ArcGIS Blueprints
$60.99
Programming ArcGIS with Python Cookbook, Second Edition
$48.99
Total $ 158.97 Stars icon

Table of Contents

16 Chapters
1. Fundamentals of the Python Language for ArcGIS Chevron down icon Chevron up icon
2. Managing Map Documents and Layers Chevron down icon Chevron up icon
3. Finding and Fixing Broken Data Links Chevron down icon Chevron up icon
4. Automating Map Production and Printing Chevron down icon Chevron up icon
5. Executing Geoprocessing Tools from Scripts Chevron down icon Chevron up icon
6. Creating Custom Geoprocessing Tools Chevron down icon Chevron up icon
7. Querying and Selecting Data Chevron down icon Chevron up icon
8. Using the ArcPy Data Access Module with Feature Classes and Tables Chevron down icon Chevron up icon
9. Listing and Describing GIS Data Chevron down icon Chevron up icon
10. Customizing the ArcGIS Interface with Add-ins Chevron down icon Chevron up icon
11. Error Handling and Troubleshooting Chevron down icon Chevron up icon
12. Using Python for Advanced ArcGIS Chevron down icon Chevron up icon
13. Using Python with ArcGIS Pro Chevron down icon Chevron up icon
A. Automating Python Scripts Chevron down icon Chevron up icon
B. Five Python Recipes Every GIS Programmer Should Know Chevron down icon Chevron up icon
Index Chevron down icon Chevron up icon

Customer reviews

Top Reviews
Rating distribution
Full star icon Full star icon Full star icon Half star icon Empty star icon 3.6
(8 Ratings)
5 star 37.5%
4 star 25%
3 star 12.5%
2 star 12.5%
1 star 12.5%
Filter icon Filter
Top Reviews

Filter reviews by




Diana Sep 17, 2018
Full star icon Full star icon Full star icon Full star icon Full star icon 5
Excellent programming book! Very explicit with good examples to practice on ! Definitely recommend it !
Amazon Verified review Amazon
GeoPotato Nov 09, 2016
Full star icon Full star icon Full star icon Full star icon Full star icon 5
So much useful information! Hopefully they'll come out with a newer version that addresses Python 3.x with ArcGIS Pro, however.
Amazon Verified review Amazon
Happybea Oct 20, 2015
Full star icon Full star icon Full star icon Full star icon Full star icon 5
I took a Python scripting class a few years ago but haven't used it in quite a while. I needed a refresher on Python scripting for an ArcGIS upcoming project and this book was perfect. The fundamentals were nicely reviewed and the rest of the book is full of easy to reference practical examples. I especially like the "How it works..." sections that explain the finer points of the code. This book may be a little challenging for those unfamiliar with object-oriented programming, but I highly recommend it for anyone who has some Python experience.
Amazon Verified review Amazon
DANIEL GIL Sep 16, 2015
Full star icon Full star icon Full star icon Full star icon Empty star icon 4
It's a perfect book to start learning arcpy. The exercises are interesting but not too complicated so you don't feel frustated and every step is explained so you can't get lost.After doing an arcpy online course (beginner level) I purchased the book Arcpy and ArcGis- Geospatial Analysis With Python but I think it's not the best option for beginners. I recommend Programing ArcGIS with Python Cookbook for beginners.
Amazon Verified review Amazon
Nobuko Conroy Sep 12, 2015
Full star icon Full star icon Full star icon Full star icon Empty star icon 4
I haven't gone through all the exercises yet, but so far I liked this book very much. There are many useful examples which you could readily apply to your daily jobs (if you are GIS user), such as exporting a map to pdf or image file, automating printing process, and creating geoprocessing tools, etc. Many of the examples are not too long to follow, and very user friendly (the book comes with all the necessary electronic files, including codes). Considering the fact that the first edition came out only in February 2013, this second edition came out rather fast; I guess there's much update since then and also many requests for the updated version (so, authors,thank you for your quick action!). One drawback was that I'm using ArcGIS ver. 10.1 (the book is written for ver.10.3) and some scripts did not work (e.g. Chapter 6, reading from a text file and plotting wildfire points). For those parts, ideally, the authors could have clarified which script would or would not work in which version of ArcGIS. Overall, I would recommend this cookbook to those who have taken intro Python class for ArcGIS, and want to explore further.
Amazon Verified review Amazon
Get free access to Packt library with over 7500+ books and video courses for 7 days!
Start Free Trial

FAQs

How do I buy and download an eBook? Chevron down icon Chevron up icon

Where there is an eBook version of a title available, you can buy it from the book details for that title. Add either the standalone eBook or the eBook and print book bundle to your shopping cart. Your eBook will show in your cart as a product on its own. After completing checkout and payment in the normal way, you will receive your receipt on the screen containing a link to a personalised PDF download file. This link will remain active for 30 days. You can download backup copies of the file by logging in to your account at any time.

If you already have Adobe reader installed, then clicking on the link will download and open the PDF file directly. If you don't, then save the PDF file on your machine and download the Reader to view it.

Please Note: Packt eBooks are non-returnable and non-refundable.

Packt eBook and Licensing When you buy an eBook from Packt Publishing, completing your purchase means you accept the terms of our licence agreement. Please read the full text of the agreement. In it we have tried to balance the need for the ebook to be usable for you the reader with our needs to protect the rights of us as Publishers and of our authors. In summary, the agreement says:

  • You may make copies of your eBook for your own use onto any machine
  • You may not pass copies of the eBook on to anyone else
How can I make a purchase on your website? Chevron down icon Chevron up icon

If you want to purchase a video course, eBook or Bundle (Print+eBook) please follow below steps:

  1. Register on our website using your email address and the password.
  2. Search for the title by name or ISBN using the search option.
  3. Select the title you want to purchase.
  4. Choose the format you wish to purchase the title in; if you order the Print Book, you get a free eBook copy of the same title. 
  5. Proceed with the checkout process (payment to be made using Credit Card, Debit Cart, or PayPal)
Where can I access support around an eBook? Chevron down icon Chevron up icon
  • If you experience a problem with using or installing Adobe Reader, the contact Adobe directly.
  • To view the errata for the book, see www.packtpub.com/support and view the pages for the title you have.
  • To view your account details or to download a new copy of the book go to www.packtpub.com/account
  • To contact us directly if a problem is not resolved, use www.packtpub.com/contact-us
What eBook formats do Packt support? Chevron down icon Chevron up icon

Our eBooks are currently available in a variety of formats such as PDF and ePubs. In the future, this may well change with trends and development in technology, but please note that our PDFs are not Adobe eBook Reader format, which has greater restrictions on security.

You will need to use Adobe Reader v9 or later in order to read Packt's PDF eBooks.

What are the benefits of eBooks? Chevron down icon Chevron up icon
  • You can get the information you need immediately
  • You can easily take them with you on a laptop
  • You can download them an unlimited number of times
  • You can print them out
  • They are copy-paste enabled
  • They are searchable
  • There is no password protection
  • They are lower price than print
  • They save resources and space
What is an eBook? Chevron down icon Chevron up icon

Packt eBooks are a complete electronic version of the print edition, available in PDF and ePub formats. Every piece of content down to the page numbering is the same. Because we save the costs of printing and shipping the book to you, we are able to offer eBooks at a lower cost than print editions.

When you have purchased an eBook, simply login to your account and click on the link in Your Download Area. We recommend you saving the file to your hard drive before opening it.

For optimal viewing of our eBooks, we recommend you download and install the free Adobe Reader version 9.