topic Re: Export Map Series Pages in ArcGIS Pro Questions

Export Map Series Pages

mpboyle — Fri, 23 Jun 2017 13:42:47 GMT

I'm considering moving some of my map production projects to ArcGIS Pro, but most of them rely on data driven pages and python scripts to automatically iterate over the pages and export out PDFs.

I have looked through the arcpy.mp module and don't see any method, class, or function for accessing map series properties...maybe I'm missing it...?

Without having the ability to script and export a map series, I'm kind of wondering why this is even a part of ArcGIS Pro...?

Is there going to be future development in ArcGIS Pro that will provide the capability of iterating over map series pages and use the already existing exportToPDF, exportToJPEG, exportToPNG, etc...?

Re: Export Map Series Pages

DanPatterson_Retired — Fri, 23 Jun 2017 20:13:07 GMT

this link

http://pro.arcgis.com/en/pro-app/help/projects/20045-import-data-driven-pages.htm

might appear, but it is in map series http://pro.arcgis.com/en/pro-app/help/layouts/map-series.htm

Re: Export Map Series Pages

mpboyle — Fri, 23 Jun 2017 20:20:09 GMT

I've seen these pages, however I don't see any documentation or sample python docs for how to use python to iterate over a map series and export the pages within a series. That's what I'm looking for, whether or not this is possible with ArcGIS Pro.

Re: Export Map Series Pages

DanPatterson_Retired — Fri, 23 Jun 2017 21:15:25 GMT

You would have to navigate the arcpy tree in Pro they have the map class therein which may be a good starting point

http://pro.arcgis.com/en/pro-app/arcpy/mapping/alphabeticallistofclasses.htm

with the change in terms, I can't provide a direct code equivalent offhand

Re: Export Map Series Pages

mpboyle — Fri, 23 Jun 2017 21:19:57 GMT

Yea...I've looked through the classes. I would think it'd be a method within the layouts, but I don't see anything. Was hoping someone else had already dove into this, and I was missing it somewhere.

Re: Export Map Series Pages

ChristopherKohler1 — Thu, 27 Jul 2017 21:41:17 GMT

Can an ESRI employee please comment.

Correct me if I got this wrong, your expecting ALL users to build "code-work-arounds" for the same problem.

How about this, the ONE source(ESRI) develops the code ITSELF.

Problem solved.

To build code work-around

REDUNDANT MATH:

100 USERS X 60 minutes = 6,000 minutes spent

1 Company x 120 minutes(implementation and patch) = 120 minutes

ESRI is in the business of making geospatial products accessible I thought.

Real-world example:

My city is asking for pdf's of all fire zones located within each firestation.

Simplified workflow:

1. Create map series using map series function

2. Export X number of created maps from map series as pdfs(one UI tool)

3. Share with enterprise(in this case my firehouses, all 12 of them)

Why was this functionality excluded?

Re: Export Map Series Pages

JeffBarrette — Thu, 27 Jul 2017 23:34:12 GMT

We have not developed the MapSeries class for arcpy.mp yet. We have it planned for 2.1 or 2.2 (depending on resources and time). We also plan on providing the ability to author a map series using arcpy.mp rather than being limited to working with an existing setup.

Jeff Barrette (Esri - arcpy.mp team)

Re: Export Map Series Pages

deleted-user-uXtLD1BYscf0 — Tue, 02 Jan 2018 21:55:33 GMT

any update on this? will it be in 2.1?

Re: Export Map Series Pages

JeffBarrette — Tue, 02 Jan 2018 22:31:38 GMT

For 2.1 we added mostly arcpy.mapping (DDP) equivalent capabilities. Map Series authoring/setup still needs to be done in the UI.

Jeff

Re: Export Map Series Pages

deleted-user-uXtLD1BYscf0 — Tue, 02 Jan 2018 23:04:03 GMT

So does this mean in 2.1 you will be use Python to:

- refresh DDP (after changing a definition query on the map series layer with py) and;

- export one specific page (or a range of pages) of the map series

(I'm trying to design a workflow and will roll back my script to use to Arcmap unless Pro will do these - thank you!)

Re: Export Map Series Pages

JeffBarrette — Tue, 02 Jan 2018 23:27:41 GMT

You should be able to do what you need. Here is a list of the 2.1 MapSeries Class methods and properties:

Methods

exportToPDF(out_pdf, {page_range_type}, {page_range_string}, {multiple_files}, {resolution}, {image_quality}, {compress_vector_graphics}, {image_compression}, {embed_fonts}, {layers_attributes}, {georef_info}, {jpeg_compression_quality}, {clip_to_elements}, {show_selection_symbology})
getPageNumberFromName(page_name)
refresh()

Properties
- currentPageNumber—Read/Write; Long
- enabled—Read/Write; Boolean
- indexLayer—Read-only; Layer object
- MapFrame—Read-only; MapFrame object
- pageCount—Read-only; Long
- pageNameField—Read-only; GP Field object
- selectedIndexFeatures—Read-only; Python list of corresponding page numbers

Re: Export Map Series Pages

deleted-user-uXtLD1BYscf0 — Wed, 03 Jan 2018 17:46:24 GMT

Jeff Barnett‌ - is it safe to assume that getPageNumberFromName(page_name) method will allow us to reference the page number based on some wildcard string? i.e. If PageName = "SouthWest", then return page number = 2.
I want to be able to exportToPDF one page.
Any chance you could share a snippet to share more info on this one (sorry not sure how this whole 'soon t be released' stuff goes. I have applied for the beta version of 2.1.
thanks for the replies!

Re: Export Map Series Pages

JeffBarrette — Wed, 03 Jan 2018 18:23:27 GMT

Unfortunately getPageNumberFromName does NOT take a wildcard, it must be a fully qualified name. That would be a good enhancement.

Here are some snippets of code. NOTE - this is from the 2.1 help. Arcpy.mp map series are not supported prior to 2.1

import arcpy, os, sys
relpath = os.path.dirname(sys.argv[0])

p = arcpy.mp.ArcGISProject(relpath + "\\MapSeries\\US_States.aprx")
l = p.listLayouts()[0]
if not l.mapSeries is None:
ms = l.mapSeries
if ms.enabled:
    ms.currentPageNumber = ms.getPageNumberFromName("Rhode Island")
    ms.exportToPDF(relpath + "\\Output\\Ex1_RI.pdf", "CURRENT", resolution=300)
    ms.currentPageNumber = ms.getPageNumberFromName("Washington")
    ms.exportToPDF(relpath + "\\Output\\Ex1_WA.pdf", "CURRENT", resolution=300)

import arcpy, os, sys
relpath = os.path.dirname(sys.argv[0])

p = arcpy.mp.ArcGISProject(relpath + "\\MapSeries\\US_States.aprx")
l = p.listLayouts()[0]
if not l.mapSeries is None:
ms = l.mapSeries
if ms.enabled:
    for pageNum in range(1, ms.pageCount + 1):
      ms.currentPageNumber = pageNum
      print("Exporting page {0} of {1}".format(str(ms.currentPageNumber), str(ms.pageCount)))
      l.exportToPNG(relpath + "\\Output\\Ex2_{0}".format(str(ms.currentPageNumber) + ".png"))

import arcpy, os, sys
relpath = os.path.dirname(sys.argv[0])

p = arcpy.mp.ArcGISProject(relpath + "\\MapSeries\\US_States.aprx")
l = p.listLayouts()[0]

if not l.mapSeries is None:
ms = l.mapSeries
if ms.enabled:
    ms = l.mapSeries
    indexLyr = ms.indexLayer
    arcpy.SelectLayerByAttribute_management(indexLyr, 'NEW_SELECTION', "SUB_REGION = 'New England'")
    ms.exportToPDF(relpath + "\\Output\\Ex3_SelectedFeatures.pdf", 'SELECTED')

Re: Export Map Series Pages

TheodoreF — Wed, 21 Feb 2018 16:27:51 GMT

How can I export each PDF using the page name in the output filename? SO far it seems I can only do it for page number...

Re: Export Map Series Pages

deleted-user-uXtLD1BYscf0 — Wed, 21 Feb 2018 17:03:18 GMT

Good question. I haven't got Pro 2.1 installed yet to test this out yet but it's not clear from the examples above how you would do this?

This is what you used in Desktop: pageName = mxd.dataDrivenPages.pageRow.ZIP_CODE source: technical-article

Re: Export Map Series Pages

JeffBarrette — Wed, 21 Feb 2018 17:37:22 GMT

We had various issues with implementing pageRow in time for the 2.1 release and unfortunately didn't think of this very basic request. For 2.2 we will revisit implementing pageRow but should at least have an alternative solution like "CurrentPageName".

The only way I can think of solving this now is if you actually had a PageNumber field that map series worked from. Then you could use cursors to return the row based on page number and then you could return the page name from the index layer.

Thank you for reporting this!

Jeff

Re: Export Map Series Pages

TheodoreF — Wed, 21 Feb 2018 22:10:50 GMT

Hi Jeff,

I and I'm sure many others, would like the ability to export Map Series using page name. We had it with ArcMap!

Regarding your cursor suggestion, it'd be great if you could post a python example code for this?

Thanks!

Re: Export Map Series Pages

AnnHowland — Tue, 30 Apr 2019 19:31:47 GMT

I'm having a similar issue...

I used the Map Series - ArcPy page (https://pro.arcgis.com/en/pro-app/arcpy/mapping/mapseries-class.htm) to create a script to export all my maps in a map series. I made the following code, using the examples (all the maps to .pdfs). However, I still get an error I can't solve. Here is the script I wrote and the error. Any help would be appreciated. How can it no recognize a page number when it's using the PageCount to go through the map series?

aprx = arcpy.mp.ArcGISProject(r"\\jc-gis\files\GisData\Atlases\Johnson City Atlas\Johnson City Atlas.aprx")
arcpy.env.overwriteOutput = True
outpath = (r"\\jc-gis\files\GisData\PrintShopMaps\PDFs\Atlas_Plain\\")
lytlist = aprx.listLayouts()[0]
if not lytlist.mapSeries is None:
mseries = lytlist.mapSeries
if mseries.enabled:
for pageNum in range(1, mseries.pageCount + 1):
mseries.currentPageNumber = pageNum
print("Exporting page {0}".format(mseries.pageRow.PAGENAME))
mappageName = mseries.pageRow.PAGENAME
lytlist.exporttoPDF(outpath + "JCAtlas" + mappageName + ".pdf", resolution=150, image_quality = "BEST")

Error:

Traceback (most recent call last):
File "Z:\GisData\Atlases\updatePDFMaps_ArcPro.py", line 23, in <module>
mseries.currentPageNumber = pageNum
File "C:\Program Files\ArcGIS\Pro\Resources\ArcPy\arcpy\arcobjects\_base.py", line 109, in _set
return setattr(self._arc_object, attr_name, cval(val))
ValueError: Invalid page number '1'.

Re: Export Map Series Pages

JeffBarrette — Wed, 01 May 2019 13:29:06 GMT

Hello Ann,

The reason you might be getting the error is because you may be using a field in your index feature class to drive page numbers. Confirm this by looking at your map series optional settings. There is an optional field called PageNumber. If you are using a field driven page number and page number "1" does NOT exist in that field, you will get the error. I just tried it and could easily reproduce your error message.

The script you current have works fine if a PageNumber field is not defined.

Rather than trying to iterate through the page numbers and export one page at a time, why not simply export the map series using the separate pages option using page name.

You could replace your code with:

if mseries.enabled:
mseris.exportToPDF(outpath + "JCAtlas", multiple_files='PDF_MULTIPLE_FILES_PAGE_NAME', resolution=150, image_quality = "BEST")

Jeff

Re: Export Map Series Pages

AnnHowland — Wed, 01 May 2019 13:43:17 GMT

Thanks for the tip. I also tried using a search cursor to go through each map page number and received the same error.

You are correct in assuming that I have fields called PAGENAME and PAGENUMBER. My first PAGENUMBER is 4, 5, 6, 11, …etc.. and is not sequential.

Thanks!

howlanda@johnsoncitytn.org

601 E Main St

Johnson City, TN 37601

Check out our online maps and information:

Map Gallery<http://www.johnsoncitytn.org/services/maps_and_data/map_gallery.php>

Ann Howland, GISP

Geospatial Analyst, IT Department

City of Johnson City, Tennessee

423.434.6188 / www.johnsoncitytn.org<http://www.johnsoncitytn.org/>