11.. _data-table-ref:
22
3- ==========
4- Data Table
5- ==========
3+ =====
4+ Table
5+ =====
66
77.. default-domain:: mongodb
88
@@ -12,17 +12,17 @@ Data Table
1212 :depth: 1
1313 :class: singlecol
1414
15- Data tables represent data in a tabular view, similar to a
16- `spreadsheet <https://en.wikipedia.org/wiki/Spreadsheet>`_. Data tables
15+ Tables represent data in a tabular view, similar to a
16+ `spreadsheet <https://en.wikipedia.org/wiki/Spreadsheet>`_. Tables
1717split your data into categories, with each categorization field
1818represented in the table columns. The unique categories are represented
1919as the table rows, and |charts-short| displays aggregated values in the
2020table body based on the fields selected.
2121
22- Data Table Encoding Channels
23- ----------------------------
22+ Table Encoding Channels
23+ -----------------------
2424
25- Data tables use the following :ref:`encoding channels
25+ Tables use the following :ref:`encoding channels
2626<encoding-channels>`:
2727
2828.. list-table::
@@ -75,17 +75,17 @@ Data tables use the following :ref:`encoding channels
7575Use Cases
7676---------
7777
78- Data tables have a wide variety of applications, but are most useful
78+ Tables have a wide variety of applications, but are most useful
7979when comparing multiple categories of calculated values. Visual charts
8080struggle to display multiple categories of data without losing their
81- audience. Data tables present data with multiple categories such that
81+ audience. Tables present data with multiple categories such that
8282you can see which value applies to which slice of data.
8383
84- Data tables are also useful for showing precise data values, rather
84+ Tables are also useful for showing precise data values, rather
8585than comparing approximate values. Comparing approximate values is
8686best done with a visual representation, instead of text.
8787
88- You can use data tables to show:
88+ You can use tables to show:
8989
9090- The total cost to rent an apartment, including rent, cleaning fees,
9191 and security deposits organized by location and total area of the
@@ -100,7 +100,7 @@ You can use data tables to show:
100100Customization Options
101101---------------------
102102
103- The following customization options are specific to data table charts.
103+ The following customization options are specific to table charts.
104104To see all available customization options, see
105105:ref:`customize-charts`.
106106
@@ -123,12 +123,12 @@ Pin Columns
123123~~~~~~~~~~~
124124
125125You can pin :guilabel:`Group` and :guilabel:`Row Total` columns to the
126- side of the data table. A pinned column remains fixed in place while the
126+ side of the table. A pinned column remains fixed in place while the
127127rest of the table scrolls.
128128
129129To pin a column, hover over the column you want to pin and click the
130130:icon-fa5:`map-pin` button in the column header. The :icon-fa5:`map-pin`
131- button toggles on and the column pins to the side of the data table:
131+ button toggles on and the column pins to the side of the table:
132132
133133- A :guilabel:`Group` column pins to the left of any unpinned
134134 columns.
@@ -155,31 +155,31 @@ customization option.
155155Examples
156156--------
157157
158- The following data table examples visualize data from a hospitality
158+ The following table examples visualize data from a hospitality
159159and property service. Each document in the collection
160160represents a unit available for rent and includes information such as
161161the monthly unit price, neighborhood, and property type.
162162
163- Basic Data Table
164- ~~~~~~~~~~~~~~~~
163+ Basic Table
164+ ~~~~~~~~~~~
165165
166- The following data table categorizes the rental listings by property
166+ The following table categorizes the rental listings by property
167167type and location, and shows the average review rating and average
168168weekly rent for each group:
169169
170170.. figure:: /images/charts/data-table-basic-example.png
171171 :figwidth: 750px
172- :alt: Basic Data Table Example
172+ :alt: Basic Table Example
173173
174174The :guilabel:`Group` encoding channels of ``property_type`` and
175- ``suburb`` create a row in the data table for each unique combination
175+ ``suburb`` create a row in the table for each unique combination
176176of those two fields in the data.
177177
178178The :guilabel:`Values` of ``review_scores_rating`` and
179179``weekly_price`` each add a column to the table. For both values, we
180180average the rating and price for each ``property type`` and ``suburb``
181181using :manual:`aggregation </aggregation>` and display the results in
182- the data table.
182+ the table.
183183
184184The results are formatted using the Customization tab to display the
185185mean weekly price as currency and round the mean review score to an
@@ -193,17 +193,17 @@ appropriate number of decimal places.
193193
194194.. _dynamic-col-example:
195195
196- Data Table with Dynamic Columns
197- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
196+ Table with Dynamic Columns
197+ ~~~~~~~~~~~~~~~~~~~~~~~~~~
198198
199- The following data table displays nearly the same data as the previous
200- basic data table example. In this example, instead of making
199+ The following table displays nearly the same data as the previous
200+ basic table example. In this example, instead of making
201201``property_type`` and ``suburb`` :guilabel:`Groups`, ``property_type``
202202field is now a :guilabel:`Dynamic Column`:
203203
204204.. figure:: /images/charts/data-table-dynamic-example.png
205205 :figwidth: 750px
206- :alt: Basic Data Table Example
206+ :alt: Basic Table Example
207207
208208Now, rather than having two category columns in the table, the
209209``property_types`` become column titles. We are still aggregating
@@ -221,7 +221,7 @@ mean weekly price as currency.
221221Limitations
222222-----------
223223
224- The maximum query response size for a data table is 50000 documents.
224+ The maximum query response size for a table is 50000 documents.
225225
226226.. toctree::
227227 :titlesonly:
0 commit comments