toc

Leer el tiempo transcurrido de un cronómetro

Sintaxis

toc

toc(timerVal)

elapsedTime = toc

elapsedTime = toc(timerVal)

Descripción

toc lee el tiempo transcurrido desde que se inicia el cronómetro temporizador llamando a la función tic. MATLAB^® lee el tiempo interno al ejecutarse la función toc y muestra el tiempo transcurrido desde la llamada más reciente a la función tic sin una salida. El tiempo transcurrido se expresa en segundos.

toc(timerVal) muestra el tiempo transcurrido desde la llamada a la función tic correspondiente a timerVal.

elapsedTime = toc devuelve el tiempo transcurrido desde la llamada más reciente a la función tic.

elapsedTime = toc(timerVal) devuelve el tiempo transcurrido desde la llamada a la función tic correspondiente a timerVal.

Ejemplos

Medir el tiempo para crear matrices aleatorias

Mida el tiempo necesario para crear dos matrices aleatorias.

tic
A = rand(12000,4400);
B = rand(12000,4400);
toc

Elapsed time is 0.792104 seconds.

Medir múltiples intervalos a partir de una llamada a la función tic

Mida el tiempo transcurrido desde una llamada a la función tic en diferentes puntos del programa.

tic
A = rand(12000,4400);
B = rand(12000,4400);
toc

Elapsed time is 0.805452 seconds.

C = A.*B;
toc

Elapsed time is 0.883481 seconds.

Tomar medidas mediante múltiples llamadas a la función tic

Utilice un par de llamadas a la función tic y toc para informar del tiempo total necesario para una multiplicación de matrices elemento por elemento; utilice otro par para informar del tiempo de ejecución total del programa.

tStart = tic;           % pair 2: tic
n = 10;
T = zeros(1,n);
for i = 1:n
    A = rand(12000,4400);
    B = rand(12000,4400);
    tic         % pair 1: tic
    C = A.*B;
    T(i)= toc;  % pair 1: toc
end
tMul = sum(T)

tMul = 
0.3050

tEnd = toc(tStart)      % pair 2: toc

tEnd = 
7.9842

La variable tMul incluye el tiempo total empleado en multiplicar. tEnd especifica el tiempo transcurrido desde una llamada a la función tic al inicio del programa.

Argumentos de entrada

timerVal — Valor del temporizador interno

número entero sin signo de 8 bytes (64 bits)

Valor del temporizador interno guardado de una llamada anterior a la función tic, especificado como escalar de tipo uint64.

Sugerencias

• Las llamadas consecutivas a la función toc sin entrada devuelven el tiempo transcurrido desde la llamada más reciente a tic. Esta propiedad permite realizar múltiples mediciones a partir de un único punto en el tiempo.

  Las llamadas consecutivas a la función toc con la misma entrada timerVal devuelven el tiempo transcurrido desde la llamada a la función tic correspondiente a timerVal.

• En ocasiones, el programa se ejecuta demasiado rápido para que tic y toc proporcionen datos útiles. Si el código es más rápido que 1/10 segundo, plantéese medirlo ejecutando un bucle y, después, realice la media para obtener el tiempo de una sola ejecución. Para obtener más información, consulte Medir el rendimiento del código.

• Las siguientes acciones pueden provocar salidas inesperadas:

  • Utilizar tic y toc para cronometrar timeit.
  • Utilizar tic y toc dentro de una función cronometrada por timeit.

Capacidades ampliadas

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• El tipo de datos devuelto desde toc es diferente entre MATLAB y el código generado. Para evitar errores, no utilice un valor de salida toc de una función MEX en MATLAB o un valor de salida toc de MATLAB en una función MEX.

• Si llama a tic en una sesión de MATLAB y a toc en una función MEX, o viceversa, los resultados de tiempo no estarán coordinados.

• La implementación de C/C++ para toc en el código generado varía en función de la configuración del dispositivo de hardware almacenada en el objeto de configuración de la generación de código. De forma predeterminada, la configuración del dispositivo de hardware se realiza para la plataforma del host, con Hardware Board en la app MATLABCoder™ establecido en MATLAB Host Computer.

  • Cuando se genera código en Windows^® con una configuración del dispositivo de hardware compatible con Windows, la implementación de C/C++ generada utiliza las funciones de la API de Windows QueryPerformanceFrequency y QueryPerformanceCounter.

  • En el resto de casos, la implementación utiliza clock_gettime de la API POSIX. Cuando se compila código que utiliza la API POSIX, la macro del preprocesador _POSIX_C_SOURCE debe establecerse en un entero mayor que o igual a 199309L. El generador de código establece la macro en 199309L para la compilación.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en un entorno basado en subprocesos.

Historial de versiones

Introducido antes de R2006a

Consulte también

cputime | profile | tic | timeit

Temas

• Medir el rendimiento del código