From 13e7bec5c77fed1ec3a8aefa5b382d7fde279297 Mon Sep 17 00:00:00 2001
From: Jeff Allen <jeffrey.allen@10gen.com>
Date: Mon, 8 Nov 2021 13:31:04 -0500
Subject: [PATCH] (DOCSP-18945): densify stage

Add temperature examples to densify
---
 config/redirects                              |   1 +
 source/images/densification-by-partition.png  | Bin 0 -> 31659 bytes
 source/images/densification-full-range.png    | Bin 0 -> 35941 bytes
 source/includes/extracts-agg-stages.yaml      |   4 +
 source/includes/fact-densify-description.rst  |   2 +
 .../fact-densify-image-explanation.rst        |   4 +
 .../operator/aggregation-pipeline.txt         |   8 +-
 .../operator/aggregation/densify.txt          | 547 ++++++++++++++++++
 source/release-notes/5.1.txt                  |  29 +-
 9 files changed, 583 insertions(+), 12 deletions(-)
 create mode 100644 source/images/densification-by-partition.png
 create mode 100644 source/images/densification-full-range.png
 create mode 100644 source/includes/fact-densify-description.rst
 create mode 100644 source/includes/fact-densify-image-explanation.rst
 create mode 100644 source/reference/operator/aggregation/densify.txt

diff --git a/config/redirects b/config/redirects
index 4594ac51127..8b73cbcfb06 100644
--- a/config/redirects
+++ b/config/redirects
@@ -1797,6 +1797,7 @@ raw: /manual/core/wildcard -> ${base}/manual/core/index-wildcard/
 
 [v3.6-v5.0]: /${version}/reference/operator/aggregation/tsIncrement/ -> ${base}/${version}/reference/operator/aggregation/
 [v3.6-v5.0]: /${version}/reference/operator/aggregation/tsSecond/ -> ${base}/${version}/reference/operator/aggregation/
+[v3.6-v5.0]: /${version}/reference/operator/aggregation/densify/ -> ${base}/${version}/reference/operator/aggregation/
 
 #
 # Redirects for new 5.0 pages
diff --git a/source/images/densification-by-partition.png b/source/images/densification-by-partition.png
new file mode 100644
index 0000000000000000000000000000000000000000..66c8819ab370a8cc14f43a7021d053921b485c1a
GIT binary patch
literal 31659
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
G&;$TS&iT3k

literal 0
HcmV?d00001

diff --git a/source/images/densification-full-range.png b/source/images/densification-full-range.png
new file mode 100644
index 0000000000000000000000000000000000000000..475c329fa781cc7e688b2293b7b0ad59604df710
GIT binary patch
literal 35941
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
C5pK8u

literal 0
HcmV?d00001

diff --git a/source/includes/extracts-agg-stages.yaml b/source/includes/extracts-agg-stages.yaml
index 4bcb0bc5f30..9ba03102545 100644
--- a/source/includes/extracts-agg-stages.yaml
+++ b/source/includes/extracts-agg-stages.yaml
@@ -42,6 +42,10 @@ content: |
 
           Distinct from the :group:`$count` aggregation accumulator.
 
+      * - :pipeline:`$densify`
+
+        - .. include:: /includes/fact-densify-description.rst
+
       * - :pipeline:`$documents`
         - Returns literal documents from input expressions.
 
diff --git a/source/includes/fact-densify-description.rst b/source/includes/fact-densify-description.rst
new file mode 100644
index 00000000000..324ff3f0609
--- /dev/null
+++ b/source/includes/fact-densify-description.rst
@@ -0,0 +1,2 @@
+Creates new documents in a sequence of documents where certain values
+in a field are missing.
diff --git a/source/includes/fact-densify-image-explanation.rst b/source/includes/fact-densify-image-explanation.rst
new file mode 100644
index 00000000000..a5cfb5928c4
--- /dev/null
+++ b/source/includes/fact-densify-image-explanation.rst
@@ -0,0 +1,4 @@
+- The darker squares represent the original documents in the collection.
+
+- The lighter squares represent the documents created with
+  :pipeline:`$densify`.
diff --git a/source/reference/operator/aggregation-pipeline.txt b/source/reference/operator/aggregation-pipeline.txt
index 71b71c6e221..b4b5c5f241e 100644
--- a/source/reference/operator/aggregation-pipeline.txt
+++ b/source/reference/operator/aggregation-pipeline.txt
@@ -103,7 +103,12 @@ Alphabetical Listing of Stages
    * - :pipeline:`$currentOp`
 
      - Returns information on active and/or dormant operations for the
-       MongoDB deployment. To run, use the :method:`db.aggregate()` method.
+       MongoDB deployment. To run, use the :method:`db.aggregate()`
+       method.
+       
+   * - :pipeline:`$densify`
+
+     - .. include:: /includes/fact-densify-description.rst
    
 
    * - :pipeline:`$facet`
@@ -325,6 +330,7 @@ Alphabetical Listing of Stages
    /reference/operator/aggregation/collStats
    /reference/operator/aggregation/count
    /reference/operator/aggregation/currentOp
+   /reference/operator/aggregation/densify
    /reference/operator/aggregation/documents
    /reference/operator/aggregation/facet
    /reference/operator/aggregation/geoNear
diff --git a/source/reference/operator/aggregation/densify.txt b/source/reference/operator/aggregation/densify.txt
new file mode 100644
index 00000000000..a74f5c09093
--- /dev/null
+++ b/source/reference/operator/aggregation/densify.txt
@@ -0,0 +1,547 @@
+======================
+$densify (aggregation)
+======================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+Definition
+----------
+
+.. pipeline:: $densify
+
+   .. versionadded:: 5.1
+   
+   .. include:: /includes/fact-densify-description.rst
+
+   You can use :pipeline:`$densify` to:
+   
+   - Fill gaps in time series data.
+   - Add missing values between groups of data.
+   - Populate your data with a specified range of values.
+
+Syntax
+------
+
+The :pipeline:`$densify` stage has this syntax:
+
+.. code-block:: javascript
+
+   {
+      $densify: {
+         field: <fieldName>,
+         partitionByFields: [ <field 1>, <field 2> ... <field n> ],
+         range: {
+            step: <number>,
+            unit: <time unit>,
+            bounds: < "full" || "partition" > || [ < lower bound >, < upper bound > ]
+         }
+      }
+   }
+
+The :pipeline:`$densify` stage takes a document with these fields:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 25 15 70
+
+   * - Field
+     - Necessity
+     - Description
+
+   * - :ref:`field <densify-field>`
+
+     - Required
+     
+     - .. _densify-field:
+     
+       The field to densify. The values of the specified
+       ``field`` must either be all numeric values or all dates.
+
+       Documents that do not contain the specified ``field`` continue
+       through the pipeline unmodified.
+
+       For restrictions, see :ref:`densify-field-restrictions`.
+
+   * - :ref:`partitionByFields <densify-partition-by-fields>`
+
+     - Optional
+
+     - .. _densify-partition-by-fields:
+
+       The set of fields to act as the compound key to group
+       the documents. In the :pipeline:`$densify` stage, each group of
+       documents is known as a *partition*.
+
+       If you omit this field, :pipeline:`$densify` uses one partition
+       for the entire collection.
+
+       For an example, see :ref:`densify-examples-partitions`.
+
+       For restrictions, see :ref:`partition-by-fields-restrictions`.
+
+   * - :ref:`range <densify-range>`
+
+     - Required
+
+     - .. _densify-range:
+
+       An object that specifies how the data is densified.
+
+   * - :ref:`range.bounds <densify-bounds>`
+
+     - Required
+
+     - .. _densify-bounds:
+
+       You can specify ``range.bounds`` as either:
+
+       - An array: ``[ < lower bound >, < upper bound > ]``,
+       - A string: either ``"full"`` or ``"partition"``.
+
+       If ``bounds`` is an array:
+       
+       - :pipeline:`$densify` adds documents spanning the range of
+         values within the specified bounds. 
+
+       - The data type for the bounds must correspond to the data type
+         in the :ref:`field <densify-field>` being densified.
+       
+       - For behavior details, see :ref:`bounds-behavior`.
+
+       If ``bounds`` is ``"full"``:
+
+       - :pipeline:`$densify` adds documents spanning the full range of
+         values of the ``field`` being densified.
+
+       If ``bounds`` is ``"partition"``:
+
+       - :pipeline:`$densify` adds documents to each partition,
+         similar to if you had run a ``full`` range densification on
+         each partition individually.
+
+   * - :ref:`range.step <densify-step>`
+
+     - Required
+
+     - .. _densify-step:
+
+       The amount to increment the :ref:`field <densify-field>` value
+       in each document. :pipeline:`$densify` creates a new document for
+       each ``step`` between the existing documents.
+
+       If :ref:`range.unit <densify-unit>` is specified, ``step``
+       must be an integer. Otherwise, ``step`` can be any numeric
+       value.
+
+   * - :ref:`range.unit <densify-unit>`
+
+     - Required if :ref:`field <densify-field>` is a date.
+
+     - .. _densify-unit:
+
+       The unit to apply to the :ref:`step <densify-step>` field when
+       incrementing date values in :ref:`field <densify-field>`.
+
+       You can specify one of the following values for ``unit``
+       as a string:
+
+       - ``millisecond``
+       - ``second``
+       - ``minute``
+       - ``hour``
+       - ``week``
+       - ``month``
+       - ``quarter``
+       - ``year``
+
+       For an example, see :ref:`densify-examples-time-series`.
+
+Behavior and Restrictions
+-------------------------
+
+.. _densify-field-restrictions:
+
+``field`` Restrictions
+~~~~~~~~~~~~~~~~~~~~~~
+
+For documents that contain the specified :ref:`field <densify-field>`,
+:pipeline:`$densify` errors if: 
+
+- Any document in the collection has a ``field`` value  of type date and
+  the :ref:`unit <densify-unit>` field is not specified.
+
+- Any document in the collection has a ``field`` value  of type numeric
+  and the :ref:`unit <densify-unit>` field is specified.
+
+- The ``field`` name begins with ``$``. You must rename the field if
+  you want to densify it. To rename fields, use :pipeline:`$project`.
+
+.. _partition-by-fields-restrictions:
+
+``partitionByFields`` Restrictions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+:pipeline:`$densify` errors if any field name in the
+:ref:`partitionByFields <densify-partition-by-fields>` array:
+
+- Evaluates to a non-string value.
+- Begins with ``$``.
+
+.. _bounds-behavior:
+
+``range.bounds`` Behavior
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If :ref:`range.bounds <densify-bounds>` is an array:
+
+- The lower bound indicates the start value for the added
+  documents, irrespective of documents already in the collection.
+
+- The lower bound is inclusive.
+
+- The upper bound is exclusive.
+
+- :pipeline:`$densify` does not filter out documents with
+  :ref:`field <densify-field>` values outside of the specified
+  bounds.
+
+Order of Output
+~~~~~~~~~~~~~~~
+
+:pipeline:`$densify` does not guarantee sort order of the documents
+it outputs.
+
+To guarantee sort order, use :pipeline:`$sort` on the field you want
+to sort by.
+
+Examples
+--------
+
+.. _densify-examples-time-series:
+
+Densify Time Series Data
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Create a ``weather`` collection that contains temperature readings over 
+four hour intervals.
+
+.. code-block:: javascript
+
+  db.weather.insertMany( [
+     {
+         "metadata": { "sensorId": 5578, "type": "temperature" },
+         "timestamp": ISODate("2021-05-18T00:00:00.000Z"),
+         "temp": 12
+     }, 
+     {
+         "metadata": { "sensorId": 5578, "type": "temperature" },
+         "timestamp": ISODate("2021-05-18T04:00:00.000Z"),
+         "temp": 11
+     }, 
+     {
+         "metadata": { "sensorId": 5578, "type": "temperature" },
+         "timestamp": ISODate("2021-05-18T08:00:00.000Z"),
+         "temp": 11
+     }, 
+     {
+         "metadata": { "sensorId": 5578, "type": "temperature" },
+         "timestamp": ISODate("2021-05-18T12:00:00.000Z"),
+         "temp": 12
+     }
+  ] )
+
+This example uses the :pipeline:`$densify` stage to fill in the gaps
+between the four-hour intervals:
+
+.. code-block:: javascript
+
+  db.weather.aggregate( [
+     {
+        $densify: {
+           field: "timestamp",
+           range: {
+              step: 1, 
+              unit: "hour",
+              bounds:[ ISODate("2021-05-18T00:00:00.000Z"), ISODate("2021-05-18T08:00:00.000Z") ]
+           }
+        }
+     }
+  ] )
+
+In the example:
+
+- The :pipeline:`$densify` stage fills in the gaps of time in between the 
+  recorded temperatures.
+  
+  - ``field: "timestamp"`` densifies the ``timestamp`` field.
+  
+  - ``range:``
+  
+    - ``step: 1`` increments the ``timestamp`` field by 1 unit.
+  
+    - ``unit: hour`` densifies the ``timestamp`` field by the hour.
+  
+    - ``bounds: [ ISODate("2021-05-18T00:00:00.000Z"), ISODate("2021-05-18T08:00:00.000Z") ]``
+      sets the range of time that is densified.
+
+In the following output, the :pipeline:`$densify` stage fills in the gaps of time
+between the hours of ``00:00:00`` and ``08:00:00``.
+
+.. code-block:: javascript
+  :emphasize-lines: 8-10, 17-19
+
+  [
+    {
+      _id: ObjectId("618c207c63056cfad0ca4309"),
+      metadata: { sensorId: 5578, type: 'temperature' },
+      timestamp: ISODate("2021-05-18T00:00:00.000Z"),
+      temp: 12
+    },
+    { timestamp: ISODate("2021-05-18T01:00:00.000Z") },
+    { timestamp: ISODate("2021-05-18T02:00:00.000Z") },
+    { timestamp: ISODate("2021-05-18T03:00:00.000Z") },
+    {
+      _id: ObjectId("618c207c63056cfad0ca430a"),
+      metadata: { sensorId: 5578, type: 'temperature' },
+      timestamp: ISODate("2021-05-18T04:00:00.000Z"),
+      temp: 11
+    },
+    { timestamp: ISODate("2021-05-18T05:00:00.000Z") },
+    { timestamp: ISODate("2021-05-18T06:00:00.000Z") },
+    { timestamp: ISODate("2021-05-18T07:00:00.000Z") },
+    {
+      _id: ObjectId("618c207c63056cfad0ca430b"),
+      metadata: { sensorId: 5578, type: 'temperature' },
+      timestamp: ISODate("2021-05-18T08:00:00.000Z"),
+      temp: 11
+    }
+    {
+      _id: ObjectId("618c207c63056cfad0ca430c"),
+      metadata: { sensorId: 5578, type: 'temperature' },
+      timestamp: ISODate("2021-05-18T12:00:00.000Z"),
+      temp: 12
+    }
+  ]
+
+.. _densify-examples-partitions:
+
+Densifiction with Partitions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Create a ``coffee`` collection that contains data for two
+varieties of coffee beans:
+
+.. code-block:: javascript
+
+   db.coffee.insertMany( [ 
+      {
+         "altitude": 600,
+         "variety": "Arabica Typica",
+         "score": 68.3
+      },
+      {
+         "altitude": 750,
+         "variety": "Arabica Typica",
+         "score": 69.5
+      },
+      {
+         "altitude": 950,
+         "variety": "Arabica Typica",
+         "score": 70.5
+      },
+      {
+         "altitude": 1250,
+         "variety": "Gesha",
+         "score": 88.15
+      },
+      {
+        "altitude": 1700,
+        "variety": "Gesha",
+        "score": 95.5,
+        "price": 1029
+      }
+   ] )
+
+Densify the Full Range of Values
+````````````````````````````````
+
+This example uses :pipeline:`$densify` to densify the
+``altitude`` field for each coffee ``variety``:
+
+.. code-block:: javascript
+   :emphasize-lines: 7
+
+   db.coffee.aggregate( [
+      {
+         $densify: {
+            field: "altitude",
+            partitionByFields: [ "variety" ],
+            range: {
+               bounds: "full",
+               step: 200
+            }
+         }
+      }
+   ] )
+
+The example aggregation:
+
+- Partitions the documents by ``variety`` to create one grouping for
+  ``Arabica Typica`` and one for ``Gesha`` coffee.
+
+- Specifies a ``full`` range, meaning that the data is densified
+  across the full range of existing documents *for each partition*.
+
+- Specifies a ``step`` of ``200``, meaning new documents are created
+  at ``altitude`` intervals of ``200``.
+
+The aggregation outputs the following documents:
+
+.. code-block:: javascript
+   :emphasize-lines: 14,21-24,31-32,40-43
+
+   [
+      {
+        _id: ObjectId("618c031814fbe03334480475"),
+        altitude: 600,
+        variety: 'Arabica Typica',
+        score: 68.3
+      },
+      {
+        _id: ObjectId("618c031814fbe03334480476"),
+        altitude: 750,
+        variety: 'Arabica Typica',
+        score: 69.5
+      },
+      { variety: 'Arabica Typica', altitude: 800 },
+      {
+        _id: ObjectId("618c031814fbe03334480477"),
+        altitude: 950,
+        variety: 'Arabica Typica',
+        score: 70.5
+      },
+      { variety: 'Gesha', altitude: 600 },
+      { variety: 'Gesha', altitude: 800 },
+      { variety: 'Gesha', altitude: 1000 },
+      { variety: 'Gesha', altitude: 1200 },
+      {
+        _id: ObjectId("618c031814fbe03334480478"),
+        altitude: 1250,
+        variety: 'Gesha',
+        score: 88.15
+      },
+      { variety: 'Gesha', altitude: 1400 },
+      { variety: 'Gesha', altitude: 1600 },
+      {
+        _id: ObjectId("618c031814fbe03334480479"),
+        altitude: 1700,
+        variety: 'Gesha',
+        score: 95.5,
+        price: 1029
+      },
+      { variety: 'Arabica Typica', altitude: 1000 },
+      { variety: 'Arabica Typica', altitude: 1200 },
+      { variety: 'Arabica Typica', altitude: 1400 },
+      { variety: 'Arabica Typica', altitude: 1600 }
+    ]
+
+This image visualizes the documents created with :pipeline:`$densify`:
+
+.. figure:: /images/densification-full-range.png
+   :alt: State of the coffee collection after full-range densifiction
+   :figwidth: 700px
+
+.. include:: /includes/fact-densify-image-explanation.rst
+
+Densify Values within Each Partition
+````````````````````````````````````
+
+This example uses :pipeline:`$densify` to only densify gaps in the
+``altitude`` field within each ``variety``:
+
+.. code-block:: javascript
+   :emphasize-lines: 7
+
+   db.coffee.aggregate( [
+      {
+         $densify: {
+            field: "altitude",
+            partitionByFields: [ "variety" ],
+            range: {
+               bounds: "partition",
+               step: 200
+            }
+         }
+      }
+   ] )
+
+The example aggregation:
+
+- Partitions the documents by ``variety`` to create one grouping for
+  ``Arabica Typica`` and one for ``Gesha`` coffee.
+
+- Specifies a ``partition`` range, meaning that the data is densified
+  within each partition.
+
+  - For the ``Arabica Typica`` partition, the range is ``600``-``900``.
+
+  - For the ``Gesha`` partition, the range is ``1250``-``1700``.
+
+- Specifies a ``step`` of ``200``, meaning new documents are created
+  at ``altitude`` intervals of ``200``.
+
+The aggregation outputs the following documents:
+
+.. code-block:: javascript
+   :emphasize-lines: 14,27-28
+
+   [
+      {
+        _id: ObjectId("618c031814fbe03334480475"),
+        altitude: 600,
+        variety: 'Arabica Typica',
+        score: 68.3
+      },
+      {
+        _id: ObjectId("618c031814fbe03334480476"),
+        altitude: 750,
+        variety: 'Arabica Typica',
+        score: 69.5
+      },
+      { variety: 'Arabica Typica', altitude: 800 },
+      {
+        _id: ObjectId("618c031814fbe03334480477"),
+        altitude: 950,
+        variety: 'Arabica Typica',
+        score: 70.5
+      },
+      {
+        _id: ObjectId("618c031814fbe03334480478"),
+        altitude: 1250,
+        variety: 'Gesha',
+        score: 88.15
+      },
+      { variety: 'Gesha', altitude: 1450 },
+      { variety: 'Gesha', altitude: 1650 },
+      {
+        _id: ObjectId("618c031814fbe03334480479"),
+        altitude: 1700,
+        variety: 'Gesha',
+        score: 95.5,
+        price: 1029
+      }
+    ]
+
+This image visualizes the documents created with :pipeline:`$densify`:
+
+.. figure:: /images/densification-by-partition.png
+   :alt: State of the coffee collection after partition range densification
+   :figwidth: 700px
+
+.. include:: /includes/fact-densify-image-explanation.rst
diff --git a/source/release-notes/5.1.txt b/source/release-notes/5.1.txt
index f3ecbd199bc..72ea20e0dae 100644
--- a/source/release-notes/5.1.txt
+++ b/source/release-notes/5.1.txt
@@ -19,17 +19,7 @@ Release Notes for MongoDB 5.1
 Aggregation
 -----------
 
-.. _5.1-rel-notes-new-agg-operators:
-
-$geoNear accepts ``let-bound`` variables
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. include:: /includes/fact-5.1-geonear-let-allowed.rst
-
-$lookup and $graphLookup with sharded collections
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. include:: /includes/5.1-fact-sharded-lookup-graphlookup.rst
+.. _5.1-rel-notes-new-agg-stages:
 
 New Aggregation Stages
 ~~~~~~~~~~~~~~~~~~~~~~
@@ -42,9 +32,16 @@ MongoDB 5.1 introduces the following aggregation stages:
 
    * - Stage
      - Description
+
+   * - :pipeline:`$densify`
+     - Creates new documents in a sequence of documents where values in
+       a specified field are missing.
+
    * - :pipeline:`$documents`
      - Returns literal documents from input expressions.
 
+.. _5.1-rel-notes-new-agg-operators:
+
 New Aggregation Operators
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -63,6 +60,16 @@ MongoDB 5.1 introduces the following aggregation operators:
    * - :expression:`$tsIncrement`
      - .. include:: /includes/tsIncrement-introduction.rst
 
+$geoNear accepts ``let-bound`` variables
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/fact-5.1-geonear-let-allowed.rst
+
+$lookup and $graphLookup with sharded collections
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/5.1-fact-sharded-lookup-graphlookup.rst
+
 
 General Aggregation Improvements
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~