توابع HERRORBAR برای رسم نمودار با خطای افقی (Horizontal Error Bars) در MATLAB استفاده می‌شود. این تابع امکان اضافه کردن خطوط خطای افقی به نمودارهای داده‌ها را فراهم می‌کند تا دقت یا عدم اطمینان در اندازه‌گیری‌ها یا محاسبات نشان داده شود. این ابزار معمولاً در گرافیک‌های علمی و مهندسی برای نمایش تغییرات و دامنه‌های احتمالی داده‌ها کاربرد دارد.

توضیحات و نحوه عملکرد:

1. نحوه استفاده:

   • تابع HERRORBAR(X, Y, L, R): این ورژن از تابع HERRORBAR داده‌ها را در قالب دو وکتور X و Y می‌کشد. در اینجا X نمایانگر محور افقی (محور x) و Y نمایانگر محور عمودی (محور y) است. L و R به ترتیب نمایانگر خطای سمت چپ و سمت راست برای هر نقطه در X هستند. این خطوط خطا به اندازه L(i) به سمت چپ و R(i) به سمت راست هر نقطه در (X, Y) افزوده می‌شود. در این حالت، طول خطا برابر با مجموع مقادیر L(i) و R(i) است.

   • HERRORBAR(X, Y, E) یا HERRORBAR(Y, E): این نسخه تابع HERRORBAR به سادگی خطوط خطا را با استفاده از یک بردار E (که معمولاً به معنای خطای استاندارد یا عدم اطمینان است) به داده‌ها اضافه می‌کند. به این ترتیب، X-E و X+E یا Y-E و Y+E برای نقاط مختلف گراف رسم می‌شود.

   • HERRORBAR(…, ‘LineSpec’): این ورژن از تابع به شما امکان می‌دهد تا رنگ و نوع خط برای نمودار را از طریق رشته‌ای به نام 'LineSpec' تنظیم کنید. به این ترتیب می‌توانید ظاهر نمودار را مطابق با نیازهای خود سفارشی کنید.

2. توضیحات اضافی:

   • خطای افقی (Horizontal Error Bars) معمولاً برای نمایش عدم دقت در اندازه‌گیری‌های افقی استفاده می‌شود. به عنوان مثال، در آزمایش‌های علمی یا اندازه‌گیری‌های فنی، ممکن است برخی از اندازه‌گیری‌ها با دقت کمتر در محور افقی انجام شوند. به کمک این خطوط خطا، می‌توان نواحی غیرقطعی و عدم اطمینان را به صورت بصری در نمودارها نمایش داد.

   • تفاوت در نوع داده‌ها: اگر X، Y، L و R همگی ماتریس باشند، در این صورت هر ستون از ماتریس‌ها یک خط جداگانه ایجاد خواهد کرد. این ویژگی برای زمانی که بخواهید چندین مجموعه داده را در یک نمودار با خطاهای افقی مختلف نمایش دهید، مفید است.

3. مثال کاربردی: در مثال زیر، از تابع HERRORBAR برای رسم یک گراف استفاده می‌شود که دارای خطاهای افقی است:

   x = 1:10;
y = sin(x);
e = std(y)*ones(size(x));
herrorbar(x, y, e)


   در این مثال، مقادیر x از 1 تا 10 است، و y تابع سینوس از این مقادیر است. خطاهای افقی برای هر نقطه با استفاده از انحراف معیار y ایجاد شده است.

4. تاریخچه: کد اصلی تابع HERRORBAR ابتدا توسط نویسنده آن در گروه خبری comp.soft-sys.matlab منتشر شد. در سال 2003، گرگ آلئو از The MathWorks این کد را به دست آورد و آن را در File Exchange قرار داد تا دیگران بتوانند از آن بهره ببرند. در سال 2006، نویسنده با گرگ آلئو تماس گرفت و تصمیم گرفتند که مالکیت کد به نویسنده اصلی بازگردد.

نتیجه‌گیری:

تابع HERRORBAR ابزار مفیدی برای نمایش عدم اطمینان یا خطا در داده‌ها به‌ویژه در نمودارهایی است که شامل داده‌های تجربی یا آزمایشگاهی هستند. استفاده از این تابع در MATLAB به کاربران این امکان را می‌دهد که گراف‌هایی با دقت بیشتر و شفافیت بیشتر برای نمایش نوسانات و انحرافات داده‌ها ایجاد کنند.