(DOCSP-4606) Creating a tutorial for creating Choropleth Charts (#675)

* Created a tutorial for choropleth charts

* Apply suggestions from code review

Co-authored-by: davidhou17 <[email protected]>

---------

Co-authored-by: davidhou17 <[email protected]>

Author: euniceadam-mdb

source/chart-type-reference/choropleth.txt

@@ -119,13 +119,19 @@ section.
 For more information, see :ref:`Color Palette Customization
 <color-palette-customization>`.
 
+.. _choropleth-examples:
+
 Examples
 --------
 
 The following choropleth chart visualizes the total count of
 movie releases across various countries. Each document in the
 collection contains an array of countries where a particular movie was
-released.
+released. 
+
+To build the chart in this example, see the following tutorial:
+
+- :ref:`create-choropleth-chart`
 
 .. figure:: /images/charts/geo-type-choropleth.png
    :alt: Choropleth example chart
@@ -156,6 +162,75 @@ high movie release counts compared with other countries.
    their expected values, refer to the
    :ref:`Choropleth Regions <choropleth-regions>` page.
 
+Tutorial
+--------
+
+Prerequisites
+~~~~~~~~~~~~~
+
+The tutorial on this page uses the ``sample_mflix.movies collection``. Before starting, 
+you must load the sample data on your cluster. To learn how to load the sample data provided 
+by |service| into your cluster, see :atlas:`Load Sample Data </sample-data/>`.
+
+.. _create-choropleth-chart:
+
+Create a Geospatial Choropleth Chart
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This tutorial demonstrates how to create :ref:`a geospatial choropleth chart <choropleth-examples>` that visualizes 
+the total count of movie releases across various countries. 
+
+.. procedure::
+   :style: normal
+
+   .. step:: Add a geospatial choropleth chart to your dashboard.
+      
+      a. From the :guilabel:`Dashboards` page, select the dashboard 
+         where you want to add a new chart. For instructions on setting 
+         up a dashboard, see :doc:`Dashboards </dashboards>`.
+
+      #. Click :guilabel:`Add Chart`.
+
+      #. In the :guilabel:`Select Data Source` modal, click the 
+         :guilabel:`Project` tab. 
+         
+      #. In the cluster where you loaded the 
+         sample data, select the ``movies`` collection 
+         in the ``sample_mflix`` database.
+
+      #. In the :guilabel:`Chart Type` dropdown, click :guilabel:`Geo Choropleth`.
+
+      For more details, see :ref:`create-new-chart`.
+
+   .. step:: Add fields to your chart.
+
+      a. Select the :guilabel:`Encode` tab. 
+
+      #. Navigate to the :guilabel:`Fields` pane on the left side of 
+         the Chart Builder. This section lists all available fields 
+         in the ``movies`` collection.
+    
+      #. Drag the ``countries`` geopoint field to 
+         the :guilabel:`Location` encoding channel.
+
+      #. Under the :guilabel:`Choose Method` drop down for the :guilabel:`Location` 
+         encoding channel, click :guilabel:`Unwind Array`.
+     
+      #. Drag the ``_id`` field to the :guilabel:`Color` 
+         encoding channel.
+
+      #. Under the :guilabel:`Aggregate` drop down for the :guilabel:`Color` 
+         encoding channel, click :guilabel:`Count`.
+
+   .. step:: Save the charts to your dashboard.
+
+      a. Optionally, in the :guilabel:`Preview` pane, :guilabel:`Enter a title`
+         or :guilabel:`Enter a description` for your chart.
+         
+      #. Click :guilabel:`Save and Close` 
+         at the upper right of the chart builder view.
+
+
 Limitations
 -----------