...
Eroare Python pentru analiza datelor · NumPy: forme și tipuri

OverflowError: Python integer 300 out of bounds for uint8

Pe scurt

Array-ul (sau coloana) are un tip întreg mic, de exemplu uint8 (0-255) sau int8 (-128-127), iar numărul pe care îl adaugi sau îl pui în el nu încape. Convertește întâi la un tip mai mare: astype(np.int64) sau astype("int64").

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Tipurile întregi NumPy au limite fixe: uint8 ține 0-255 (folosit la pixelii imaginilor), int8 ține -128-127, int16 până la 32767. Din NumPy 2, când combini un array de tip mic cu un număr Python care nu încape în acel tip (a + 300, a[0] = 300, np.array([300], dtype=np.uint8)), NumPy dă eroare în loc să ajusteze în tăcere rezultatul.

În pandas apare des după optimizări de memorie: pd.to_numeric(..., downcast="integer") sau astype("int8") alege tipul cel mai mic posibil, iar un calcul ulterior iese din limite.

Atenție: operațiile între două array-uri de tip mic nu dau eroare, ci „se dau peste cap” (200 + 100 în uint8 dă 44). Pentru calcule, convertește întâi la int64.

De ce apare: cauzele frecvente

1Coloană micșorată cu downcast

Greșit
PYTHON
s = pd.to_numeric(df["puncte"], downcast="integer")  # int8
s = s + 200
Corect
PYTHON
s = pd.to_numeric(df["puncte"]).astype("int64")
s = s + 200

int64 ține numere până la aproximativ 9 trilioane, deci adunarea încape.

2Valoare prea mare pusă într-un array uint8

Greșit
PYTHON
pixeli = np.array([10, 200, 250], dtype=np.uint8)
pixeli[0] = 300
Corect
PYTHON
pixeli = np.array([10, 200, 250], dtype=np.uint8)
pixeli[0] = 255

La imagini, valorile peste 255 nu au sens: le limitezi la 255.

3Luminozitate crescută la o imagine

Greșit
PYTHON
mai_luminos = pixeli + 300
Corect
PYTHON
mai_luminos = np.clip(pixeli.astype(np.int16) + 300, 0, 255).astype(np.uint8)

Calculul se face într-un tip mai mare, apoi np.clip limitează la 0-255 și revii la uint8.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos micșorează coloana de puncte cu downcast (tipul devine int8), apoi adaugă un bonus de 200 de puncte și dă OverflowError: Python integer 200 out of bounds for int8. Repară-l ca să afișeze punctele cu bonus și totalul lor.

Codul care dă eroarea
PYTHON
import pandas as pd

df = pd.DataFrame({"client": ["Ana", "Dan", "Ioana"], "puncte": ["10", "20", "30"]})

puncte = pd.to_numeric(df["puncte"], downcast="integer")
cu_bonus = puncte + 200
print(cu_bonus.tolist())
print(cu_bonus.sum())
După reparație, programul afișează
[210, 220, 230]
660
Indiciu

Convertește coloana la int64 înainte de adunare.

Alte forme ale mesajului

  • OverflowError: Python integer 200 out of bounds for int8
  • OverflowError: Python integer -1 out of bounds for uint8
  • DeprecationWarning: NumPy will stop allowing conversion of out-of-bound Python integers to integer arrays.

Cum o eviți pe viitor

  • Folosește tipuri mici (int8, uint8, int16) doar pentru stocare, iar pentru calcule convertește la int64.
  • Verifică dtype după downcast, astype sau citirea unei imagini.
  • La imagini, fă calculele în int16 sau float, apoi np.clip(..., 0, 255) și revino la uint8.
  • Fii atent la operațiile dintre două array-uri de tip mic: rezultatul se poate da peste cap fără niciun mesaj.

Întrebări frecvente

De ce în NumPy 1 codul mergea?

NumPy 1 transforma numărul ca să încapă, cu un avertisment de depreciere, iar rezultatul era adesea greșit (300 devenea 44 în uint8). NumPy 2 a transformat cazul într-o eroare clară.

Ce e un întreg care se dă peste cap?

Când rezultatul depășește limita, tipul mic păstrează doar ultimii biți: în uint8, 255 + 1 devine 0. Așa apar valori aberante în calcule fără nicio eroare.

Erori înrudite

← Toate erorile Python pentru analiza datelor

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Python pentru analiza datelor de la zero, cu exerciții la fiecare lecție

Curs Data Analysis with Python: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.