Saltar al contenido

Expresiones de repetición ​

Esta referencia abarca el reproductor nativo y los contadores y eventos personalizados en la página de análisis de repeticiones. No se aplica a reproductores de terceros. Los tres usan la sintaxis expr-eval, pero sus campos y requisitos de resultado varían.

Tres contextos ​

FuncionalidadReproductor de repeticionesContador de análisisEvento personalizado de análisis
UbicaciónContador personalizado en el diálogo del reproductor nativoContador numérico en la página de análisis; las pistas de datos utilizan sus resultadosFilas de eventos personalizados en la página de análisis
EntradaPropiedades de la repetición en la posición actual de reproducciónInstantáneas de eventos nativos y datos de repetición estáticosLos mismos campos que los contadores de análisis
Resultado finalConvertido a texto; se pueden concatenar números y cadenasDebe ser un número único; se permiten NaN y el infinito positivo/negativoDebe ser un valor booleano, número o cadena
EvaluaciónCuando se actualiza la posición de reproducciónEn muestras seleccionadas por el modo de muestreo de cada filaMuestreo continuo: el último evento nativo en cada milisegundo
Entre muestrasNo utiliza interpolación de muestras del analizadorInterpolación lineal en el tiempo; fuera del rango de muestras, mantiene el punto final más cercanoUtiliza los estados de ocurrencia muestreados, no los valores de verdad interpolados
Formato de visualizaciónUso de toFixed, roundTo o concatenación de cadenas dentro de la expresiónEntrada separada de formato d3-format, predeterminado .3fColores y estilos del marcador y la línea; sin formato numérico
ErroresMuestra el texto de errorMuestra el error en la celda de valorErrores de análisis o tipos de resultado inválidos significan que el evento no ocurre
Función de diferencia dNo se admiteSe admite; los eventos previos siguen el modo de muestreo de la filaSe admite; los eventos previos siguen el muestreo continuo

Los eventos personalizados usan la verdad nativa de JavaScript: true, números distintos de cero y cadenas no vacías indican ocurrencia; false, 0, -0, NaN y cadenas vacías indican ausencia de ocurrencia. El infinito positivo o negativo indica ocurrencia. Las cadenas "false", "0" y con solo espacios también indican ocurrencia. Otros tipos, incluyendo arrays y funciones, indican ausencia de ocurrencia.

El muestreo continuo incluye todos los tipos nativos de eventos y toma muestras cada milisegundo. Utiliza el último evento de ese milisegundo, o todos los campos del evento anterior más reciente cuando no hay evento, incluyendo time. La marca temporal de la muestra avanza, pero time mantiene el tiempo original del evento de origen. Los modos de botón de contador o de cambio de tablero filtran primero los eventos elegibles, luego conservan el último evento elegible en cada milisegundo sin rellenar los espacios vacíos. Las configuraciones de muestreo de fila de contador no afectan a los eventos personalizados.

La línea de tiempo y el tablero usan los mismos detalles al pasar el ratón sobre un evento: los pulsos muestran su tiempo y el resultado de la expresión numérico o de cadena, omitiendo los valores booleanos; los eventos sostenidos muestran su tiempo de inicio completo, tiempo de finalización y duración, incluso cuando el rango visible los recorta. Los tiempos se muestran en segundos con tres decimales.

La configuración del evento personalizado 'Tamaño del marcador del tablero' afecta únicamente a la capa del tablero. Los marcadores de la línea de tiempo permanecen en 8px y conservan la forma, color y opacidad del evento.

Nuevas configuraciones habilitan la capa de eventos personalizados con pluck seleccionado. Al pasar el ratón sobre un marcador de pulso, se muestra su tiempo y valor (omitidos los valores booleanos), o sobre una traza de evento sostenido para ver su tiempo de inicio completo, tiempo de finalización y duración, incluso cuando solo se muestra parte de la traza. Se conservan las configuraciones de capa guardadas.

Campos admitidos ​

«Sí» significa que el nombre está disponible directamente como variable en la expresión; «—» significa que no lo está. Los nombres son sensibles a mayúsculas y minúsculas. Los valores dinámicos del analizador provienen de eventos muestreados; los valores estáticos describen todo el replay. El jugador lee sus getters actuales sin sustituir 0. Los nombres fuera de estas tablas, incluyendo currentMs, current_time, timeMs y bvs, no están soportados. Las claves de filas de contador y las claves de eventos no son variables en otras expresiones.

Campos estáticos del tablero y del replay ​

CampoSignificado y unidadReproductor de repeticionesContador de análisisEvento personalizado
rowNúmero de filas del tableroSíSíSí
columnNúmero de columnas del tableroSíSíSí
mine_numTotal de minasSíSíSí
pix_sizeTamaño original de la celda en píxeles, no el tamaño mostradoSíSíSí
bbbv3BV del tablero completoSíSíSí
opNúmero total de aperturas del tableroSíSíSí
islNúmero de islas del tablero completoSíSíSí
cell0Número de celdas vacías (en blanco) en todo el tableroSíSíSí
cell1Número de celdas que muestran 1 en todo el tableroSíSíSí
cell2Número de celdas que muestran 2 en todo el tableroSíSíSí
cell3Número de celdas que muestran 3 en todo el tableroSíSíSí
cell4Número de celdas que muestran 4 en todo el tableroSíSíSí
cell5Número de celdas que muestran 5 en todo el tableroSíSíSí
cell6Número de celdas que muestran 6 en todo el tableroSíSíSí
cell7Número de celdas que muestran 7 en todo el tableroSíSíSí
cell8Número de celdas que muestran 8 en todo el tableroSíSíSí
ziniNúmero estimado de operaciones de marcado con algoritmo greedy (ZiNi)SíSíSí
hziniNúmero de operaciones después de abrir todas las aperturas primero, luego aplicar el algoritmo greedy (Human ZiNi)SíSíSí
rtimeDuración total del replay en segundos, no el progreso actual de reproducciónSíSíSí
levelCódigo de nivel de dificultad del replaySíSíSí
modeCódigo del modo de juego del replaySíSíSí

Las variables cell0 hasta cell8 son nueve variables separadas. cell0-8 no es un nombre de variable.

Campos dinámicos y exclusivos del jugador ​

CampoSignificado y unidadReproductor de repeticionesContador de análisisEvento personalizado
timeTiempo original del evento muestreado en segundos; puede ser negativo antes de que comience el temporizador del juego y difiere del progreso de reproducción de la página—SíSí
pathLongitud acumulada del recorrido del ratón, manteniendo el valor de la biblioteca independientemente del tamaño de la casilla mostradaSíSíSí
bbbv_solved3BV resueltos hasta ahoraSíSíSí
leftClicks izquierdos acumuladosSíSíSí
rightClicks derechos acumuladosSíSíSí
doubleDobles clics acumuladosSíSíSí
lceClicks efectivos izquierdos acumuladosSíSíSí
rceClicks efectivos derechos acumuladosSíSíSí
dceDobles clics efectivos acumuladosSíSíSí
flagCantidad de banderas colocadasSíSíSí
op_solvedCasillas abiertas hasta ahora—SíSí
isl_solvedIslas resueltas hasta ahora—SíSí
mouse_stateCódigo de estado del ratón; los analizadores usan el estado después del evento nativoSíSíSí
bbbv_s3BV por segundoSí——
ceTotal de clics efectivosSí——
ce_sClics efectivos por segundoSí——
clTotal de clicsSí——
cl_sClics por segundoSí——
left_sClics izquierdos por segundoSí——
right_sClics derechos por segundoSí——
double_sDobles clics por segundoSí——
flag_sTasa de colocación de banderasSí——
etimeTiempo estimado de finalización en segundosSí——
rtime_msDuración total de la repetición en milisegundosSí——
rqpMétrica de velocidad RQPSí——
stnbMétrica de finalización y velocidad STNBSí——
corrMétrica de precisión operativaSí——
thrpMétrica de eficiencia de throughputSí——
ioeÍndice de eficienciaSí——
pluckMétrica acumulada de PluckSíSíSí
current_event_idÍndice actual del array de eventos nativos, no un valor de tiempoSí——
game_board_stateCódigo de estado del tablero de juegoSí——
video_start_timeDesplazamiento de inicio de repetición en segundosSí——
video_end_timeCoordenada de finalización de repetición en segundosSí——

El analizador no expone directamente bbbv_s, cl o ce. Puedes combinar campos soportados, por ejemplo bbbv_solved / time, left + right + double o lce + rce + dce. Esas fórmulas no se garantizan que coincidan con los algoritmos de obtención del jugador en cada estado especial.

El analizador calcula el pluck por evento al cargar una repetición. Los valores brutos se conservan: los valores no disponibles pueden ser NaN, y el valor de fallo al tocar una mina es Number.MAX_VALUE, sin reemplazo por cero o infinito.

Códigos de estado del ratón ​

ValorEstadoSignificado
1UpUpAmbos botones izquierdo y derecho liberados
2UpDownSe suelta el botón izquierdo y se presiona el derecho
3UpDownNotFlagSe suelta el botón izquierdo y se presiona el derecho sin colocar ni quitar una bandera
4DownUpSe presiona el botón izquierdo y se suelta el derecho
5ChordingSe presionan ambos botones
6ChordingNotFlagSe presionan ambos botones después de presionar primero el derecho en una casilla que no puede ser clickeada con el botón derecho
7DownUpAfterChordingSe suelta primero el botón derecho después de una apertura simultánea, mientras el botón izquierdo sigue presionado
8UndefinedEstado no inicializado

Nombres como DownUp no son constantes de expresión. Usa sus códigos numéricos, por ejemplo mouse_state == 4.

Operadores y sintaxis ​

Todos los tres contextos soportan las siguientes operaciones, pero el resultado final del contador debe ser numérico. Los arrays, cadenas y valores booleanos pueden ser resultados intermedios. La tabla sigue aproximadamente el orden de precedencia de mayor a menor; usa paréntesis cuando no estés seguro.

Operador o sintaxisSignificado y ejemploReproductor de repeticionesContador de análisisEvento personalizado
(...)Agrupación, por ejemplo (left + right) / timeSíSíSí
f(...), a[i], x.yLlamada a función, índice cero basado y acceso a propiedades, por ejemplo [left, right][0] o [left, right].length; no evita la lista blanca de variablesSíSíSí
[a, b, ...], "text", 'text'Literales de array y cadenaSíSíSí
x!Factorial posfijo: 5! es 120, no la negación lógicaSíSíSí
x ^ yExponenciación: 2 ^ 3 es 8, no XORSíSíSí
+x, -x, not xConversión numérica, negación y negación lógica; las funciones matemáticas unarias se enumeran a continuaciónSíSíSí
*, /, %Multiplicación, división y móduloSíSíSí
+, -Adición y sustracción numéricas; el operador + no es concatenación de cadenasSíSíSí
x || yConcatenación de cadenas, o concatenación de arrays cuando ambos operandos son arrays; no es la operación lógica ORSíSíSí
==, !=, <, <=, >, >=Comparaciones, por ejemplo left > rightSíSíSí
x in aMiembro de array, por ejemplo mouse_state in [4, 5, 7]SíSíSí
x and yAND lógico; omite el operando derecho si el izquierdo es falsoSíSíSí
x or yOR lógico; omite el operando derecho si el izquierdo es verdaderoSíSíSí
c ? a : bExpresión condicional; solo evalúa la rama seleccionada; se permite anidaciónSíSíSí
a; bEvalúa secuencialmente y devuelve el último resultado; no es una declaración de variableSíSíSí
x = valueAsignaciónNoNoNo
f(x) = exprDefinición de funciónNoNoNo
if (...) { ... }, &&, !x, **, ===, =>Instrucciones o operadores de JavaScript o funciones de flecha; no pertenecen a esta gramática de expresionesNoNoNo

Usa las palabras clave and, or y not. Los resultados lógicos son booleanos; usa condition ? 1 : 0 para obtener un resultado numérico en un contador. Se admite notación científica como 1e-3. Prefiere paréntesis alrededor de los argumentos de funciones unarias, por ejemplo sin(time)^2, para evitar ambigüedades de precedencia.

Constantes ​

Constante o expresiónSignificadoTodos los tres contextos
PIPiSoportado
EEl número de EulerSoportado
true, falseBooleanosSoportados, pero no válidos como resultados finales del contador
0 / 0Produce NaNSoportados; se mantienen como números de contador, falso para eventos personalizados
1 / 0, -1 / 0Produce infinito positivo/negativoSoportados; se mantienen como números de contador, verdadero para eventos personalizados
NaN, Infinity, Inf, null, undefinedEstos nombres no son constantes integradasNo se admite

Funciones ​

La tabla lista funciones integradas, extensiones de aplicación y operadores unarios de función, junto con sus contextos soportados. x, a y f son lugares de argumento, no campos adicionales de repetición. Los ángulos están en radianes.

Usa toFixed en el jugador para conservar los ceros finales. Devuelve texto; roundTo sigue devolviendo un número. Las nuevas expresiones por defecto usan tres decimales. Las expresiones guardadas se conservan; reemplaza las llamadas a roundTo solo para visualización con toFixed según sea necesario. Los contadores del analizador continúan usando su campo de formato separado, como .3f.

FunciónSignificado y ejemploReproductor de repeticionesContador de análisisEvento personalizado
abs(x)Valor absoluto, por ejemplo abs(-3)SíSíSí
sign(x)Signo; los números negativos, cero o positivos normalmente producen -1, 0 o 1SíSíSí
ceil(x)Redondea hacia arribaSíSíSí
floor(x)Redondea hacia abajoSíSíSí
round(x)Redondea al entero más cercano usando las reglas de redondeo de JavaScriptSíSíSí
trunc(x)Elimina la parte fraccionaria hacia ceroSíSíSí
roundTo(x, n)Redondea a n decimales, por ejemplo roundTo(time, 3); n negativo redondea a decenas, centenas, etc.; no rellena ceros finalesSíSíSí
toFixed(x, n)Devuelve texto con decimales fijos, por ejemplo toFixed(3.4, 3) devuelve "3.400". Si n no se especifica, se usa 0; la precisión sigue las reglas de JavaScript Number.toFixed (0–100). Combina con ||SíNo; usa el campo de formato separadoNo
min(a, b, ...)Mínimo; también acepta un array, por ejemplo min([left, right])SíSíSí
max(a, b, ...)Máximo; también acepta un array, por ejemplo max([left, right])SíSíSí
sqrt(x)Raíz cuadradaSíSíSí
cbrt(x)Raíz cúbicaSíSíSí
pow(x, y)Exponenciación, equivalente a x ^ ySíSíSí
hypot(a, b, ...)Raíz cuadrada de la suma de los cuadrados de los argumentosSíSíSí
pyt(a, b, ...)Alias de hypotSíSíSí
exp(x)E ^ xSíSíSí
expm1(x)exp(x) - 1SíSíSí
ln(x)Logaritmo naturalSíSíSí
log(x)Alias de ln; no es de base 10SíSíSí
log2(x)Logaritmo en base 2SíSíSí
log10(x)Logaritmo en base 10SíSíSí
lg(x)Alias de log10SíSíSí
log1p(x)ln(1 + x)SíSíSí
sin(x)SenoSíSíSí
cos(x)CosenoSíSíSí
tan(x)TangenteSíSíSí
asin(x)ArcosenoSíSíSí
acos(x)ArcocosenoSíSíSí
atan(x)ArcotangenteSíSíSí
atan2(y, x)Ángulo de dirección del vector (x, y); y viene primeroSíSíSí
sinh(x)Seno hiperbólicoSíSíSí
cosh(x)Coseno hiperbólicoSíSíSí
tanh(x)Tangente hiperbólicaSíSíSí
asinh(x)Arcoseno hiperbólicoSíSíSí
acosh(x)Arcocoseno hiperbólicoSíSíSí
atanh(x)Arcotangente hiperbólicaSíSíSí
gamma(x)Función gamma; para un entero positivo n, gamma(n) = (n - 1)!SíSíSí
fac(x)Factorial, correspondiente a x!; para números no enteros se usa la extensión de GammaSíSíSí
random(n)Número aleatorio en [0, n); usa 1 si n no se especifica o es cero; no adecuado para análisis reproducibleSíSíSí
length(x)Longitud de cadena o arregloSíSíSí
indexOf(x, a)Índice cero inicial de la primera aparición de x en la cadena o arreglo a; -1 si no está presenteSíSíSí
join(sep, a)Une los elementos del arreglo en una cadena usando el separador sepSíSíSí
map(f, a)Aplica una función a los elementos del arreglo y devuelve un arreglo, por ejemplo map(abs, [-1, 2])SíSíSí
filter(f, a)Mantén los elementos cuyo resultado de la función sea verdadero; devuelve un arreglo, por ejemplo filter(abs, [-1, 0, 2])SíSíSí
fold(f, initial, a)Reduce un arreglo a un único valor, por ejemplo fold(pow, 2, [3, 2]) produce 64SíSíSí
if(c, a, b)Selecciona a o b según c, pero evalúa ambos argumentos primero; usa c ? a : b para cortocircuitoSíSíSí
not(x)Negación lógica, también escrita como not x; devuelve un booleanoSíSíSí
d(expr)Expresión numérica en la muestra actual menos su valor en la muestra anterior—SíSí
d(expr, n)Resta el valor n muestras antes; n debe ser un entero positivo—SíSí

Los argumentos de función para map, filter y fold pueden usar built-ins compatibles, no funciones de flecha de JavaScript ni definiciones de nuevas funciones. No existen funciones generales String, Number, isNaN, isFinite ni Math.*. Utiliza + para la conversión numérica, "" || value para la concatenación de texto y value != value para probar por NaN, reemplazando el valor por un campo o expresión real. d requiere una llamada directa y no puede utilizarse como callback de función de array.

Reglas de diferencia ​

ReglaExplicación
OperandoUn campo o expresión numérica, por ejemplo d(left), d(left + right) o d(bbbv_solved) / d(time)
Paso predeterminadod(expr) es igual a d(expr, 1); cuenta las muestras conservadas, no milisegundos ni el conteo nativo de eventos
Expresión de pason se evalúa en la muestra actual, por ejemplo d(left, time > 1 ? 2 : 1); pasos no positivos o no enteros son errores
Predecesores ausentesDevuelve NaN; los contadores los mantienen, los eventos personalizados los tratan como ausencia
Anidamientod(d(left)) y d(d(left, 2), 3) funcionan; sus primeras dos y cinco muestras respectivamente son NaN
Sin normalización automáticaNo divide por el paso ni por el tiempo transcurrido; divide explícitamente por d(time) para obtener una tasa
Orden de evaluaciónFiltrar y eliminar duplicados de muestras en milisegundos, luego evaluar diferencias; la interpolación y formato de contadores ocurren después
Ramificaciones condicionalesSaltar una llamada de diferencia no cambia cuál muestra es el predecesor

Contadores predeterminados ​

Al primer uso, los contadores utilizan muestreo continuo y el formato de visualización .3f:

claveExpresiónGráfico predeterminado
Bvsd(bbbv_solved, 1000) / d(time, 1000)Gráfico 1
Cesd(lce+rce+dce, 1000)/d(time, 1000)Gráfico 1
Movd(path, 1000) / d(time, 1000) / 16Gráfico 2

Aquí, 1000 conteos de muestras continuas en milisegundos; el denominador utiliza la diferencia del evento original en time. Los primeros 1000 muestras son NaN, y una diferencia de tiempo cero también puede producir valores no finitos. El valor en minúscula bvs ya no es un contador predeterminado. Se conservan las configuraciones de contador y gráfico guardadas.

Eventos personalizados predeterminados ​

Al primer uso, los siguientes eventos se incluyen:

claveTipoExpresión
leftSostenidomouse_state in [4, 5, 6, 7]
rightSostenidomouse_state in [2, 3, 5, 6]
pluckPulsod(pluck)

El pulso pluck ocurre cuando el valor acumulado cambia desde el millisecond anterior. Un valor no cambiado o una diferencia NaN no produce pulso. Se conservan los eventos personalizados guardados previamente.

Ejemplos ​

ContextoExpresiónResultado
Reproductor de repeticionestoFixed(bbbv_s, 3) || "@" || bbbv_solved || "/" || bbbvCombinar una tasa con tres decimales, resuelto BV y BV total como texto
Contador de análisistime > 0 ? bbbv_solved / time : 03BV/s acumulados; el formato separado puede ser .3f
Contador de análisisd(bbbv_solved) / d(time)3BV/s entre muestras; la primera muestra es NaN
Evento de pulso personalizadod(left) > 0Un pulso cuando aumentan los clics izquierdos acumulados
Evento personalizado sostenidomouse_state in [4, 5, 6, 7]Segmentos continuos donde se presiona el botón izquierdo
Evento personalizadomouse_state == 4 and d(left) > 0Requiere tanto un estado del ratón como un aumento de clic

Referencia de sintaxis: expr-eval. Formato de visualización separado para contadores: d3-format; el formato no es una función de expresión