1
1
.. _data-table-ref:
2
2
3
- ==========
4
- Data Table
5
- ==========
3
+ =====
4
+ Table
5
+ =====
6
6
7
7
.. default-domain:: mongodb
8
8
@@ -12,17 +12,17 @@ Data Table
12
12
:depth: 1
13
13
:class: singlecol
14
14
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
17
17
split your data into categories, with each categorization field
18
18
represented in the table columns. The unique categories are represented
19
19
as the table rows, and |charts-short| displays aggregated values in the
20
20
table body based on the fields selected.
21
21
22
- Data Table Encoding Channels
23
- ----------------------------
22
+ Table Encoding Channels
23
+ -----------------------
24
24
25
- Data tables use the following :ref:`encoding channels
25
+ Tables use the following :ref:`encoding channels
26
26
<encoding-channels>`:
27
27
28
28
.. list-table::
@@ -75,17 +75,17 @@ Data tables use the following :ref:`encoding channels
75
75
Use Cases
76
76
---------
77
77
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
79
79
when comparing multiple categories of calculated values. Visual charts
80
80
struggle 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
82
82
you can see which value applies to which slice of data.
83
83
84
- Data tables are also useful for showing precise data values, rather
84
+ Tables are also useful for showing precise data values, rather
85
85
than comparing approximate values. Comparing approximate values is
86
86
best done with a visual representation, instead of text.
87
87
88
- You can use data tables to show:
88
+ You can use tables to show:
89
89
90
90
- The total cost to rent an apartment, including rent, cleaning fees,
91
91
and security deposits organized by location and total area of the
@@ -100,7 +100,7 @@ You can use data tables to show:
100
100
Customization Options
101
101
---------------------
102
102
103
- The following customization options are specific to data table charts.
103
+ The following customization options are specific to table charts.
104
104
To see all available customization options, see
105
105
:ref:`customize-charts`.
106
106
@@ -123,12 +123,12 @@ Pin Columns
123
123
~~~~~~~~~~~
124
124
125
125
You 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
127
127
rest of the table scrolls.
128
128
129
129
To pin a column, hover over the column you want to pin and click the
130
130
: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:
132
132
133
133
- A :guilabel:`Group` column pins to the left of any unpinned
134
134
columns.
@@ -155,31 +155,31 @@ customization option.
155
155
Examples
156
156
--------
157
157
158
- The following data table examples visualize data from a hospitality
158
+ The following table examples visualize data from a hospitality
159
159
and property service. Each document in the collection
160
160
represents a unit available for rent and includes information such as
161
161
the monthly unit price, neighborhood, and property type.
162
162
163
- Basic Data Table
164
- ~~~~~~~~~~~~~~~~
163
+ Basic Table
164
+ ~~~~~~~~~~~
165
165
166
- The following data table categorizes the rental listings by property
166
+ The following table categorizes the rental listings by property
167
167
type and location, and shows the average review rating and average
168
168
weekly rent for each group:
169
169
170
170
.. figure:: /images/charts/data-table-basic-example.png
171
171
:figwidth: 750px
172
- :alt: Basic Data Table Example
172
+ :alt: Basic Table Example
173
173
174
174
The :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
176
176
of those two fields in the data.
177
177
178
178
The :guilabel:`Values` of ``review_scores_rating`` and
179
179
``weekly_price`` each add a column to the table. For both values, we
180
180
average the rating and price for each ``property type`` and ``suburb``
181
181
using :manual:`aggregation </aggregation>` and display the results in
182
- the data table.
182
+ the table.
183
183
184
184
The results are formatted using the Customization tab to display the
185
185
mean weekly price as currency and round the mean review score to an
@@ -193,17 +193,17 @@ appropriate number of decimal places.
193
193
194
194
.. _dynamic-col-example:
195
195
196
- Data Table with Dynamic Columns
197
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
196
+ Table with Dynamic Columns
197
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~
198
198
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
201
201
``property_type`` and ``suburb`` :guilabel:`Groups`, ``property_type``
202
202
field is now a :guilabel:`Dynamic Column`:
203
203
204
204
.. figure:: /images/charts/data-table-dynamic-example.png
205
205
:figwidth: 750px
206
- :alt: Basic Data Table Example
206
+ :alt: Basic Table Example
207
207
208
208
Now, rather than having two category columns in the table, the
209
209
``property_types`` become column titles. We are still aggregating
@@ -221,7 +221,7 @@ mean weekly price as currency.
221
221
Limitations
222
222
-----------
223
223
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.
225
225
226
226
.. toctree::
227
227
:titlesonly:
0 commit comments