Trong các ứng dụng kỹ thuật và nghiên cứu khoa học, việc tự động hóa quy trình tạo tiêu đề biểu đồ không chỉ nâng cao tính nhất quán mà còn đảm bảo khả năng tái lập và tuân thủ chuẩn. Hàm normalize_plot_title được thiết kế để chuyển đổi chuỗi đầu vào thô — dù là tên file, mô tả từ script mô phỏng hay chuỗi do người dùng nhập — thành tiêu đề hiển thị chuyên nghiệp, an toàn khi lưu trữ và tương thích đa nền tảng.

Khởi đầu đơn giản, nhưng nhu cầu phức tạp

MATLAB cung cấp hàm title() cơ bản:

plot(linspace(0, 2*pi, 100), sin(linspace(0, 2*pi, 100)));
title('Biểu đồ Sin')

Tuy nhiên, trong môi trường sản xuất thực tế, tiêu đề thường mang thông tin ngữ nghĩa phong phú: mã thí nghiệm, thông số cấu hình, thời gian chạy, hoặc ký hiệu toán học. Ví dụ:

title('Tốc độ gió (m/s) – Thí nghiệm_2025_v3 [SNR=18dB]');

Chuỗi trên chứa ký tự không hợp lệ cho tên file ([, ], /), dấu gạch ngang dư thừa, và định dạng viết hoa không đồng nhất — gây khó khăn khi xuất ảnh tự động hoặc tích hợp vào hệ thống báo cáo.

Giải pháp: Hàm chuẩn hóa tiêu đề đa tầng

Hàm normalize_plot_title áp dụng chuỗi xử lý tuần tự gồm 4 giai đoạn chính:

1. Làm sạch khoảng trắng: Loại bỏ khoảng trắng đầu/cuối, thay thế tab (\t), xuống dòng (\n) bằng dấu cách, sau đó nén nhiều dấu cách liên tiếp thành một.
2. Thay thế ký tự đặc biệt: Ánh xạ ký tự không an toàn (như :, *, ?, <, >) sang ký tự thay thế hoặc loại bỏ hoàn toàn theo bảng cấu hình.
3. Viết hoa theo kiểu tiêu đề (Title Case): Chuyển chữ cái đầu mỗi từ thành in hoa, nhưng giữ nguyên các từ ngoại lệ như MATLAB, API, GPU nhờ cơ chế danh sách trắng.
4. Bổ sung tiền tố/hậu tố tùy chọn: Tự động chèn dấu thời gian, phiên bản phần mềm hoặc nhãn trạng thái dựa trên tham số truyền vào.

Dưới đây là ví dụ minh họa hành vi của hàm:

Cách sử dụng linh hoạt

Hàm hỗ trợ cả gọi đơn giản và cấu hình nâng cao qua cặp khóa–giá trị:

% Gọi cơ bản
cleaned = normalize_plot_title('  velocity_field_2024-12-03  ');

% Gọi có tùy chọn
cleaned = normalize_plot_title(...
    'Results: Run #3 [Phase 2]', ...
    'PreserveAcronyms', true, ...
    'TimestampPrefix', true, ...
    'TimeFormat', 'yyyy-mm-dd HH:MM', ...
    'ReplaceMap', containers.Map({':', '*', '?'}, {'_', 'x', ''}));

% Kết hợp với title() để vẽ biểu đồ
figure;
plot(rand(100,1));
title(cleaned, 'FontSize', 13, 'FontWeight', 'bold');

Cấu trúc nội bộ tối ưu

Phần lõi xử lý viết hoa được thiết kế theo mô hình "bảo vệ–chuyển đổi–khôi phục" nhằm tránh sai sót ngữ nghĩa:

function out = apply_title_case(str)
    exceptions = ["MATLAB", "API", "IoT", "GPU", "CPU"];
    placeholders = compose("EXC_%d", 1:numel(exceptions));
    
    % Bước 1: Thay thế từ ngoại lệ bằng placeholder
    temp = str;
    for k = 1:numel(exceptions)
        temp = regexprep(temp, ['\b' exceptions{k} '\b'], placeholders{k}, 'ignorecase');
    end
    
    % Bước 2: Viết hoa từng từ (không ảnh hưởng placeholder)
    temp = regexprep(temp, '\b([a-zA-Z])([a-zA-Z]*)', '${upper($1)}${lower($2)}');
    
    % Bước 3: Khôi phục từ ngoại lệ
    for k = 1:numel(exceptions)
        temp = strrep(temp, placeholders{k}, exceptions{k});
    end
    out = temp;
end

Hỗ trợ cấu hình bên ngoài

Để tăng khả năng mở rộng và triển khai trong môi trường CI/CD, hàm đọc cấu hình từ file JSON:

% title_config.json
{
  "enable_timestamp": true,
  "timestamp_format": "yyyy-mm-dd",
  "preserve_acronyms": true,
  "illegal_char_replacements": {
    ":": "_",
    "*": "x",
    "?": "",
    "<": "[",
    ">": "]"
  }
}

Khi gọi hàm, bạn có thể truyền đường dẫn tới file cấu hình hoặc để mặc định tìm trong thư mục hiện hành.

Đảm bảo độ tin cậy qua kiểm thử đơn vị

Hàm đi kèm bộ kiểm thử đầy đủ sử dụng framework matlab.unittest:

classdef TestNormalizeTitle < matlab.unittest.TestCase
    methods (Test)
        function testEmptyInput(testCase)
            testCase.verifyEqual(normalize_plot_title(''), '');
        end
        
        function testMixedWhitespace(testCase)
            testCase.verifyEqual(normalize_plot_title('  a   b\tc\n'), 'A B C');
        end
        
        function testAcronymPreservation(testCase)
            testCase.verifyEqual(normalize_plot_title('gpu usage api call'), 'GPU Usage API Call');
        end
    end
end

Ứng dụng thực tiễn

Một hệ thống giám sát khí tượng tự động sử dụng hàm này để sinh tiêu đề cho hàng trăm biểu đồ mỗi ngày:

for month = 1:12
    data = load(fullfile(data_root, sprintf('temp_month_%02d.mat', month)));
    figure('Visible', 'off');
    plot(data.dates, data.values);
    
    raw_desc = sprintf('Nhiệt độ trung bình tháng %d - %s', month, site_name);
    final_title = normalize_plot_title(raw_desc, 'TimestampPrefix', true);
    
    title(final_title);
    filename = regexprep(final_title, '[^a-zA-Z0-9_\- ]+', '_') + '.png';
    exportgraphics(gcf, fullfile(output_dir, filename));
    close(gcf);
end

Kết quả: Tất cả ảnh được đặt tên rõ ràng, dễ tra cứu, đồng thời tiêu đề hiển thị trên biểu đồ luôn đạt chuẩn báo cáo kỹ thuật — không cần can thiệp thủ công.

Hướng phát triển tương lai

• Tích hợp NLP nhẹ: Dự đoán tiêu đề gợi ý từ metadata của tập dữ liệu (ví dụ: tên biến NetCDF, đơn vị đo).
• Giao diện cấu hình trực quan: Xây dựng App Designer để người dùng không chuyên có thể tùy chỉnh quy tắc qua form đồ họa.
• Dịch vụ RESTful: Đóng gói hàm thành API qua MATLAB Production Server, cho phép gọi từ Python, Node.js hoặc hệ thống web.