%% –––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
% UTN - FRH
% FUNCIÓN DE MOVIMIENTO RECTILÍNEO UNIFORMEMENTE VARIADO (MRUV)
% –––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––

function [x, v] = MRUV(xi, vi, a, ti, tf)

%% Notas aclaratorias
% Esta función calcula la posición y la velocidad de una partícula
% bajo movimiento rectilíneo uniformemente variado (MRUV).
%
% Se basa en las ecuaciones cinemáticas clásicas para aceleración constante.
%
% Entradas:
% xi - Posición inicial [m]
% vi - Velocidad inicial [m/s]
% a  - Aceleración [m/s^2]
% ti - Tiempo inicial [s]
% tf - Tiempo final [s]
%
% Salidas:
% x  - Posición en el instante final [m]
% v  - Velocidad en el instante final [m/s]
%
% Funciones utilizadas: Ninguna

%% Validación de datos de entrada
arguments
    xi {mustBeNumeric, mustBeFinite}
    vi {mustBeNumeric, mustBeFinite}
    a  {mustBeNumeric, mustBeFinite}
    ti {mustBeNumeric, mustBeFinite, mustBeNonnegative}
    tf {mustBeNumeric, mustBeFinite, mustBeNonnegative}
end

%% Cálculo del movimiento (MRUV)
dt = tf - ti;

x = xi + vi*dt + 0.5*a*dt^2;
v = vi + a*dt;

end