Skip to content

Commit 189a065

Browse files
authored
Merge pull request #2055 from Esri/john_branch_edits
Typo and formatting fixes
2 parents 1af4ddc + 32c8a8b commit 189a065

File tree

2 files changed

+21
-16
lines changed

2 files changed

+21
-16
lines changed

guide/02-api-overview/deprecation-notices.ipynb

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -13,10 +13,6 @@
1313
"\n",
1414
"These classes, functions, and modules in the ArcGIS API for Python are deprecated and may cause compatibility issues in future versions:\n",
1515
"\n",
16-
"### `arcgis.gis` Module \n",
17-
"\n",
18-
"- `arcgis.gis.UserManager.create` - the `level` parameter is depreacted at **2.4.0** and will be removed from the method signature in a future release. \n",
19-
"\n",
2016
"### `arcgis.apps` Module \n",
2117
"\n",
2218
"- `arcgis.apps.dashboard` - entire module deprecated at version **2.1.0**. This sub-module may be removed at a future major release\n",
@@ -36,7 +32,7 @@
3632
"\n",
3733
"### `arcgis.learn` Module\n",
3834
"\n",
39-
"- `categorize_features` - depreacted in **1.7.1** and will be removed in a future major release (For example: 2.x to 3.x). Please use `arcgis.learn.classify_objects` instead.\n",
35+
"- `categorize_features` - deprecated in **1.7.1** and will be removed in a future major release (For example: 2.x to 3.x). Please use `arcgis.learn.classify_objects` instead.\n",
4036
"\n",
4137
"### `arcgis.gis.agonb` Module \n",
4238
"\n",
@@ -56,6 +52,7 @@
5652
"- `Item.share` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n",
5753
"- `Item.shared_with` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n",
5854
"- `Item.unshare` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n",
55+
"- `arcgis.gis.UserManager.create` - the `level` parameter is deprecated at **2.4.0** and will be removed from the method signature in a future release. \n",
5956
"\n",
6057
"### `arcgis.mapping` Module\n",
6158
"\n",
@@ -192,7 +189,7 @@
192189
"name": "python",
193190
"nbconvert_exporter": "python",
194191
"pygments_lexer": "ipython3",
195-
"version": "3.11.0"
192+
"version": "3.10.14"
196193
}
197194
},
198195
"nbformat": 4,

guide/02-api-overview/overview24.ipynb

Lines changed: 18 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
"source": [
88
"## Summary\n",
99
"\n",
10-
"The 2.4 Release contains many new changes that improve the performance and experience of using the Python API. The Python API incorporates the Jupyter Lab 4.0 and Notebook 7.0 architecture to align with how these applications process Python code. The backend architecture changes necessitated a complete overhaul of fundamental structures within the Python API which required both the removal of some modules and classes and transfer of functionality into new modules, classes, and accompanying properties and methods. \n",
10+
"The 2.4 Release contains many new changes that improve the performance and experience of using the Python API. The Python API incorporates the Jupyter Lab 4.0 and Notebook 7.0 architecture to align with how these applications process Python code. The backend architecture changes necessitated a complete overhaul of fundamental structures within the Python API which required both the removal of some modules & classes and the transfer of functionality into new modules, classes, and accompanying properties/methods. \n",
1111
"\n",
1212
"These modifications change how some familiar functionality is accessed, and provides some new ways to work with your Web GIS organization. Let's take a look at some of these new updates."
1313
]
@@ -169,13 +169,13 @@
169169
"|WebMap operation |Map operation |Notes|\n",
170170
"|:- |:- |:- |\n",
171171
"|wm.add_layer()|m.content.add()|new [_MapContent_](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.MapContent) class method\n",
172-
"|wm.add_table()]()|m.content.add()|new [_MapContent_](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.MapContent) class method\n",
172+
"|wm.add_table()|m.content.add()|new [_MapContent_](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.MapContent) class method\n",
173173
"|wm.basemap_title()|m.basemap.title|new [_BasemapManager_](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.BasemapManager) class property\n",
174174
"|wm.configure_pop_ups()|m.content.popup(index_position)|new [_PopupManager_](/python/api-reference/arcgis.map.toc.html#arcgis.map.popups.PopupManager) class\n",
175175
"|wm.get_layer()|m.content.layers[index_position]||new [_MapContent_](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.MapContent) class method\n",
176176
"|wm.get_table()|m.content.tables[index_position]||new [_MapContent_](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.MapContent) class method\n",
177-
"|wm.move_from_basemap()|m.basemap.move_from_basemap()|new [_BasemapManager_](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.BasemapManager) class method\n",
178-
"|wm.move_to_basemap()]|m.content.move_to_basemap(layer_index)|new [_MapContent_](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.MapContent) class method\n",
177+
"|wm.move_from_basemap()|m.basemap.move_from_basemap(layer_index)|new [_BasemapManager_](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.BasemapManager) class method\n",
178+
"|wm.move_to_basemap()|m.content.move_to_basemap(layer_index)|new [_MapContent_](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.MapContent) class method\n",
179179
"|wm.print()|m.print()|\n",
180180
"|wm.remove_layer()|m.content.remove(index_position)|new [_MapContent_](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.MapContent) class method\n",
181181
"|wm.remove_table()|m.content.remove(index_position, False)|new [_MapContent_](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.MapContent) class method\n",
@@ -240,7 +240,7 @@
240240
"\n",
241241
"In previous releases, maps and scenes were intialized based on the _mode_ argument entered in the [GIS.map()](/python/api-reference/arcgis.gis.toc.html#arcgis.gis.GIS.map) method, or by setting the [_mode_](/python/api-reference/arcgis.widgets.html#arcgis.widgets.MapView.mode) property of a _MapView_ object. Either way, you were always working with an instance of the _MapView_ class. You can still use the _mode_ argument when intializing the _gis.map()_ object, but rather than returning the same type of object, the default value of _2D_ will return a _Map_ object, and _3D_ will return a _Scene_ object. Refactoring the calls allowed Python development to align with the [web map specification](https://developers.arcgis.com/web-map-specification/) and the [web scene specification](https://developers.arcgis.com/web-map-specification/) directly. This will increase widget compatibility within notebooks to more closely reflect the browser experiences of the Map Viewer and Scene Viewer.\n",
242242
"\n",
243-
"Some properties and methods on the _MapView_ class have been entirely removed, including interactive functionality that could be programmed into specific events like _on_click_ and _on_draw_, embedding the widget into the notebook, and properties and methods that controlled the Jupyter environment. Other properties and method have been refactored into new classes, many using the exact same name. See the table below for a mapping between previous _MapView_ method and property names and how to access that functionality within the 2.4 release.\n",
243+
"Some properties and methods on the _MapView_ class have been entirely removed, including interactive functionality that could be programmed into specific events like _on_click_ and _on_draw_, embedding the widget into the notebook, and properties and methods that controlled the Jupyter environment. Other properties and methods have been refactored into new classes, many using the exact same name. See the table below for a mapping between previous _MapView_ method and property names and how to access that functionality within the 2.4 release.\n",
244244
"\n",
245245
"> _Note:_ In the table below, _mview_ represents a variable to a _MapView_ object, _m_ represents a variable to a _Map_ object, and _scene_ to a _Scene_ object.\n",
246246
"\n",
@@ -275,9 +275,9 @@
275275
"|MapView class member |Map class member |Notes|\n",
276276
"|:- |:- |:- |\n",
277277
"|mview.basemap|m.basemap.basemap|new [_BasemapManager_](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.BasemapManager) class property\n",
278-
"|mview.center|m.center|\n",
279278
"|mview.basemaps|m.basemap.basemaps|new [_BasemapManager_](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.BasemapManager) class property\n",
280279
"|mview.center|m.center|\n",
280+
"|mview.draw|m.content.draw()|\n",
281281
"|mview.end_time|m.time_slider.time_extent()|new [_TimeSlider_](/ypthon/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.TimeSlider) class method\n",
282282
"|mview.extent|m.extent|\n",
283283
"|mview.gallery_basemaps|m.basemap.basemap_gallery|new [_BasemapManager_](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.BasemapManager) class property\n",
@@ -294,8 +294,8 @@
294294
"|mview.start_time|m.time_slider.time_extent()|new [_TimeSlider_](/ypthon/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.TimeSlider) class method\n",
295295
"|mview.tab_mode|NA|\n",
296296
"|mview.tilt|scene.tilt|new [_Scene_](/python/api-reference/arcgis.map.toc.html#arcgis.map.Scene) class property\n",
297-
"|mview.time_mode|m.time_slider.time_extent()|new [TimeSlider]((/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.TimeSlider) class method\n",
298-
"|mview.time_slider|m.time_slider.enabled=True|new [TimeSlider]((/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.TimeSlider) widget\n",
297+
"|mview.time_mode|m.time_slider.time_extent()|new [TimeSlider](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.TimeSlider) class method\n",
298+
"|mview.time_slider|m.time_slider.enabled=True|new [TimeSlider](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.TimeSlider) widget\n",
299299
"|mview.zoom|m.zoom|"
300300
]
301301
},
@@ -320,7 +320,7 @@
320320
"* _content_ property - returns [MapContent](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.MapContent) object to manage layers in a map\n",
321321
" * _popup_ property - returns [PopupManager](/python/api-reference/arcgis.map.toc.html#arcgis.map.popups.PopupManager) object to manage popup information for the layer entered as the _index_ argument\n",
322322
" * See [Locating addresses](../part2-locating-addresses/) for examples.\n",
323-
" * _renderer_ property - returns [RendererManager](/python/api-reference/arcgis.map.toc.html#arcgis.map.renderers.RendererManager) object to manage symbology for layer entered as teh _index_ argument\n",
323+
" * _renderer_ property - returns [RendererManager](/python/api-reference/arcgis.map.toc.html#arcgis.map.renderers.RendererManager) object to manage symbology for layer entered as the _index_ argument\n",
324324
" * See [Analyzing patterns in feature data](../analyzing-patterns-in-feature-data/) for example.\n",
325325
" * _layer_visibility_ property - adds or removes a layer from the [layer list widget](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.LayerList) \n",
326326
"* _basemap_ property - returns [BasemapManager](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.BasemapManager) object to manage the basemap for the map\n",
@@ -455,6 +455,14 @@
455455
"\n",
456456
"print(type(scene_obj))"
457457
]
458+
},
459+
{
460+
"cell_type": "code",
461+
"execution_count": null,
462+
"id": "3c5be553-5744-490f-9c7b-7a2d1c4007e5",
463+
"metadata": {},
464+
"outputs": [],
465+
"source": []
458466
}
459467
],
460468
"metadata": {
@@ -473,7 +481,7 @@
473481
"name": "python",
474482
"nbconvert_exporter": "python",
475483
"pygments_lexer": "ipython3",
476-
"version": "3.11.0"
484+
"version": "3.10.14"
477485
}
478486
},
479487
"nbformat": 4,

0 commit comments

Comments
 (0)