این یک توضیح در مورد استفاده از تابع suplabel در MATLAB است که به شما این امکان را می‌دهد تا متن را به‌عنوان عنوان، برچسب محور x (xlabel) یا برچسب محور y (ylabel) روی گروهی از زیرنمودارها (subplots) قرار دهید. این تابع همچنین یک شناسه (handle) برای برچسب و یک شناسه برای محور (axis) مربوطه باز می‌گرداند.

نحوه استفاده از تابع suplabel:

1. استفاده ساده: در ساده‌ترین حالت، تابع suplabel به این صورت استفاده می‌شود:

   [ax,h] = suplabel(text, whichLabel, supAxes)


   این کد متن مورد نظر را به‌عنوان عنوان، برچسب محور x یا برچسب محور y روی گروهی از زیرنمودارها قرار می‌دهد و همچنین شناسه‌هایی برای هر دو محور و برچسب برمی‌گرداند.

2. ورودی‌های تابع:

   • text: متن مورد نظر برای عنوان یا برچسب.
   • whichLabel: نوع برچسب یا عنوان که می‌خواهید قرار دهید. این ورودی می‌تواند یکی از مقادیر 'x' (برای xlabel)، 'y' (برای ylabel) یا 't' (برای title) باشد.
   • supAxes: این ورودی اختیاری است و موقعیت “محور فوقانی” اطراف زیرنمودارها را مشخص می‌کند. این مقدار به صورت یک بردار [x, y, عرض، ارتفاع] داده می‌شود که موقعیت و اندازه محور فوقانی را تعیین می‌کند. اگر supAxes مشخص نشود، مقدار پیش‌فرض [.075 .075 .85 .85] است.

3. نمونه کد: فرض کنید که چند زیرنمودار (subplot) دارید و می‌خواهید برچسب‌ها و عناوین مختلف را روی آن‌ها قرار دهید:

   subplot(2,2,1); ylabel('ylabel1'); title('title1')
   subplot(2,2,2); ylabel('ylabel2'); title('title2')
   subplot(2,2,3); ylabel('ylabel3'); xlabel('xlabel3')
   subplot(2,2,4); ylabel('ylabel4'); xlabel('xlabel4')

   [ax,h1] = suplabel('super X label');
   [ax,h2] = suplabel('super Y label','y');
   [ax,h3] = suplabel('super Title','t');
   set(h3, 'FontSize', 30)
   

   در این کد، ابتدا چهار زیرنمودار با عنوان‌ها و برچسب‌های مختلف ایجاد می‌شود. سپس از تابع suplabel برای اضافه کردن یک برچسب در سطح کل زیرنمودارها استفاده می‌شود. در اینجا، suplabel('super X label') برچسبی برای محور X در سطح بالاتر از تمام زیرنمودارها ایجاد می‌کند، و suplabel('super Y label', 'y') و suplabel('super Title', 't') به ترتیب برای برچسب Y و عنوان اصلی استفاده می‌شوند. در نهایت، اندازه قلم عنوان بزرگ‌تر می‌شود.

بازگشت شناسه‌ها:

• ax: شناسه محور (axis) باز می‌گردد که به‌طور کلی برای انجام تنظیمات اضافی روی محور استفاده می‌شود.
• h: شناسه برچسب (label) باز می‌گردد که به‌طور مستقیم به تنظیمات مربوط به فونت، اندازه یا رنگ متن مربوط می‌شود.

کاربردهای رایج:

• عنوان‌های مشترک: در صورتی که شما بخواهید عنوان یا برچسبی را به‌طور مشترک برای تمامی زیرنمودارها (subplots) اضافه کنید، از این تابع استفاده می‌شود. این به شما کمک می‌کند تا به‌طور کارآمدتر با نمودارهای متعدد کار کنید و فضای بیشتری برای نمایش محتوا فراهم آورید.
• پیشنهاد بهبود طراحی: این روش به‌ویژه زمانی مفید است که شما بخواهید تمامی زیرنمودارها را در یک صفحه نمایش دهید و به‌طور متمرکز عنوان یا برچسبی را به آن‌ها نسبت دهید.

نکات مهم:

• انتخاب نوع برچسب: انتخاب نوع برچسب ('x' برای xlabel، 'y' برای ylabel و 't' برای title) به شما این امکان را می‌دهد که بدون نیاز به تنظیمات پیچیده، برچسب مناسب را برای گروهی از زیرنمودارها انتخاب کنید.
• هماهنگی اندازه‌ها: استفاده از ورودی supAxes به شما این امکان را می‌دهد که موقعیت و اندازه محورهای فوقانی را برای جلوگیری از برش یا همپوشانی برچسب‌ها با زیرنمودارها تنظیم کنید.

این تابع به شما کمک می‌کند تا کار با چندین نمودار و زیرنمودار را ساده‌تر و منظم‌تر انجام دهید، به‌ویژه زمانی که نیاز به افزودن عنوان یا برچسب‌های مشترک به همه یا برخی از زیرنمودارها دارید.