demo D180

Profiling a column in htmx

Count, spread, quartiles and outliers from the API, into a panel of your own

grid.statistics.profile(col)

This grid reads a column's count, spread, quartiles and outliers from the statistics API into a panel of your own. It lets you build a bespoke profiling view on the figures the grid already computes, rather than calculating them yourself.

Building…

Loading a live grid…

This is the htmx version. A server-rendered table is upgraded in place, so the page is readable before any script runs and gains the full grid when the module loads, which suits a progressively enhanced app.

The configuration

<link rel="stylesheet" href="https://cdn.latticegrid.dev/lattice-grid@1.107.0/lattice-grid.min.css">

<!-- A real, server-rendered table: readable with JavaScript off. data-field on
     each header names the column that cell becomes, and data-id on each row is
     the key the grid carries it under. -->
<table id="column-profiling-table" data-lattice-grid>
  <thead>
    <tr>
      <th data-field="symbol">Symbol</th>
      <th data-field="desk">Desk</th>
      <th data-field="price">Price</th>
      <th data-field="bid">Bid</th>
      <th data-field="volume">Volume</th>
      <th data-field="notional">Notional</th>
    </tr>
  </thead>
  <tbody>
    <tr data-id="INS-0000000"><td>ELMW.G0</td><td>Rates</td><td>462.0258</td><td>461.2688</td><td>239420</td><td>110618217</td></tr>
    <tr data-id="INS-0000001"><td>RVNS.A1</td><td>Credit</td><td>241.8711</td><td>241.7978</td><td>119353</td><td>28868041</td></tr>
    <tr data-id="INS-0000002"><td>NRTH.E2</td><td>Commodities</td><td>98.9614</td><td>98.8353</td><td>160242</td><td>15857773</td></tr>
    <!-- the rest of the rows, rendered by your server -->
  </tbody>
</table>
<pre id="out" style="margin-top: 12px"></pre>

<script type="module">
  import { hydrateTable } from 'https://cdn.latticegrid.dev/lattice-grid@1.107.0/modules/htmx.esm.min.js';

  // The markup carries the rows; a server-rendered table's column types are
  // declared in the config hydrateTable takes. The grid replaces the table
  // where it stood.
  const grid = hydrateTable(document.getElementById('column-profiling-table'), {
    toolPanel: { side: 'left', panels: ['filters', 'columns'] },
    columns: [
      { field: 'symbol', title: 'Symbol', layout: { pin: 'start', width: 120 } },
      { field: 'desk', title: 'Desk', filter: { type: 'set' } },
      { field: 'price', title: 'Price', type: 'number' },
      { field: 'bid', title: 'Bid', type: 'number' },
      { field: 'volume', title: 'Volume', type: 'number' },
      { field: 'notional', title: 'Notional', type: 'number',
        format: { style: 'currency', currency: 'USD' }, total: 'sum' },
    ],
  });

  // profile reads a full summary of one column over the filtered rows: the
  // count, the spread, the quartiles and the shape of the distribution.
  // Recompute it whenever the filters change, so the read-out always describes
  // what is on screen.
  const out = document.getElementById('out');
  const report = () => {
    out.textContent = JSON.stringify(grid.statistics.profile('notional'), null, 2);
  };
  grid.on('filter:changed', report);
  report();
</script>