Microclasses

To visualize the microclasses and their similarities, one can compute a microclass heatmap:

/$ qumin action=microclasses data=<dataset.package.json>

This will compute patterns, then the microclasses heatmap. To pass pre-computed patterns, pass the patterns computation metadata path:

/$ qumin action=microclasses patterns=<path/to/metadata.json> data=<dataset.package.json>

It is also possible to pass class labels to facilitate comparisons with another classification:

/$ qumin action=microclasses label=inflection_class patterns=<path/to/metadata.json> data=<dataset.package.json>

The label key is the name of the column in the Paralex lexemes table to use as labels.

Changed in version 4.0.0: From version 4.0.0 on, the ambiguous action heatmap is removed and replaced by microclasses.

Full reference

Microclasses display options are under the heatmap namespace. Available heatmap options (see also the common options):

class qumin.config.config.HeatmapConfig(*, label=None, cmap=None, exhaustive_labels=False, dense=False, annotate=False, order=None, cols=None, display=<factory>)[source]
Parameters:

  • label (str | None) – Lexeme column to use as label (for microclass heatmap, eg. inflection_class)

  • cmap (str | None) – Colormap name

  • exhaustive_labels (bool) – by default, seaborn shows only some labels on the heatmap for readability. This forces seaborn to print all labels.

  • dense (bool) – Use initials instead of full labels (only for entropy heatmap)

  • annotate (bool) – Display values on the heatmap. (only for entropy heatmap)

  • order (Any | None) – Priority list for sorting features (for entropy heatmap) ex: [number, case]). If no features-values file available, you can use the key cells to provide an ordered list of cells to display. Special value “autosort” in order to sort by cell similarity.

  • cols (List[str] | None) – List of features to show in columns (for zones heatmap) ex: [Mode, Tense]). All other features will constitute rows.

  • display (HeatmapDisplayConfig) – Options to switch on/off additional heatmaps.

Values for the heatmap_display keyword:

class qumin.config.config.HeatmapDisplayConfig(*, n_pairs=True, freq_margins=True)[source]

Set to True/False to show or hide detailed information on the heatmap

Parameters:

  • n_pairs (bool) – Whether to display the number of pairs.

  • freq_margins (bool) – Whether to display frequency margins on heatmaps.

The default configuration for these keys looks like this:

label: null
cmap: null
exhaustive_labels: false
dense: false
annotate: false
order: null
cols: null
display:
  n_pairs: true
  freq_margins: true