Skip to content

matlab/matlab-agentic-toolkit / skills-catalog/ai-and-statistics/matlab-classify-tabular-data

matlab-classify-tabular-data

Unverified

Use this skill to classify tabular data end-to-end in MATLAB — load a dataset, prepare and clean it, select promising classifiers, train them, and compare accuracies with cross-validation, holdout, or hyperparameter optimization plus statistical tests. TRIGGER when: user asks to classify tabular data, pick classifiers for a dataset, compare classifier accuracy, run cross-validation or a holdout evaluation, or find the best model with statistical uncertainty. DO NOT TRIGGER when: user has non-tabular inputs (images, sequences, time series), wants a regression model, is training a specific neural network architecture (use matlab-train-network), or wants cost-sensitive learning or an arbitrary class-prior vector (this skill only supports the built-in uniform-prior toggle for imbalanced data).

FileKindSize
SKILL.mdskill md36.1 KB
manifest.yamlconfig524 B
references/README.mdmarkdown3.1 KB
references/dataprep.mdmarkdown7.5 KB
references/hpo.mdmarkdown11.5 KB
references/save-and-export.mdmarkdown7.0 KB
references/select-classifiers-imbalanced.mdmarkdown3.0 KB
references/select-classifiers.mdmarkdown9.4 KB
scripts/README.mdmarkdown2.3 KB
scripts/helpers/aggregate_nested_cv_loss.mother470 B
scripts/helpers/apply_preproc.mother4.1 KB
scripts/helpers/build_model_definitions.mother16.6 KB
scripts/helpers/compute_data_flags.mother2.8 KB
scripts/helpers/compute_pairwise_pvalues_cv.mother623 B
scripts/helpers/compute_pairwise_pvalues_holdout.mother556 B
scripts/helpers/count_categorical_levels.pbinary376 B
scripts/helpers/export_workflow_script.mother15.2 KB
scripts/helpers/find_zero_variance_columns.mother810 B
scripts/helpers/is_bag_of_tokens.mother181 B
scripts/helpers/make_holdout_split.mother387 B
scripts/helpers/plot_accuracy_bars.mother994 B
scripts/helpers/plot_boosting_curve.mother1.2 KB
scripts/helpers/plot_pvalue_heatmap.mother465 B
scripts/helpers/plot_training_time.mother797 B
scripts/helpers/resolve_recipe.mother1.1 KB
scripts/helpers/resume_boosting_cv.mother543 B
scripts/helpers/resume_boosting_holdout.mother448 B
scripts/helpers/retrain_with_hpo.mother2.7 KB
scripts/helpers/retrain_with_resume.mother2.5 KB
scripts/helpers/sanitize_model_name.mother799 B
scripts/helpers/save_selected_models.mother4.0 KB
scripts/helpers/score_holdout_test.mother278 B
scripts/helpers/stratified_subsample.pbinary367 B
scripts/helpers/train_and_score_cv.mother405 B
scripts/helpers/train_and_score_holdout.mother1.1 KB
scripts/model_catalog/branch_categorical.mother4.2 KB
scripts/model_catalog/branch_many_missing.mother3.1 KB
scripts/model_catalog/branch_regular.mother4.1 KB
scripts/model_catalog/branch_sparse.mother1.3 KB
scripts/model_catalog/branch_wide.mother2.0 KB
scripts/model_catalog/classifier_branches.mother2.2 KB
scripts/model_catalog/classifier_thresholds.mother2.2 KB
scripts/model_catalog/imbalanced_boosting.mother3.0 KB
scripts/model_catalog/model_recipe.mother3.5 KB

scripts/helpers/save_selected_models.m

View on GitHub
function savedPath = save_selected_models(selectedNames, modelDefs, trainedModels, X, Y, savePath, metadata, useCompact)
% SAVE_SELECTED_MODELS  Save user-selected trained classifiers to a .mat file.
%
%   SAVE_SELECTED_MODELS(NAMES, MODELDEFS, TRAINED, X, Y, PATH, META, USECOMPACT)
%   writes a MAT file at PATH containing one variable per selected model
%   plus a scalar METADATA struct with dataset-shape and workflow context.
%
%   Inputs:
%       selectedNames  cellstr — subset of {modelDefs.name}
%       modelDefs      struct array from build_model_definitions (must
%                        include .fitFcn for the CV path)
%       trainedModels  cell array aligned with modelDefs. On the HOLDOUT
%                        path each cell holds a trained model returned by
%                        train_and_score_holdout. On the CV path each cell
%                        holds the cross-validated model returned by
%                        train_and_score_cv (a CV wrapper — NOT deployable);
%                        the helper detects this and RETRAINS on (X, Y)
%                        via modelDefs(k).fitFcn to produce a deployable
%                        single model before saving.
%       X, Y           full training data (CV path) OR training subset
%                        (holdout path). Only used when a CV-wrapped model
%                        must be retrained.
%       savePath       full path to the output .mat file
%       metadata       scalar struct — free-form context to store alongside
%                        the models (e.g., dataset name, evaluation path,
%                        accuracies, CI). At minimum should carry .savedAt.
%       useCompact     scalar logical (default true). When true, models
%                        that support compact() are compacted before save;
%                        models without a compact method are saved as-is.
%                        Compact models drop the training data reference,
%                        producing a much smaller .mat file suitable for
%                        deployment but no longer capable of resubstitution
%                        loss or CV.
%
%   Output:
%       savedPath      the actual path the file was written to (same as
%                        the input, but returned for logging).
%
%   Model variable names are sanitized: hyphens and other non-identifier
%   characters in modelDefs(k).name become underscores so save() and
%   subsequent load() work. The original name is preserved in
%   metadata.modelNameMap.

    arguments
        selectedNames (1,:) cell
        modelDefs (1,:) struct
        trainedModels (1,:) cell
        X
        Y
        savePath (1,:) char
        metadata (1,1) struct
        useCompact (1,1) logical = true
    end

    allNames = {modelDefs.name};
    saveStruct = struct();
    nameMap = struct();

    for k = 1:numel(selectedNames)
        name = selectedNames{k};
        idx = find(strcmp(allNames, name), 1);
        if isempty(idx)
            error('save_selected_models:unknownModel', ...
                'Model "%s" is not in modelDefs.', name);
        end
        mdl = trainedModels{idx};
        if is_cv_wrapper(mdl)
            mdl = modelDefs(idx).fitFcn(X, Y);
        end
        if useCompact && ismethod(mdl, 'compact')
            mdl = compact(mdl);
        end
        varName = sanitize_model_name(name);
        saveStruct.(varName) = mdl;
        nameMap.(varName) = name;
    end

    metadata.savedAt = datetime('now');
    metadata.useCompact = useCompact;
    metadata.modelNameMap = nameMap;
    saveStruct.metadata = metadata;

    saveDir = fileparts(savePath);
    if ~isempty(saveDir) && ~isfolder(saveDir)
        mkdir(saveDir);
    end
    save(savePath, '-struct', 'saveStruct');
    savedPath = savePath;
end

% -------------------------------------------------------------------------
function tf = is_cv_wrapper(mdl)
% CV-partitioned classification models expose kfoldLoss. Deployable
% single models do not.
    tf = ismethod(mdl, 'kfoldLoss');
end

% Copyright 2026 The MathWorks, Inc.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 319kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 319kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 319kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 196kUpdated Claude CodeCodexVerifiedInstall