توابع shadedErrorBar در MATLAB یک روش برای رسم نمودارهای خطی همراه با نوار خطای سایه‌دار پیوسته به جای استفاده از میله‌های خطا (error bars) گسسته است. این نوارهای خطا می‌توانند به صورت دستی مشخص شوند یا به صورت خودکار بر اساس تابع‌های از پیش تعریف‌شده محاسبه شوند. این ویژگی به شما اجازه می‌دهد که به راحتی نوار خطای اطراف داده‌ها را رسم کرده و ویژگی‌های مختلف آن را به راحتی تنظیم کنید.

ویژگی‌های کلیدی تابع shadedErrorBar

1. نوار خطای پیوسته: این تابع به جای میله‌های خطای معمولی، یک نوار خطای پیوسته بر روی خطوط داده رسم می‌کند که به صورت شفاف و با رنگ قابل تنظیم است. این نوار می‌تواند خطای هر نقطه از داده‌ها را نمایش دهد.

2. محاسبه خودکار نوار خطا: برای رسم نوار خطای هر نقطه، می‌توانید از توابع آماری استفاده کنید. به طور مثال، تابع می‌تواند به صورت خودکار میانگین و انحراف معیار داده‌ها را محاسبه کند و نوار خطا را بر اساس آن‌ها رسم کند.

3. شفافیت: برای اینکه نوار خطا شفاف باشد، باید ویژگی OpenGL فعال باشد. این ویژگی به شما اجازه می‌دهد که رنگ نوار خطا را تنظیم کرده و در مواردی که شفافیت مهم است، به خوبی از آن استفاده کنید.

4. امکان تنظیم رنگ‌ها و ظاهر نمودار: شما می‌توانید ویژگی‌های مختلف نمودار مثل رنگ، ضخامت خط و یا میزان اشباع (saturation) نوار خطا را تنظیم کنید. این تنظیمات به شما این امکان را می‌دهند که نمودار خود را به شکلی که می‌خواهید نمایش دهید.

نمونه‌هایی از استفاده‌های مختلف

1. رسم نمودار خطی با نوار خطا: در این مثال، داده‌ها با استفاده از توزیع نرمال تصادفی تولید می‌شوند و سپس نوار خطای میانگین و انحراف معیار به صورت خودکار محاسبه شده و بر روی نمودار رسم می‌شود.

   y = randn(30,80)*5;
   x = (1:size(y,2))-40;
   yP = sin(linspace(-2*pi,2*pi,length(x)))*20;
   y = bsxfun(@plus, y, yP) + 60;

   shadedErrorBar(x, y, {@mean, @std});
hold on
plot(x, y, '.', 'color', [0.5, 0.5, 0.95])
grid on 

   

2. رسم چندین خط با نوار خطای جداگانه: در این مثال، چندین خط با نوار خطای جداگانه رسم شده و روی هم قرار می‌گیرند. این امکان به شما داده می‌شود که چندین سری داده را در یک نمودار نمایش دهید.

   shadedErrorBar(x, y, {@mean, @std}, 'lineprops', '-b', 'patchSaturation', 0.33);
hold on
shadedErrorBar(x, 2*y + 20, {@mean, @std}, 'lineprops', {'-go', 'MarkerFaceColor', 'g'});

   

3. تغییر ویژگی‌های نمودار پس از رسم: پس از رسم نمودار، می‌توانید ویژگی‌های مختلف مثل رنگ و ضخامت خطوط و نوار خطا را به صورت داینامیک تغییر دهید.

   s = shadedErrorBar(x, y, {@mean, @std}, 'lineprops', '-r');
set(s.edge, 'LineWidth', 2, 'LineStyle', ':');
s.mainLine.LineWidth = 5;
s.patch.FaceColor = [0.5, 0.25, 0.25];

   

پیشرفت‌ها و تغییرات اخیر

• 15 نوامبر 2022: اضافه شدن قابلیت هدف‌گذاری به یک محور خاص.
• 8 نوامبر 2019: پشتیبانی از نرم‌افزار Octave.
• 24 نوامبر 2017: اضافه شدن پارامتر patchSaturation برای تنظیم میزان اشباع نوار خطا.
• 6 اوت 2017: تغییرات مختلفی در ورودی‌ها و بهبود عملکرد شفافیت.

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

برای استفاده از این تابع، شما باید داده‌های خود را آماده کرده و سپس تابع shadedErrorBar را فراخوانی کنید. این تابع به شما امکان می‌دهد که نوارهای خطای سایه‌دار را به راحتی در اطراف داده‌های خود اضافه کنید و نمودارهای پیچیده‌تری بسازید که اطلاعات بیشتری در مورد خطای داده‌ها ارائه دهند.

نتیجه‌گیری

تابع shadedErrorBar یک ابزار مفید در MATLAB است که به شما این امکان را می‌دهد که نوار خطای پیوسته و شفاف برای داده‌ها رسم کنید. این ویژگی به ویژه برای تجسم داده‌های تجربی یا علمی که دارای خطا هستند بسیار مفید است و می‌تواند به شما کمک کند تا به صورت واضح‌تری نواحی خطا را در نمودارهای خود نشان دهید.