plotilla 1.0.0 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +37 -11
- package/data/boundaries/world_countries.geojson +1 -1
- package/dist/colour/colour_scale.d.ts +55 -0
- package/dist/colour/colour_scale.js +80 -0
- package/dist/colour/palette.d.ts +176 -0
- package/dist/colour/palette.js +220 -0
- package/dist/fields/axis_fields.d.ts +56 -0
- package/dist/fields/axis_fields.js +46 -0
- package/dist/fields/colour_fields.d.ts +32 -0
- package/dist/fields/colour_fields.js +31 -0
- package/dist/fields/column_fields.d.ts +52 -0
- package/{src/fields/column_fields.ts → dist/fields/column_fields.js} +15 -29
- package/dist/fields/common_fields.d.ts +9 -0
- package/{src/fields/common_fields.ts → dist/fields/common_fields.js} +3 -6
- package/dist/fields/decide_plot_axes.d.ts +56 -0
- package/dist/fields/decide_plot_axes.js +71 -0
- package/dist/fields/marker_fields.d.ts +8 -0
- package/dist/fields/marker_fields.js +13 -0
- package/dist/fields/read_date_time.d.ts +85 -0
- package/dist/fields/read_date_time.js +199 -0
- package/dist/figure/check_axis_year_formats.d.ts +36 -0
- package/dist/figure/check_axis_year_formats.js +116 -0
- package/dist/figure/check_plot_category_limits.d.ts +128 -0
- package/dist/figure/check_plot_category_limits.js +284 -0
- package/dist/figure/plot_figure.d.ts +861 -0
- package/dist/figure/plot_figure.js +58 -0
- package/dist/figure/resolve_plot_figure.d.ts +28 -0
- package/dist/figure/resolve_plot_figure.js +41 -0
- package/dist/figure/validate_plot_figure.d.ts +50 -0
- package/dist/figure/validate_plot_figure.js +441 -0
- package/dist/map/assign_map_layer_hue_slots.d.ts +89 -0
- package/dist/map/assign_map_layer_hue_slots.js +146 -0
- package/dist/map/boundary_sets.d.ts +65 -0
- package/dist/map/boundary_sets.js +103 -0
- package/dist/map/build_world_outline_across_180.d.ts +21 -0
- package/dist/map/build_world_outline_across_180.js +23 -0
- package/dist/map/check_map_layers.d.ts +16 -0
- package/dist/map/check_map_layers.js +31 -0
- package/dist/map/fetch_region_outlines.d.ts +25 -0
- package/dist/map/fetch_region_outlines.js +39 -0
- package/dist/map/geojson.d.ts +150 -0
- package/dist/map/geojson.js +248 -0
- package/dist/map/join_region_rows.d.ts +40 -0
- package/dist/map/join_region_rows.js +45 -0
- package/dist/map/map_layers.d.ts +229 -0
- package/dist/map/map_layers.js +87 -0
- package/dist/model/find_panel_colour_scale.d.ts +25 -0
- package/dist/model/find_panel_colour_scale.js +27 -0
- package/dist/model/map_model.d.ts +30 -0
- package/dist/model/map_model.js +234 -0
- package/dist/model/panel_layout.d.ts +42 -0
- package/dist/model/panel_layout.js +154 -0
- package/dist/model/panel_model.d.ts +223 -0
- package/dist/model/panel_model.js +7 -0
- package/dist/model/plot_model.d.ts +28 -0
- package/dist/model/plot_model.js +431 -0
- package/dist/model/statistics.d.ts +83 -0
- package/dist/model/statistics.js +107 -0
- package/dist/plots/bar_plot.d.ts +46 -0
- package/dist/plots/bar_plot.js +30 -0
- package/dist/plots/box_plot.d.ts +30 -0
- package/dist/plots/box_plot.js +21 -0
- package/dist/plots/density_plot.d.ts +36 -0
- package/dist/plots/density_plot.js +23 -0
- package/dist/plots/heatmap_plot.d.ts +22 -0
- package/dist/plots/heatmap_plot.js +18 -0
- package/dist/plots/histogram_plot.d.ts +32 -0
- package/dist/plots/histogram_plot.js +24 -0
- package/dist/plots/line_plot.d.ts +44 -0
- package/dist/plots/line_plot.js +25 -0
- package/dist/plots/map_plot.d.ts +92 -0
- package/dist/plots/map_plot.js +35 -0
- package/dist/plots/pie_plot.d.ts +17 -0
- package/dist/plots/pie_plot.js +16 -0
- package/dist/plots/scatter_plot.d.ts +47 -0
- package/dist/plots/scatter_plot.js +27 -0
- package/dist/renderers/date_ticks.d.ts +37 -0
- package/dist/renderers/date_ticks.js +148 -0
- package/dist/renderers/echarts_map.d.ts +47 -0
- package/dist/renderers/echarts_map.js +492 -0
- package/dist/renderers/echarts_options.d.ts +30 -0
- package/dist/renderers/echarts_options.js +449 -0
- package/dist/renderers/echarts_pie_radius.d.ts +52 -0
- package/dist/renderers/echarts_pie_radius.js +158 -0
- package/dist/renderers/escape_html.d.ts +10 -0
- package/dist/renderers/escape_html.js +15 -0
- package/dist/renderers/line_colour_segments.d.ts +39 -0
- package/dist/renderers/line_colour_segments.js +41 -0
- package/dist/renderers/plotly_map.d.ts +48 -0
- package/dist/renderers/plotly_map.js +159 -0
- package/dist/renderers/plotly_options.d.ts +19 -0
- package/dist/renderers/plotly_options.js +345 -0
- package/dist/renderers/year_ticks.d.ts +27 -0
- package/dist/renderers/year_ticks.js +42 -0
- package/dist/table/check_column.d.ts +36 -0
- package/dist/table/check_column.js +46 -0
- package/dist/table/check_values_have_spread.d.ts +30 -0
- package/{src/table/check_values_have_spread.ts → dist/table/check_values_have_spread.js} +16 -17
- package/dist/table/compute_quantile.d.ts +16 -0
- package/dist/table/compute_quantile.js +23 -0
- package/dist/table/data_table.d.ts +59 -0
- package/dist/table/data_table.js +87 -0
- package/dist/table/density_bandwidth.d.ts +64 -0
- package/dist/table/density_bandwidth.js +88 -0
- package/dist/table/find_line_fit.d.ts +30 -0
- package/dist/table/find_line_fit.js +36 -0
- package/dist/table/get_number_range.d.ts +16 -0
- package/{src/table/get_number_range.ts → dist/table/get_number_range.js} +8 -8
- package/dist/table/group_rows.d.ts +40 -0
- package/dist/table/group_rows.js +67 -0
- package/dist/table/list_categories.d.ts +14 -0
- package/{src/table/list_categories.ts → dist/table/list_categories.js} +2 -3
- package/dist/table/read_number.d.ts +12 -0
- package/dist/table/read_number.js +14 -0
- package/package.json +28 -23
- package/src/colour/colour_scale.ts +0 -80
- package/src/colour/palette.ts +0 -220
- package/src/examples/example_figures.ts +0 -320
- package/src/fields/axis_fields.ts +0 -32
- package/src/fields/colour_fields.ts +0 -40
- package/src/fields/decide_plot_axes.ts +0 -77
- package/src/fields/marker_fields.ts +0 -16
- package/src/figure/plot_figure.ts +0 -67
- package/src/figure/resolve_plot_figure.ts +0 -47
- package/src/figure/validate_plot_figure.ts +0 -412
- package/src/map/boundary_sets.ts +0 -116
- package/src/map/check_map_layers.ts +0 -32
- package/src/map/fetch_region_outlines.ts +0 -48
- package/src/map/geojson.ts +0 -174
- package/src/map/map_layers.ts +0 -108
- package/src/model/check_axis_shows_years.ts +0 -58
- package/src/model/map_model.ts +0 -238
- package/src/model/panel_layout.ts +0 -171
- package/src/model/panel_model.ts +0 -85
- package/src/model/plot_model.ts +0 -347
- package/src/model/statistics.ts +0 -134
- package/src/plots/bar_plot.ts +0 -36
- package/src/plots/box_plot.ts +0 -26
- package/src/plots/density_plot.ts +0 -29
- package/src/plots/heatmap_plot.ts +0 -24
- package/src/plots/histogram_plot.ts +0 -29
- package/src/plots/line_plot.ts +0 -29
- package/src/plots/map_plot.ts +0 -46
- package/src/plots/pie_plot.ts +0 -23
- package/src/plots/scatter_plot.ts +0 -32
- package/src/renderers/echarts_map.ts +0 -194
- package/src/renderers/echarts_options.ts +0 -317
- package/src/renderers/plotly_map.ts +0 -170
- package/src/renderers/plotly_options.ts +0 -318
- package/src/table/check_column.ts +0 -34
- package/src/table/compute_quantile.ts +0 -23
- package/src/table/data_table.ts +0 -83
- package/src/table/density_bandwidth.ts +0 -94
- package/src/table/find_line_fit.ts +0 -44
- package/src/table/group_rows.ts +0 -71
package/src/table/group_rows.ts
DELETED
|
@@ -1,71 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Which drawn rows make which series. One rule, read by the model to build
|
|
3
|
-
* each series and by validation to judge each series' trend line, so a
|
|
4
|
-
* figure is never accepted on groups the model would not draw.
|
|
5
|
-
*/
|
|
6
|
-
|
|
7
|
-
import { findOptionalColumn, type DataTable } from "./data_table";
|
|
8
|
-
import { listCategories } from "./list_categories";
|
|
9
|
-
|
|
10
|
-
/** A row's group: the categories it has for each grouping field. */
|
|
11
|
-
export type Grouping = { colourCategories: string[]; styleCategories: string[] };
|
|
12
|
-
|
|
13
|
-
/** One series' rows, with the indices of its colour and style categories and its name. */
|
|
14
|
-
export type RowGroup = { colourIndex: number; styleIndex: number; name: string; rows: number[] };
|
|
15
|
-
|
|
16
|
-
/**
|
|
17
|
-
* Split the drawn rows into series, one per colour and style category.
|
|
18
|
-
* Category indices count every category in the column, drawn or not, so a
|
|
19
|
-
* category with nothing drawn takes no series yet the others keep the
|
|
20
|
-
* colours and styles they would have had.
|
|
21
|
-
*
|
|
22
|
-
* @param table - The data table.
|
|
23
|
-
* @param options - The row count, the colour and style columns, and which rows become marks.
|
|
24
|
-
* @returns The categories of each grouping column, the groups, each with at least one drawn row, and every
|
|
25
|
-
* drawn row in table order: the only rows an axis may read, so a row never drawn sets no range or category.
|
|
26
|
-
*/
|
|
27
|
-
export function groupRows(
|
|
28
|
-
table: DataTable,
|
|
29
|
-
options: { rowCount: number; colour: string | undefined; style: string | undefined; isDrawn: (row: number) => boolean },
|
|
30
|
-
): { grouping: Grouping; groups: RowGroup[]; drawnRows: number[] } {
|
|
31
|
-
const colourValues = findOptionalColumn(table, { column: options.colour });
|
|
32
|
-
const styleValues = findOptionalColumn(table, { column: options.style });
|
|
33
|
-
const grouping: Grouping = {
|
|
34
|
-
colourCategories: colourValues === null ? [] : listCategories(colourValues),
|
|
35
|
-
styleCategories: styleValues === null ? [] : listCategories(styleValues),
|
|
36
|
-
};
|
|
37
|
-
// A Map per category list, so each drawn row finds its index in constant time, not by scanning the list.
|
|
38
|
-
const colourIndexes = buildFirstIndexMap(grouping.colourCategories);
|
|
39
|
-
const styleIndexes = buildFirstIndexMap(grouping.styleCategories);
|
|
40
|
-
const groups = new Map<string, RowGroup>();
|
|
41
|
-
const drawnRows: number[] = [];
|
|
42
|
-
for (let row = 0; row < options.rowCount; row += 1) {
|
|
43
|
-
if (!options.isDrawn(row)) continue;
|
|
44
|
-
const colourText = colourValues === null ? null : colourValues[row] === null ? null : String(colourValues[row]);
|
|
45
|
-
const styleText = styleValues === null ? null : styleValues[row] === null ? null : String(styleValues[row]);
|
|
46
|
-
const colourIndex = colourText === null ? 0 : colourIndexes.get(colourText) ?? -1;
|
|
47
|
-
const styleIndex = styleText === null ? 0 : styleIndexes.get(styleText) ?? -1;
|
|
48
|
-
const parts = [colourText, styleText !== colourText ? styleText : null].filter((part) => part !== null);
|
|
49
|
-
const name = parts.join(" · ");
|
|
50
|
-
const key = `${colourIndex}/${styleIndex}`;
|
|
51
|
-
const group = groups.get(key) ?? { colourIndex, styleIndex, name, rows: [] };
|
|
52
|
-
group.rows.push(row);
|
|
53
|
-
drawnRows.push(row);
|
|
54
|
-
groups.set(key, group);
|
|
55
|
-
}
|
|
56
|
-
return { grouping, groups: [...groups.values()], drawnRows };
|
|
57
|
-
}
|
|
58
|
-
|
|
59
|
-
/**
|
|
60
|
-
* Map each category to the index of its first occurrence, as indexOf finds it.
|
|
61
|
-
*
|
|
62
|
-
* @param categories - The category texts in order.
|
|
63
|
-
* @returns The first index of each text.
|
|
64
|
-
*/
|
|
65
|
-
function buildFirstIndexMap(categories: string[]): Map<string, number> {
|
|
66
|
-
const indexes = new Map<string, number>();
|
|
67
|
-
categories.forEach((category, index) => {
|
|
68
|
-
if (!indexes.has(category)) indexes.set(category, index);
|
|
69
|
-
});
|
|
70
|
-
return indexes;
|
|
71
|
-
}
|