Indicadores
Cree un indicador MT5: buffers, OnCalculate y recálculo confiable

Empiece con un valor que pueda explicar
Un indicador personalizado útil tiene un contrato preciso antes de tener colores atractivos. Nuestro ejemplo informa dónde se encuentra el cierre actual dentro del rango más alto al más bajo de las últimas N barras. Produce un número entre 0 y 100, o un valor vacío mientras la ventana está incompleta. No envía pedidos. Esto lo hace adecuado para aprender a calcular, mostrar y verificar como responsabilidades separadas.
Escriba el contrato explícitamente: use el símbolo del gráfico y el período de tiempo, incluya la barra que se está calculando, use máximos y mínimos en lugar de cierres para establecer el rango y devuelva 50 para una ventana plana. Un cierre fuera del rango alto-bajo de su propia barra es una entrada inconsistente para investigar, no una razón para bloquear silenciosamente la salida. Estas decisiones importan más que el nombre del indicador.
El cálculo es 100 × (cerca - mínimo más bajo) / (máximo más alto - mínimo más bajo). Este es un ejemplo didáctico de posición de rango, no una pretensión de reproducir el indicador estocástico suavizado. Si luego agregas suavizante, versiona la fórmula y sus requisitos de calentamiento.
Mantenga los contratos de cálculo y dibujo separados
Utilice un búfer de datos y un gráfico de líneas. El terminal posee el tamaño del búfer vinculado; su código proporciona valores. Elija explícitamente la indexación más antigua primero después del enlace y para las matrices de entrada utilizadas en el bucle. Entonces el índice i se refiere a la misma barra en máximo, mínimo y cierre. Evite mezclar esta convención con solicitudes CopyBuffer basadas en posición, donde la posición cero significa la barra actual.
Las primeras N−1 celdas no tienen una ventana completa. Deles EMPTY_VALUE y establezca la propiedad de valor vacío del gráfico en el mismo centinela. Cero es un resultado de posición de rango válido y no puede duplicarse como "no listo". PLOT_DRAW_BEGIN controla la presentación, pero la inicialización explícita de celdas no disponibles también hace que el contrato de datos sea más fácil de inspeccionar.
Los índices del búfer de indicador comienzan en cero, mientras que los sufijos de declaración como indicador_tipo1 se refieren al primer gráfico. Documente tanto el búfer de datos como el gráfico; no son identificadores intercambiables.
Una implementación de enseñanza completa
Cree un indicador personalizado en MetaEditor y utilice el siguiente ejemplo original como fuente. El código utiliza deliberadamente un escaneo O(N) transparente para cada barra recalculada. Es una implementación de referencia para inspeccionar y compilar en su terminal, no un paquete de entrega compilado ni una afirmación de referencia.
#property indicator_separate_window
#property indicator_buffers 1
#property indicator_plots 1
#property indicator_label1 "Range position"
#property indicator_type1 DRAW_LINE
#property indicator_color1 clrRoyalBlue
#property indicator_minimum 0
#property indicator_maximum 100
input int Period = 14;
double RangePosition[];
int OnInit()
{
if(Period < 2) return INIT_PARAMETERS_INCORRECT;
if(!SetIndexBuffer(0, RangePosition, INDICATOR_DATA))
return INIT_FAILED;
ArraySetAsSeries(RangePosition, false);
PlotIndexSetInteger(0, PLOT_DRAW_BEGIN, Period - 1);
PlotIndexSetDouble(0, PLOT_EMPTY_VALUE, EMPTY_VALUE);
IndicatorSetInteger(INDICATOR_DIGITS, 2);
return INIT_SUCCEEDED;
}
int OnCalculate(const int rates_total,
const int prev_calculated,
const datetime &time[],
const double &open[],
const double &high[],
const double &low[],
const double &close[],
const long &tick_volume[],
const long &volume[],
const int &spread[])
{
ArraySetAsSeries(high, false);
ArraySetAsSeries(low, false);
ArraySetAsSeries(close, false);
bool reset = (prev_calculated <= 0 || prev_calculated > rates_total);
if(reset) ArrayInitialize(RangePosition, EMPTY_VALUE);
if(rates_total < Period) return 0;
int start = reset ? Period - 1 : MathMax(Period - 1, prev_calculated - 1);
for(int i = start; i < rates_total; ++i)
{
double hi = high[i], lo = low[i];
for(int j = i - Period + 1; j < i; ++j)
{
hi = MathMax(hi, high[j]);
lo = MathMin(lo, low[j]);
}
RangePosition[i] = (hi == lo) ? 50.0 :
100.0 * (close[i] - lo) / (hi - lo);
}
return rates_total;
}
Comprenda los cuatro casos de recálculo
En la primera carga, calcule cada ventana completa. Durante otro tick de la misma barra, vuelva a calcular la última barra: su máximo, mínimo y cierre pueden cambiar. Cuando llegue una nueva barra, vuelva a calcular la última barra anterior y calcule la nueva. Cuando el terminal restablece prev_calculated después de un cambio en el historial, reconstruya el resultado en lugar de confiar en el prefijo anterior. La referencia de OnCalculate describe este comportamiento de reinicio.
La devolución de rate_total indica en la siguiente invocación cuánto se gestionó; no hace que la barra actual sea definitiva. Un consumidor que desea un valor de barra cerrada aún elige una marca de tiempo de cierre adecuada. Según este contrato, se espera que el último punto trazado se mueva durante una vela inacabada.
No optimice manteniendo solo un máximo máximo almacenado en caché a menos que también maneje la barra que lo suministró al salir de la ventana. Una cola monótona puede reducir el trabajo, pero luego el reinicio del historial, los máximos iguales y la revisión de la barra actual requieren un manejo explícito. Mantenga esta versión simple como oráculo numérico al introducir un algoritmo más rápido.
Verifique con un pequeño dispositivo numérico
Utilice N=3 y las primeras barras más antiguas. Sean máximos [12,13,14,15], mínimos [8,9,10,11] y cierres [10,12,13,11]. Las dos primeras salidas están vacías. En el índice 2, el rango es de 8 a 14 y el resultado es 83,333333. En el índice 3, la ventana avanza al rango de 9 a 15 y el resultado es 33,333333. Estos son ejemplos de aritmética sintética, no resultados de mercado.
Ahora cambie solo el último cierre de 11 a 14: solo debería cambiar la última salida, a 83,333333. Una ventana plana de tres barras con todos los precios iguales produce 50. Pruebe un período de entrada de 1 y confirme que la inicialización lo rechaza. Pruebe menos de tres barras y confirme que el indicador no expone ninguna señal cero fabricada.
Compare una pasada completa con pasadas incrementales sobre el mismo dispositivo. Luego anteponga barras más antiguas y fuerce un nuevo cálculo. Compare las salidas por marca de tiempo, teniendo en cuenta la región de calentamiento modificada. Una línea visualmente suave no es suficiente para establecer cualquiera de estas propiedades.
Diagnosticar un gráfico en blanco o engañoso
Si no aparece nada, verifique los resultados de la inicialización, las barras disponibles, el tipo de gráfico, la configuración de valores vacíos y los mensajes de Expertos/Diario. Utilice la ventana de datos para distinguir un valor válido oculto mediante estilo de una celda no calculada. Aquí es apropiada una escala fija de 0 a 100 porque el contrato tiene ese rango; ocultaría muchos indicadores denominados por precios.
Cuando agregue un lector EA más adelante, documente que el buffer 0 es una posición de rango numérico, no una señal de compra/venta. Registre la marca de tiempo de la barra seleccionada con cada valor. Una copia fallida debe seguir siendo una observación faltante. Esto evita que los errores de visualización, los problemas de preparación de los datos y las decisiones sobre las reglas comerciales se combinen en un informe vago de "el indicador no funciona".
Archivos de práctica
Estos archivos CSV contienen datos sintéticos de aprendizaje, no observaciones del mercado ni resultados de inversión.
El ejemplo MQ5 no se ha compilado ni ejecutado en MT5 como parte de este artículo.
















