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
€20.98 €29.99
Paperback
€36.99
Subscription
Free Trial
Renews at €18.99p/m

What do you get with a Packt Subscription?

Free for first 7 days. $19.99 p/m after that. Cancel any time!
Product feature icon Unlimited ad-free access to the largest independent learning library in tech. Access this title and thousands more!
Product feature icon 50+ new titles added per month, including many first-to-market concepts and exclusive early access to books as they are being written.
Product feature icon Innovative learning tools, including AI book assistants, code context explainers, and text-to-speech.
Product feature icon Thousands of reference materials covering every tech concept you need to stay up to date.
Subscribe now
View plans & pricing
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 : 9781785282898
Category :
Languages :
Tools :

What do you get with a Packt Subscription?

Free for first 7 days. $19.99 p/m after that. Cancel any time!
Product feature icon Unlimited ad-free access to the largest independent learning library in tech. Access this title and thousands more!
Product feature icon 50+ new titles added per month, including many first-to-market concepts and exclusive early access to books as they are being written.
Product feature icon Innovative learning tools, including AI book assistants, code context explainers, and text-to-speech.
Product feature icon Thousands of reference materials covering every tech concept you need to stay up to date.
Subscribe now
View plans & pricing

Product Details

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

Packt Subscriptions

See our plans and pricing
Modal Close icon
€18.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
€189.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
€264.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 119.97
ArcPy and ArcGIS: Geospatial Analysis with Python
€36.99
ArcGIS Blueprints
€45.99
Programming ArcGIS with Python Cookbook, Second Edition
€36.99
Total 119.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

What is included in a Packt subscription? Chevron down icon Chevron up icon

A subscription provides you with full access to view all Packt and licnesed content online, this includes exclusive access to Early Access titles. Depending on the tier chosen you can also earn credits and discounts to use for owning content

How can I cancel my subscription? Chevron down icon Chevron up icon

To cancel your subscription with us simply go to the account page - found in the top right of the page or at https://subscription.packtpub.com/my-account/subscription - From here you will see the ‘cancel subscription’ button in the grey box with your subscription information in.

What are credits? Chevron down icon Chevron up icon

Credits can be earned from reading 40 section of any title within the payment cycle - a month starting from the day of subscription payment. You also earn a Credit every month if you subscribe to our annual or 18 month plans. Credits can be used to buy books DRM free, the same way that you would pay for a book. Your credits can be found in the subscription homepage - subscription.packtpub.com - clicking on ‘the my’ library dropdown and selecting ‘credits’.

What happens if an Early Access Course is cancelled? Chevron down icon Chevron up icon

Projects are rarely cancelled, but sometimes it's unavoidable. If an Early Access course is cancelled or excessively delayed, you can exchange your purchase for another course. For further details, please contact us here.

Where can I send feedback about an Early Access title? Chevron down icon Chevron up icon

If you have any feedback about the product you're reading, or Early Access in general, then please fill out a contact form here and we'll make sure the feedback gets to the right team. 

Can I download the code files for Early Access titles? Chevron down icon Chevron up icon

We try to ensure that all books in Early Access have code available to use, download, and fork on GitHub. This helps us be more agile in the development of the book, and helps keep the often changing code base of new versions and new technologies as up to date as possible. Unfortunately, however, there will be rare cases when it is not possible for us to have downloadable code samples available until publication.

When we publish the book, the code files will also be available to download from the Packt website.

How accurate is the publication date? Chevron down icon Chevron up icon

The publication date is as accurate as we can be at any point in the project. Unfortunately, delays can happen. Often those delays are out of our control, such as changes to the technology code base or delays in the tech release. We do our best to give you an accurate estimate of the publication date at any given time, and as more chapters are delivered, the more accurate the delivery date will become.

How will I know when new chapters are ready? Chevron down icon Chevron up icon

We'll let you know every time there has been an update to a course that you've bought in Early Access. You'll get an email to let you know there has been a new chapter, or a change to a previous chapter. The new chapters are automatically added to your account, so you can also check back there any time you're ready and download or read them online.

I am a Packt subscriber, do I get Early Access? Chevron down icon Chevron up icon

Yes, all Early Access content is fully available through your subscription. You will need to have a paid for or active trial subscription in order to access all titles.

How is Early Access delivered? Chevron down icon Chevron up icon

Early Access is currently only available as a PDF or through our online reader. As we make changes or add new chapters, the files in your Packt account will be updated so you can download them again or view them online immediately.

How do I buy Early Access content? Chevron down icon Chevron up icon

Early Access is a way of us getting our content to you quicker, but the method of buying the Early Access course is still the same. Just find the course you want to buy, go through the check-out steps, and you’ll get a confirmation email from us with information and a link to the relevant Early Access courses.

What is Early Access? Chevron down icon Chevron up icon

Keeping up to date with the latest technology is difficult; new versions, new frameworks, new techniques. This feature gives you a head-start to our content, as it's being created. With Early Access you'll receive each chapter as it's written, and get regular updates throughout the product's development, as well as the final course as soon as it's ready.We created Early Access as a means of giving you the information you need, as soon as it's available. As we go through the process of developing a course, 99% of it can be ready but we can't publish until that last 1% falls in to place. Early Access helps to unlock the potential of our content early, to help you start your learning when you need it most. You not only get access to every chapter as it's delivered, edited, and updated, but you'll also get the finalized, DRM-free product to download in any format you want when it's published. As a member of Packt, you'll also be eligible for our exclusive offers, including a free course every day, and discounts on new and popular titles.