-
Notifications
You must be signed in to change notification settings - Fork 1.1k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
230581b
commit 3a20b5c
Showing
75 changed files
with
36,333 additions
and
226 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Large diffs are not rendered by default.
Oops, something went wrong.
143 changes: 142 additions & 1 deletion
143
guide/01-getting-started/using-the-jupyter-notebook-environment.ipynb
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1 +1,142 @@ | ||
| {"cells": [{"cell_type": "markdown", "metadata": {}, "source": ["# Using the Jupyter Notebook environment\n", "\n", "This section provides a quick introduction to the Jupyter Notebook environment where you can run Python code in an interactive manner and visualize the output as maps and charts. Refer to the [official Jupyter documentation](http://jupyter.readthedocs.io/en/latest/) and [this quick start guide](https://jupyter-notebook-beginner-guide.readthedocs.io/en/latest/index.html) for further details."]}, {"cell_type": "markdown", "metadata": {"toc": true}, "source": ["<h1>Table of Contents<span class=\"tocSkip\"></span></h1>\n", "<div class=\"toc\"><ul class=\"toc-item\"><li><span><a href=\"#Using-the-Jupyter-Notebook-environment\" data-toc-modified-id=\"Using-the-Jupyter-Notebook-environment-1\"><span class=\"toc-item-num\">1 </span>Using the Jupyter Notebook environment</a></span><ul class=\"toc-item\"><li><span><a href=\"#Starting-the-Jupyter-Notebook-environment\" data-toc-modified-id=\"Starting-the-Jupyter-Notebook-environment-1.1\"><span class=\"toc-item-num\">1.1 </span>Starting the Jupyter Notebook environment</a></span></li><li><span><a href=\"#Running-the-sample-notebooks\" data-toc-modified-id=\"Running-the-sample-notebooks-1.2\"><span class=\"toc-item-num\">1.2 </span>Running the sample notebooks</a></span></li><li><span><a href=\"#Creating-new-notebooks\" data-toc-modified-id=\"Creating-new-notebooks-1.3\"><span class=\"toc-item-num\">1.3 </span>Creating new notebooks</a></span></li><li><span><a href=\"#Further-help-and-keyboard-shortcuts\" data-toc-modified-id=\"Further-help-and-keyboard-shortcuts-1.4\"><span class=\"toc-item-num\">1.4 </span>Further help and keyboard shortcuts</a></span></li></ul></li></ul></div>"]}, {"cell_type": "markdown", "metadata": {}, "source": ["## Starting the Jupyter Notebook environment\n", "\n", "Once conda and the ArcGIS API for Python is [installed](https://developers.arcgis.com/python/guide/install-and-set-up), you can start the Jupyter Notebook environment by typing the following command in your terminal.\n", "\n", " jupyter notebook\n", "\n", "If you are running a Windows OS, this could be your command prompt or PowerShell window. Similarly if you are running a Mac or Linux OS, this could be your terminal. Below is a screen shot of how it would appear if you were running the command from Windows command prompt."]}, {"cell_type": "markdown", "metadata": {}, "source": [""]}, {"cell_type": "markdown", "metadata": {}, "source": ["If you installed the ArcGIS API for Python in a conda **environment** other than root (which is the default), you need to `activate` that environment before starting the Jupyter Notebook. For more information on the benefits of using environments and how to create and manage them, refer to this [official documentation page](http://conda.pydata.org/docs/using/envs.html).\n", "\n", "If you are running a sample notebook for the API, you need to 'cd' into the directory where you [downloaded the samples](https://github.com/Esri/arcgis-python-api/releases/tag/v0.3-beta). In the example above, the samples have been downloaded and extracted into c:\\code directory.\n", "\n", "The command starts Jupyter Notebook and opens it in your default web browser as shown below."]}, {"cell_type": "markdown", "metadata": {}, "source": ["\n", "\n", "The page you see in this image is called the Notebook Dashboard."]}, {"cell_type": "markdown", "metadata": {}, "source": ["## Running the sample notebooks\n", "\n", "In the Jupyter Notebook, you can navigate the folder structure and click on a sample notebook. This opens the notebook in a new tab or window. You can run each cell by selecting it and clicking on the 'run cell' button. Alternately, you can run a cell using the keyboard shortcut `shift + enter`. The animation below shows these steps in action."]}, {"cell_type": "markdown", "metadata": {}, "source": ["\n", "\n", "When a cell is executing the cell number turns to an asterisk `(*)` and the circle next to the kernal name (Python 3 in the gif above) turns solid."]}, {"cell_type": "markdown", "metadata": {}, "source": ["## Creating new notebooks\n", "\n", "In addition to running the sample notebooks, you can create new notebooks for your projects. To do so, from the Notebook Dashboard page, click on the 'New' button and select a Python kernel of choice as shown in the image below.\n", "\n", "\n", "\n", "Alternately, you can create new notebooks from the 'File' menu of a running notebook. In the screenshot above, note the icons of currently running notebooks are green in color."]}, {"cell_type": "markdown", "metadata": {}, "source": ["## Further help and keyboard shortcuts\n", "\n", "You can get a tour of the notebook interface from the `Help -> User Interface Tour` menu. As you get used to this new interface, you can enhance your productivity by learning a few keyboard shortcuts. Accessing `Help > Keyboard shortcuts` from a running notebook will bring up a help dialog as shown below.\n", "\n", "\n", "\n", "Among the shortcuts, `ctrl + shift + P` or `cmd + shift + P` on a mac is particularly useful as it brings up a command palette into which you can type what you wish to do and execute it. Refer to this blog article [Five tips to get you started with Jupyter notebooks](https://blogs.esri.com/esri/arcgis/2017/06/30/82220/) to get further understanding on patterns to follow while using Jupyter notebooks."]}], "metadata": {"anaconda-cloud": {}, "kernelspec": {"display_name": "Python 3", "language": "python", "name": "python3"}, "language_info": {"codemirror_mode": {"name": "ipython", "version": 3}, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.8.2"}, "toc": {"base_numbering": 1, "nav_menu": {}, "number_sections": true, "sideBar": true, "skip_h1_title": false, "title_cell": "Table of Contents", "title_sidebar": "Contents", "toc_cell": true, "toc_position": {}, "toc_section_display": true, "toc_window_display": true}}, "nbformat": 4, "nbformat_minor": 1} | ||
| { | ||
| "cells": [ | ||
| { | ||
| "cell_type": "markdown", | ||
| "metadata": {}, | ||
| "source": [ | ||
| "# Using the Jupyter Notebook environment\n", | ||
| "\n", | ||
| "This section provides a quick introduction to the Jupyter Notebook environment where you can run Python code in an interactive manner and visualize the output as maps and charts. Refer to the [official Jupyter documentation](http://jupyter.readthedocs.io/en/latest/) and [this quick start guide](https://jupyter-notebook-beginner-guide.readthedocs.io/en/latest/index.html) for further details." | ||
| ] | ||
| }, | ||
| { | ||
| "cell_type": "markdown", | ||
| "metadata": { | ||
| "toc": true | ||
| }, | ||
| "source": [ | ||
| "<h1>Table of Contents<span class=\"tocSkip\"></span></h1>\n", | ||
| "<div class=\"toc\"><ul class=\"toc-item\"><li><span><a href=\"#Using-the-Jupyter-Notebook-environment\" data-toc-modified-id=\"Using-the-Jupyter-Notebook-environment-1\"><span class=\"toc-item-num\">1 </span>Using the Jupyter Notebook environment</a></span><ul class=\"toc-item\"><li><span><a href=\"#Starting-the-Jupyter-Notebook-environment\" data-toc-modified-id=\"Starting-the-Jupyter-Notebook-environment-1.1\"><span class=\"toc-item-num\">1.1 </span>Starting the Jupyter Notebook environment</a></span></li><li><span><a href=\"#Running-the-sample-notebooks\" data-toc-modified-id=\"Running-the-sample-notebooks-1.2\"><span class=\"toc-item-num\">1.2 </span>Running the sample notebooks</a></span></li><li><span><a href=\"#Creating-new-notebooks\" data-toc-modified-id=\"Creating-new-notebooks-1.3\"><span class=\"toc-item-num\">1.3 </span>Creating new notebooks</a></span></li><li><span><a href=\"#Further-help-and-keyboard-shortcuts\" data-toc-modified-id=\"Further-help-and-keyboard-shortcuts-1.4\"><span class=\"toc-item-num\">1.4 </span>Further help and keyboard shortcuts</a></span></li></ul></li></ul></div>" | ||
| ] | ||
| }, | ||
| { | ||
| "cell_type": "markdown", | ||
| "metadata": {}, | ||
| "source": [ | ||
| "## Starting the Jupyter Notebook environment\n", | ||
| "\n", | ||
| "Once conda and the ArcGIS API for Python is [installed](https://developers.arcgis.com/python/guide/install-and-set-up), you can start the Jupyter Notebook environment by typing the following command in your terminal.\n", | ||
| "\n", | ||
| " jupyter notebook\n", | ||
| "\n", | ||
| "If you are running a Windows OS, this could be your command prompt or PowerShell window. Similarly if you are running a Mac or Linux OS, this could be your terminal. Below is a screen shot of how it would appear if you were running the command from Windows command prompt." | ||
| ] | ||
| }, | ||
| { | ||
| "cell_type": "markdown", | ||
| "metadata": {}, | ||
| "source": [ | ||
| "" | ||
| ] | ||
| }, | ||
| { | ||
| "cell_type": "markdown", | ||
| "metadata": {}, | ||
| "source": [ | ||
| "If you installed the ArcGIS API for Python in a conda **environment** other than root (which is the default), you need to `activate` that environment before starting the Jupyter Notebook. For more information on the benefits of using environments and how to create and manage them, refer to this [official documentation page](http://conda.pydata.org/docs/using/envs.html).\n", | ||
| "\n", | ||
| "If you are running a sample notebook for the API, you need to 'cd' into the directory where you [downloaded the samples](https://github.com/Esri/arcgis-python-api/releases/tag/v0.3-beta). In the example above, the samples have been downloaded and extracted into c:\\code directory.\n", | ||
| "\n", | ||
| "The command starts Jupyter Notebook and opens it in your default web browser as shown below." | ||
| ] | ||
| }, | ||
| { | ||
| "cell_type": "markdown", | ||
| "metadata": {}, | ||
| "source": [ | ||
| "\n", | ||
| "\n", | ||
| "The page you see in this image is called the Notebook Dashboard." | ||
| ] | ||
| }, | ||
| { | ||
| "cell_type": "markdown", | ||
| "metadata": {}, | ||
| "source": [ | ||
| "## Running the sample notebooks\n", | ||
| "\n", | ||
| "In the Jupyter Notebook, you can navigate the folder structure and click on a sample notebook. This opens the notebook in a new tab or window. You can run each cell by selecting it and clicking on the 'run cell' button. Alternately, you can run a cell using the keyboard shortcut `shift + enter`. The animation below shows these steps in action." | ||
| ] | ||
| }, | ||
| { | ||
| "cell_type": "markdown", | ||
| "metadata": {}, | ||
| "source": [ | ||
| "\n", | ||
| "\n", | ||
| "When a cell is executing the cell number turns to an asterisk `(*)` and the circle next to the kernal name (Python 3 in the gif above) turns solid." | ||
| ] | ||
| }, | ||
| { | ||
| "cell_type": "markdown", | ||
| "metadata": {}, | ||
| "source": [ | ||
| "## Creating new notebooks\n", | ||
| "\n", | ||
| "In addition to running the sample notebooks, you can create new notebooks for your projects. To do so, from the Notebook Dashboard page, click on the 'New' button and select a Python kernel of choice as shown in the image below.\n", | ||
| "\n", | ||
| "\n", | ||
| "\n", | ||
| "Alternately, you can create new notebooks from the 'File' menu of a running notebook. In the screenshot above, note the icons of currently running notebooks are green in color." | ||
| ] | ||
| }, | ||
| { | ||
| "cell_type": "markdown", | ||
| "metadata": {}, | ||
| "source": [ | ||
| "## Further help and keyboard shortcuts\n", | ||
| "\n", | ||
| "You can get a tour of the notebook interface from the `Help -> User Interface Tour` menu. As you get used to this new interface, you can enhance your productivity by learning a few keyboard shortcuts. Accessing `Help > Keyboard shortcuts` from a running notebook will bring up a help dialog as shown below.\n", | ||
| "\n", | ||
| "\n", | ||
| "\n", | ||
| "Among the shortcuts, `ctrl + shift + P` or `cmd + shift + P` on a mac is particularly useful as it brings up a command palette into which you can type what you wish to do and execute it. Refer to this blog article [Five tips to get you started with Jupyter notebooks](https://blogs.esri.com/esri/arcgis/2017/06/30/82220/) to get further understanding on patterns to follow while using Jupyter notebooks." | ||
| ] | ||
| } | ||
| ], | ||
| "metadata": { | ||
| "anaconda-cloud": {}, | ||
| "kernelspec": { | ||
| "display_name": "Python 3 (ipykernel)", | ||
| "language": "python", | ||
| "name": "python3" | ||
| }, | ||
| "language_info": { | ||
| "codemirror_mode": { | ||
| "name": "ipython", | ||
| "version": 3 | ||
| }, | ||
| "file_extension": ".py", | ||
| "mimetype": "text/x-python", | ||
| "name": "python", | ||
| "nbconvert_exporter": "python", | ||
| "pygments_lexer": "ipython3", | ||
| "version": "3.11.8" | ||
| }, | ||
| "toc": { | ||
| "base_numbering": 1, | ||
| "nav_menu": {}, | ||
| "number_sections": true, | ||
| "sideBar": true, | ||
| "skip_h1_title": false, | ||
| "title_cell": "Table of Contents", | ||
| "title_sidebar": "Contents", | ||
| "toc_cell": true, | ||
| "toc_position": {}, | ||
| "toc_section_display": true, | ||
| "toc_window_display": true | ||
| } | ||
| }, | ||
| "nbformat": 4, | ||
| "nbformat_minor": 4 | ||
| } |
46 changes: 23 additions & 23 deletions
46
guide/04-feature-data-and-analysis/analyzing-patterns-in-feature-data.ipynb
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
741 changes: 740 additions & 1 deletion
741
...e/04-feature-data-and-analysis/checking-out-data-from-feature-layers-using-replicas.ipynb
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
1,470 changes: 1,469 additions & 1 deletion
1,470
guide/04-feature-data-and-analysis/editing-features.ipynb
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.