Merge pull request #2047 from Esri/jy-adv-cart1

use relative link to refer to api guide and change comment text

Author: jyaistMap

guide/10-mapping-and-visualization/advanced-cartography-part1.ipynb

@@ -27,9 +27,39 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 1,
+   "execution_count": null,
    "metadata": {},
    "outputs": [],
+   "source": [
+    "from arcgis.gis import GIS\n",
+    "\n",
+    "gis = GIS(\n",
+    "    profile=\"your_organization_profile\"\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Intel MKL WARNING: Support of Intel(R) Streaming SIMD Extensions 4.2 (Intel(R) SSE4.2) enabled only processors has been deprecated. Intel oneAPI Math Kernel Library 2025.0 will require Intel(R) Advanced Vector Extensions (Intel(R) AVX) instructions.\n",
+      "Intel MKL WARNING: Support of Intel(R) Streaming SIMD Extensions 4.2 (Intel(R) SSE4.2) enabled only processors has been deprecated. Intel oneAPI Math Kernel Library 2025.0 will require Intel(R) Advanced Vector Extensions (Intel(R) AVX) instructions.\n"
+     ]
+    },
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "/Users/john3092/opt/anaconda3/envs/geosaurus_dev_env/lib/python3.11/site-packages/dask/dataframe/_pyarrow_compat.py:23: UserWarning: You are using pyarrow version 11.0.0 which is known to be insecure. See https://www.cve.org/CVERecord?id=CVE-2023-47248 for further details. Please upgrade to pyarrow>=14.0.1 or install pyarrow-hotfix to patch your current version.\n",
+      "  warnings.warn(\n"
+     ]
+    }
+   ],
    "source": [
     "from arcgis.gis import GIS\n",
     "\n",
@@ -82,7 +112,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "If you have numeric data, you may want to distinguish features using graduated colors to reflect a count or an amount. Different kinds of color ramps can be used—for example, a simple light-to-dark color ramp is good for showing low-to-high data values such as age, income, or ratio. Color ramps like this can be applied to points, lines, or polygons. Let's use a light-to-dark color ramp to represent the ratio of cropland area to general land area from low to high by county. More documentation can be found in [Style numbers](http://doc.arcgis.com/en/arcgis-online/create-maps/style-numbers.htm#ESRI_SECTION1_1D8BD412F83148C6ABF315CA10111E66)."
+    "If you have numeric data, you may want to distinguish features using graduated colors to reflect a count or an amount. Different kinds of color ramps can be used—for example, a simple light-to-dark color ramp is good for showing low-to-high data values such as age, income, or ratio. Color ramps like this can be applied to points, lines, or polygons. Let's use a light-to-dark color ramp to represent the ratio of cropland area to general land area from low to high by county. More documentation can be found in [Style numbers](https://doc.arcgis.com/en/arcgis-online/reference/style-numbers.htm)."
    ]
   },
   {
@@ -91,12 +121,6 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "\"\"\"\n",
-    "    # only 1 numeric attribute\n",
-    "    # (a) to visualize with counts and amounts (color)\n",
-    "    # field_name here represents \"The acres of total cropland as a percentage of land area in acres\"\n",
-    "\"\"\"\n",
-    "\n",
     "from arcgis.layers import Service\n",
     "\n",
     "usa_flayer = Service(\n",
@@ -112,6 +136,12 @@
    "metadata": {},
    "outputs": [],
    "source": [
+    "\"\"\"\n",
+    "    # using 1 numeric attribute to visualize differences by color\n",
+    "    # field_name here represents \"The acres of total cropland as a percentage of land area in acres\"\n",
+    "\"\"\"\n",
+    "\n",
+    "\n",
     "renderer_manager = map1.content.renderer(0)\n",
     "smart_mapping_manager = renderer_manager.smart_mapping()\n",
     "smart_mapping_manager.class_breaks_renderer(break_type=\"color\", field=\"M086_07\")"
@@ -776,7 +806,7 @@
     "## Conclusion\n",
     "When you style a layer, the styling options offered depend on the type of features you are mapping (point, line, or polygon) as well as the type of data attributes (numbers, categories, dates, and so on) and number of attributes you choose. Each style helps you tell a slightly different story and answer different questions with your data. Samples shown here are meant to give you basic ideas of how built-in renderer types like Class Breaks Renderers or Unique Value Renderers are being used, or when you need to customize your styles, how to direct Python in allowing the Javascript API to attempt to infer the renderer by some of the Javascript API rules.\n",
     "\n",
-    "Now that we have mastered some basic styles of visualizing numeric or orderable data, let's move on to the second half of the topic (`advanced-cartography-part2.ipynb`) for guides on how to style your map based on categorical data."
+    "Now that we have mastered some basic styles of visualizing numeric or orderable data, let's move on to the [Advanced Cartography Part2 guide](../advanced-cartography-part2) to style your map based on categorical data."
    ]
   }
  ],
@@ -796,7 +826,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.10.14"
+   "version": "3.11.0"
   },
   "toc": {
    "base_numbering": 1,