What's new in version 1.8.3

New

• Adds ujson library as a dependency for JSON parsing to improve performance

New Guides

• Working with geometries
  • Part 1 - Introduction - what is geometry?
  • Part 2 - Working with Geometries
  • Part 3 - Spatial operations on geometries
  • Part 4 - Applying spatial filters
• Enriching GIS data with Thematic Information
  • Part 1 - Introduction to GeoEnrichment
  • Part 2 - Where to enrich?(what are study areas?)
  • Part 3 - Where to enrich?(what are Named Statistical Areas?)
  • Part 4 - What to enrich with? (What are Data Collections and Analysis Variables?)
  • Part 5 - Generating Reports
  • Part 6 - Standard Geography Queries
• Data Engineering Guides
  • Part 1 - Introduction to Data Engineering
  • Part 2 - Introduction to NumPy
  • Part 3 - Introduction to Pandas
  • Part 4 - Productivity with Pandas
  • Part 5 - Working with Time Series Data
• Install and set up
• Reconfigures Guide into:
  • Install and set up
  • Install older versions
• Deep Learning with ArcGIS
  • Geo-Referencing and Digitization of Scanned Maps
  • How SuperResolution Works
  • [Text Classification workflow with arcgis.learn](https://developers.arcgis.com/python/guide/text-classification)
  • How Multi-Task Road Extractor works
  • How Pix2Pix works
  • How CycleGAN Works

New Samples

• Org Administrators
• Clone StoryMap Version 2
• GIS Analysts and Data Scientists
• Prediction of energy generation from Solar Photovoltaic Power Plants using weather variables
• Detection of electric utility features and vegetation encroachments from satellite images using deep learning
• River Turbidity Estimation using Sentinel-2 data
• Mapping Infrastructural Damage due to Beirut Blast
• Coastline extraction using Landsat-8 multispectral imagery and band ratio technique
• Identifying country names from incomplete house addresses
• SAR to RGB image translation using CycleGAN
• Creating building models using point cloud classification
• Automatic road extraction using deep learning

arcgis.gis

• Adds Workflow Manager submodule
• Adds support for API Key authentication to GIS() object with api_key keyword
• Adds trust_env keyword to GIS()
• Adds python-certifi-win32 to API dependencies so certificates from the Windows certificate store are used by GIS
• UserManager
• Adds code example for role parameter on create() documentation
• ContentManager
• Adds support for Workforce Version 2 Projects to clone_items()
• Adds generate() method to create features from CSV, shapefile, GPX, and GeoJSON files
• Group
• Adds search() method for searching group content
• add_users()
  • Adds admins parameter
  • Adds default value to usernames parameter
• Adds delete_group_thumbnail() method
• ResourceManager
• Adds export() method
• Adds access parameter to add() method
• Updates remove() file parameter so if not specifed all dependencies are removed
• DataStoreManager
• Adds check to ensure validate() returns Boolean result
• DataStore
• Adds check to ensure regenerate() returns Boolean result
• Adds logic for application login with client_id and client_secret

arcgis.gis.admin

• Adds generate_report() method to AGOLUsageReports for organizational usage monitoring

arcgis.gis.server

• Adds properties to ServerManager
• allows publisher role the ability to obtain server ID information needed for datastore registration (Enterprise 10.9)
• Adds Extension documentation to APi Reference
• ReportManager
• Adds code example to create()
• Adds code example to quick_report()

arcgis.env

• Adds environment variables:
• union_dimension
• match_variables

arcgis.features

• FeatureLayer
• Adds note to edit_features() to use only for small batches of edits
• Adds query_analytics() method for ArcGIS Online Hosted Layers only (ArcGIS Enterprise support forthcoming)
• Spatially Enabled DataFrame
• Adds from_feather() method for feather format files
• FeatureLayerCollection
• Adds code example to extract_changes() API Reference
• Adds return_edits parameter to ValidationManager.update_error()

arcgis.features.analysis

• analyze_patterns
• find_point_clusters()
  • Adds documentation
• summarize_data
• summarize_within()
  • Adds parameters:
  • bin_type
  • bin_size
  • bin_size_unit
• manage_data
• run_python_script() for Enterprise 10.9
  • Adds parameters:
  • param_as_input

arcgis.features.managers

• Version
• differences() method
  • adds moments parameter
  • adds parameter table
• Adds restore() method
• AttachmentManager
• ParcelFabricManager
• Adds methods:
  • analyze_least_squares_adjustment()
  • apply_least_squares_adjustment()

arcgis.raster

• Raster
• Adds new properties:
  • RAT
• Adds new methods:
  • get_colormap()
  • set_colormap()
  • get_statistics()
  • set_statistics()
  • get_histograms()
  • set_histograms()
  • append_slices()
  • set_variable_attributes()
  • summarize()
• ImageryLayer
• Adds tiles_only property
• Adds render_tilesonly_layer method
• Raises errors for properties and methods not supported by TilesOnly layers
• colormap()
  • Adds parameters:
    • rendering_rule
    • variable
• Adds get_histograms() method
• Adds statistics() method
• Adds RasterInfo Class

arcgis.raster.analytics

• Enhances API to utilize the hosted imagery and raster analysis capabilities available with the June 2020 ArcGIS Online
• Adds tiles_only keyword argument to functions
• build_multidimensional_transpose()
• Adds new parameter:
• delete_transpose (Parameter available in ArcGIS Image Server 10.9 or higher)
• summarize_raster_within()
• Adds new parameter:
• percentile_interpolation_type(Parameter available in ArcGIS Image Server 10.9 or higher)
• Enhanced the following functions to accept local datasets to create hosted imagery layers
• create_image_collection()
• copy_raster()
• Adds merge_multidimensional_rasters() function (requires ArcGIS Image Server 10.9 or higher)
• calculate_density()
• Adds input_barriers parameter (requires in ArcGIS Image Server 10.9 and higher)
• optimal_path_as_line()
• Adds create_network_paths parameter (requires in ArcGIS Image Server 10.9 and higher)

arcgis.raster.functions

• Adds new functions:
• detect_change_using_change_analysis_raster
• trend_to_rgb
• apparent_reflectance
• buffered
• rasterize_features
• reproject
• heat_index
• wind_chill
• aspect_slope
• contour
• compute_change
• aggregate
• bai
• nbr
• ndbi
• ndmi
• ndsi
• mndwi
• band_arithmetic()
• Adds new options for method:
  • BAI
  • NBR
  • NDBI
  • NDMI
  • NDSI
  • MNDWI
• generate_trend()
• Adds options for regression_type parameter:
  • MANN-KENDALL
  • SEASONAL-KENDALL
• Adds new parameter:
  • seasonal_period
• focal_statistics()
• Adds new options for stat_type:
  • Median
  • Majority
  • Minority
• composite_band()
• Adds cellsize_type parameter
• geometric()
• Adds new parameters:
  • tolerance
  • dem

arcgis.raster.functions.gbl

• Adds new functions:
• boundary_clean() (Parameter available in ArcGIS Image Server 10.9 or higher)
• zonal_statistics()
• Adds new parameter:
• percentile_interpolation_type (Parameter available in ArcGIS Image Server 10.9 or higher)
• kernel_density()
• Adds in_barriers parameter (Parameter available in ArcGIS Image Server 10.9 and higher)

argis.raster.functions.RFT

• Enhanced module to work with ArcGIS Online

arcgis.geoanalytics

• summarize_data submodule
  • Adds time stepping parameters to summarize_attributes() for 10.9+ releases
    • time_step_interval
    • time_step_interval_unit
    • time_step_repeat_interval
    • time_step_repeat_interval_unit
    • time_step_reference

arcgis.geometry.functions

• Adds missing api reference documentation

arcgis.mapping

• Adds new classes
• MapServiceLayer
• MapFeatureLayer
• MapRasterLayer
• MapTable
• Adds support for polygons to the extent parameter of OfflineMapAreaManager.create()
• WebMap
• Adds get_layer() method
• Adds get_table() method
• Adds support for setting a basemap to the following layer types: (See WebMap Specification operationalLayers):
  • ImageServiceVectorLayer
  • VectorTileLayer
  • WebTiledLayer
  • WMSLayer
• Adds ability to allow user-defined extent in save()

arcgis.mapping.ogc

• GeoJSONLayer
• Adds data parameter to allow plotting from a string or local file

arcgis.widgets

• Updates MapView to use JavaScript 4.17
• Adds note to MapView documentation clarifying proper configuration to avoid various CORS errors
• Addresses many browser connection errors with the gis.map() functionality
• Example: BUG-000124898 - IWA authenticated portals returning authentication error
• Changes default basemap for anonymous access to the OSM Basemap
• Adds embed() function to enable a live, interactive map widget in exported HTML notebooks
• Adds map widget support to JupyterLab 2.x releases
• Adds map widget to extensions that can be installed with JupyterLab Extension Manager
• Adds support for visualizing SceneLayer types
• PointCloudLayer
• Point3DLayer
• Object3DLayer
• IntegratedMeshLayer
• BuildingLayer

arcgis.apps

• Adds new Dashboard submodule
• Adds new url builders:
• build_workforce_url
• bulld_field_maps_url
• Adds updateFeature support as option for actions parameter in build_collector_url
• Workforce
• Adds logic to enforce integrations with the same id both have assignment types
• Adds logic enforcing layer and table order of feature service when created
• Adds validation logic to the Assignment class for priority parameter

arcgis.learn

• New Table of Contents structure: (new classes and functions at 1.8.3 listed here)
• Data Preparation Methods
  • prepare_textdata()
• Object Classification Methods
• Object Detection Models
• Pixel Classification Models
  • HEDEdgeDetector
  • BDCNEdgeDetector
  • MultiTaskRoadExtractor
  • ChangeDetector
• Image Translation Models
  • ImageCaptioner
  • Pix2Pix
  • CycleGAN
• 3D Models
• Scanned Maps
  • ScannedMapDigitizer
• Tabular and Feature Data Models
  • TimeSeriesModel
• Unstructured Text Models
  • arcgis.learn.text submodule
    • TextClassifier
    • SequenceToSequence
    • Inference Only Models submodule
      • FillMask
      • QuestionAnswering
      • TextGenerator
      • TextSummarizer
      • TextTranslator
      • ZeroShotClassifier
• Inferencing Methods (Image Server)
  • compute_accuracy_for_object_detection() (Requires ArcGIS Image Server 10.9 or higher)
• Model Management
  • ModelExtension
• Adds support for .dlpk format to the from_model() function in all models
• Adds message to install gdal if using multispectral data with prepare_data()
• Adds support for Meta Raster Format (MRF) tiles
• Adds driver-related Pytorch along with torch.cuda.is_available() when deciding between using GPU and CPU
• Adds documentation to the resize_to parameter for prepare_data()
• Adds torch.cuda.get_device_capability() check
• Adds dice coefficient and soft dice loss for multiclass UNetClassifier, PSPNetClassifier, and Deeplab models
• Adds save_inference_file parameter to save() method of models
• Adds ability to show intermediate results on Tensorboard during training for:
• FeatureClassifier
• Single Shot Detector
• Retinanet
• UNetClassifier
• SuperResolution
• FasterRCNN
• MaskRCNN
• PSPNetClassifier
• DeepLab
• MultiTaskRoadExtractor
• Adds ability to override ImageHeight saved in UnetClassifier, MaskRCNN and FasterRCNN models to enable inferencing on larger image chips if GPU model allows
• SuperResolution

• Adds normalization in labels
• Adds denormalization while inferencing
• Adds compute_metrics() method for accuracy metrics on validation sets
• Adds supported_datasets property

• EntityRecognizer

• Adds ability to save model_metric.html
• Adds time spent per epoch
• Adds extension to support transformer models
• Adds f1_score() description to API reference

• MaskRCNN

• adds default transformations

• FasterRCNN
• Adds multispectrals support when tensorboard=True
• Adds predict() method
• Adds predict_video()
• Adds support for kwargs parameter
• MLModel
• Adds support for unsupervised learning
• Clustering Models
• Gaussian Mixture Models
• Novelty and Outlier Detection Models
• Adds methods:
• decision_function()
• feature_importances()
• predict()
• renames output_raster_folder_path to output_raster_path
• renames predict_features to prediction_type
• Adds multiband raster support
• FeatureClassifier
• Adds multi-label support for training
• Adds note to oversample parameter explaining supported datasets
• Adds parameters to save():
  • compute_metrics
  • save_optimizer
  • save_inference_file
• Adds note to predict() that it only supports RGB images
• Adds PointRend to improve performance for:
• DeepLab
• PSPNetClassifer
• MaskRCNN
• PointCNN
• Updates how transforms are applied on point cloud so both original data and trasformed data passed
• Updates dependencies in SciPy and removes dependencies on transform3d and plotly-orca
• Adds ability to preserve classcodes in file when using predict_las()

Fixes

Guides

• Working with the Spatially Enabled DataFrame
• Updates Visualizing Spatial Data
• Managing ArcGIS Applications
• Updates Managing Workforce projects
• Deep Learning with ArcGIS
• Updates fastai link with Object Detection Workflow with arcgis.learn
• Updates to Working with Multispectral Data
• Updates to [Named Entity Extraction Workflow with arcgis.learn](https://developers.arcgis.com/python/guide/how-named-entity-recognition-works)
• Updates to Point Cloud Segmentation using PointCNN

Samples

• Power Users/Developers
• Updates to various samples:
  • A dashboard to explore world population
  • Using geoprocessing tools
  • Tour the World with Landsat Imagery and Raster Functions
  • Raster Analytics Dashboard
  • Building a change detection app using Jupyter Dashboard
• GIS analysts and data scientists
• Enhances Deep Learning Samples by providing training data
• Fixes typos in sdf field names for Data Summarization - Construction permits near Washington DC, part 2/2
• Adds data for Finding a New Home
• Plant species identification using a TensorFlow-Lite model within mobile devices
  • Updates explanations
  • Removes single band imagery
• Updates paths for data in Vehicle detection and tracking using deep learning
• Updates text for [

Chennai Floods 2015–A Geographic Analysis](https://developers.arcgis.com/python/sample-notebooks/chennai-floods-analysis/) to remove uninitelligble rendering

• Automate Road Surface Investigation Using Deep Learning
  • Adds missing inference data to the predict and predict_video functions in
  • Removes hard-coded lr_find() value
• Information extraction from Madison city crime incident reports using Deep Learning
  • Fixes Table of Contents and hyperlinks
  • Adds Save and load trained models section
  • Updates Prerequisites and imports
• Updates model training data in Automate Building Footprint Extraction using Deep learning
• Updates to organization type and data paths in Land Cover Classification using Satellite Imagery and Deep Learning
• Land cover classification using sparse training data
  • Updates no data explanations
  • Removes data mapping
• [Increase image resolution using SuperResolution](https://developers.arcgis.com/python/sample-notebooks/increase-image-resolution-using-superresolution)
  • Changed Meta Data Format when exporting training data to Export Tiles
  • Fixes typo for output type

arcgis.gis

• Fixes parameter names in PortalDataStore.publish() code example for the config parameter
• Fixes authentication error with Python 3.7 and Notebook Server
• Clarifies documentation for storageUsage parameter of User objects
• Fixes issue with ArcGIS online comments with certain unicode characters not getting returned properly
• Fixes error with clone_items() on Survey items
• Fixes deprecation warnings when import API in Notebook Server
• Item
• Fixes documentation error in parameter table for reassign_to()
• UserManager
• Fixes KeyError: UserTypes error with create() when user_settings configured improperly
• Fixes token errors with public Geometry and Geoprocessing services affecting API and Notebook Server
• Fixes BUG-000133849 - data resource is missing when KML or KMZ files are added to ArcGIS Online
• ContentManager
• Fixes BUG-000133739 - clone_items() on hosted feature layer views returns JSONDecodeError: Expecting value: line 1 column 1 (char 0) error
• GroupMigrationManger
• Fixes to inspect() and load() not recoginizing new items

arcgis.gis.admin

• Fixes error returning ArcGIS Online history() when return type is a DataFrame

arcgis.gis.server

• Fixes issue where a "/" added to the server admin url creates invalid connection
• Fixes issue when creating Server object without a Portal connection on a Federated Server
• Fixes issue with mangled URL when connecting to unfederated servers URL
  • NOTE: The ServiceDirectory list() or find() methods should be used to create Server objects
• ReportManager
• BUG-000133053 list() method returns error if a saved report created from ArcGIS Server manager exists on server
• Fixes issue when create() fails if existing reports named as integers
• Fixes errors in create() documentation for parameters:
  • queries
  • from_value
  • to_value
• Fixes BUG-000134098 unexpected keyword argument from_value error in quick_report()
• Removes incorrect option from since parameter documentation for quick_report()

arcgis.features

• FeatureLayer
• Fixes issue when query() result is esriFieldTypeFloat
• Fixes issue with query(as_df=True) results on Hosted Feature Layer when specifying out_fields and DateTime fields are present
• FeatureLayerCollection
• Fixes extract_changes() returning no values
• Spatially Enabled DataFrame
• Fixes issue when using enrich() with sedf with more than 100 records
• Fixes bug with to_featureclass() not supporting memory workspaces
• Fixes performance issues when reading geometries
• Fixes from_layer() method failing for tables
• Fixes error with set_geometry() not recognizing geometry columns if not named "SHAPE"
• Fixes plot() errors on small or null geometries in environments with ArcPy
• Fixes buffer() method failing on projected geometries
• Fixes to_table() issue with CSV files
• FeatureSet
• Fixes from_geojson() resulting in malformed ring data for polygons
• Fixes from_geojson() failures on MultiPolygons

arcgis.features.analysis

• analyze_patterns
• Fixes find_point_clusters() documentation
• manage_data
• extract_data()
  • Fixes error when output_name parameter is a dictionary
• dissolve_boundaries()
  • Fixes incorrect formatting in code example
• generate_tesselation()
  • Fixes extent_layer parameter documentation so parameter is optional
• summarize_data
• aggregate_points()
  • Fixes issue where polygon layer was required even though bin_type, bin_size, and bin_size_unit were specified
• summarize_nearby()
  • Fixes incorrect format for distances parameter in documentation
• find_locations()
• Fixes failure when setting distance band and distance_band_unit parameters with find_hot_spots()
• Fixes failure when setting distance band and distance_band_unit parameters with find_outliers()

arcgis.features.managers

• SyncManager
• Fixes error with sync_replicated_items() failing to upload features if child is an ArcGIS Enterprise replica
• AttachmentManager
• Fixes issue with update() method not updating the attachment
• FeatureLayerCollectionManager
• Fixes create_view() to honor value for extent parameter
• Fixes code differences in overwrite() so results match Item.publish(overwrite=True) in ArcGIS Enterprise
• Fixes BUG-000124231 - updating a feature layer from a CSV on ArcGIS Enterprise returns error message, Job Failed.

arcgis.raster

• RasterCollection
• Fixes errors with filter_by_calendar_range() method
• ImageryLayer
• Fixes save() failure after using apply() function on secured services

arcgis.raster.functions

• Adds aggregate() function

arcgis.network

• Sets default values for optional parameters to None to rely on service defaults whether in ArcGIS Online and ArcGIS Enterprise

arcgis.geoanalytics

• Fixes situation when a failed tool creates an empty Item in the organization
• Fixes various tools to recognize the output_datastore context parameter for writing output
• Fixes aggregate_points() to use context parameter
• find_locations
• find_dwell_locations()
• Fix incorrect parameter names to correct names:
• time_boundary_ref
• time_boundary_unit

arcgis.geocoding

• Updates suggest() so location parameteris optional

arcgis.geometry

• Fixes issue with various functions ignoring inplace paramter default value
• Fixes issue with various functions not returning the spatialReference with output
• Fixes issue with Polygon failing if order of geometries used is not correct for EsriJSON format

arcgis.mapping

• Fixes BUG-000131799 - import_tiles() returns error:"'Response' object is not subscriptable" because of improper url construction
• Fixes error when extent parameter for OfflineMapAreaManager.create() is a bookmark or dictionary
• WebMap
• Fixes AttributeError: layerType error when calling save()
• Fixes error on save() if WebMap object had a FeatureLayerColletion added with add_layer()
• Fixes issue with add_layer() where only layers are added from an an Item or FeatureLayerCollection that has both layers and tables
• Fixes issue with add_table() trying to get a renderer when adding
• Fixes BUG-000131725 - complex symbology is not preserved for Map Service added using the add_layer() function
• Fixes issue with zoom_to_layer() function failing to display layer if called before map has fully loaded

arcgis.widgets

• Fixes save() and update() methods to manage typeKeywords for offline map usage
• Fixes add_layer() error when adding a raster layer from MapService
• Fixes error when adding WMS layers to map widget with add_layer()
• Fixes drawing error with local Raster objects
• Fixes bug with add_layer() with either local Raster or ImageryLayer as input

arcgis.apps

• Updates workforce module to account for Version 2 schema changes

arcgis.learn

• Disables saving optimizer by default (default value of save_optimizer parameter False in models
• Numerous documentation enhancements
• Fixes fit() methods on multiple models when using tensorboard=True
• Fixes bug with prepare_data() failing with Multispectral data when gdal is not installed
• Removes unnecessary warning messages when debugging is set
• Fixes issue where classcodes are not preserved in output raster when training data has non-contiguous classcode labels for Pixel Classification models
• Fixes issue with inferencing when prepare_data() dataset_type parameter is ChangeDetection and training data is multispectral
• detect_objects()
• Fixes warning messages when deciding between GPU or CPU
• SuperResolution

• Fixes prepare_data issue when not creating labels when called without downsampling_factor
• fixes issue with default transforms causing prediction errors
• fixes error when image data format is tiff
• fixes chip_size causing artifacts while inferencing

• Fixes errors when gdal was not handling non-contiguous class segementation
• EntityRecognizer
• Fixes issues with large loss values during model training
• Fixes per epoch metric calculation bug
• Fixes lr_find() to run for at least one full epoch per learning rate
• Fixes issue with lr_find() output when data prepared with batch_size of 2
• Fixes text column to be first column in show_batch()
• FeatureClassifier
• Fixes issue with fit() not displaying results after training with multipsectral data
• Fixes issues with show_results() failing with smaller validation datasets
• Fixes failures of plot_hard_examples() with multilabel model
• Fixes errors when running fit() if oversample=True
• Fixes issues with plot_losses()
• UnetClassifier
• Fixes issue with incorrect exceptions raised when object craeted with no data
• Fixes missing model type information from output of save()
• Fixes ValueError with lr_find() and fit()
• Fixes show_results() tesnor shape error
• Fixes class weights not used even after specifying class_balancing=True
• Fixes class weights not matching number of classes when data has been exported with one class having pixel value 0
• Fixes inconsistent accuracy() results between fitting and loading
• PSPNetClassifier
• Fixes missing model type information from output of save()
• Fixes inconsistent accuracy() results between fitting and loading
• Fixes ValueError with lr_find() and fit()
• Fixes NameError when intializing with use_unet and unet_aux_loss both set to True
• Fixes class weights not used even after specifying class_balancing=True
• Fixes class weights not matching number of classes when data has been exported with one class having pixel value 0
• Fixes error with lr_find() and VGG backbones if model created with use_unet=True
• Fixes errors in fit() on object created wtih VGG backbone and pointrend=True
• DeepLab
• Fixes class weights not used even after specifying class_balancing=True
• Fixes class weights not matching number of classes when data has been exported with one class having pixel value 0
• Fixes inconsistent accuracy() results between fitting and loading
• MaskRCNN
• Fixes situation with incorrect labels when multiband data is exported
• FasterRCNN
• Fixes show_results() failing with multispectral data
• Fixes issue with save() raising exception instead of returning no boxes when using default parameters
• Fixes fit() method when tensorboard=True
• RetinaNet
• Fixes to auto-detection routines to determine CPU or GPU hardware available
• PointCNN
• Fixes predict_las() failing when output folder is not empty or has files with pred in name or .las extension
• Fixes issues with las and h5 files remaining open after using
• Fixes issue predict_las() failing if .las files have a period in the filename
• Multiple fixes to documentation
• SingleShotDetector
• Fixes predict() TypeError when using multispectral data
• Fixes errors when initializing with mobilnet_v2 or densenet backbones
• Fixes errows with predict() when using multipsectral data and visualize=True
• EntityRecognizer
• Fixes issues with incorrect exceptions raised caling fit() or lr_find() if object initialized without data
• Fixes issue where saving checkpoint was not using the most apt value of validation loss when early_stopping is set to true
• Fixes issue where the HTML file with model metrices (model_metrices.html) not getting saved when training UnetClassifer, PSPNetClassifier, DeepLab, SingelShotDetector and RetinaNet models