---
name: autocorrelation
kind: function
lang: py
domain: datascience
version: "1.0.0"
purity: pure
signature: "def autocorrelation(data: list, lag: int) -> float"
description: "Calcula la autocorrelacion de una serie temporal para un lag dado."
tags: [statistics, timeseries, correlation, python, pendiente-usar]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: ""
imports: []
params:
  - name: data
    desc: "lista de valores numericos de una serie temporal (ej: precios diarios, cantidades de eventos)"
  - name: lag
    desc: "numero de periodos para desplazar (ej: 1 para autocorrelacion con el valor anterior). Debe ser positivo."
output: "coeficiente de autocorrelacion normalizado en rango [-1, 1]. 1.0=correlacion perfecta, 0.0=sin correlacion"
tested: false
tests: []
test_file_path: ""
file_path: "python/functions/datascience/datascience.py"
---

## Ejemplo

```python
autocorrelation([1, 2, 3, 4, 5, 4, 3, 2, 1], 1)
# ~0.489
```

## Notas

Autocorrelacion normalizada por la varianza. Retorna 0.0 si lag es invalido o la varianza es cero.
