Guides en français

Ouvrir les fichiers .npy et .npz de NumPy dans VS Code

Installez l’extension gratuite Tensor Viewer (NPZ Viewer & NPY Viewer) et cliquez sur un fichier .npy ou .npz. Chaque tableau apparaît avec son nom, son dtype et sa forme. Un clic affiche le min, le max, la moyenne, l’écart type, le nombre de NaN, un graphique, un histogramme et les valeurs, sans Python. L’affichage, les images, la table Values et l’enregistrement en .npy ou en CSV sont gratuits. Zovo Pro (19 USD, payé une seule fois) ajoute deux outils, Compare two checkpoints et Scan all tensors, avec 3 essais gratuits pour chacun.

Gratuit, licence MIT. ID de l’extension zovo.tensor-viewer, version 0.6.5.

Ce guide existe aussi en English · Deutsch · Español · Italiano · 日本語 · Polski · Português (Brasil) · 简体中文

Étapes dans VS Code

1. Installez Tensor Viewer depuis le Marketplace, ou appuyez sur Ctrl+P (Cmd+P sur macOS) et lancez ext install zovo.tensor-viewer.
2. Cliquez sur un fichier .npy ou .npz dans l’Explorer. La table liste chaque tableau avec son nom, son type, sa forme, son nombre de paramètres et sa taille.
3. Cliquez sur un tableau. Le panneau de droite affiche le min, le max, la moyenne, l’écart type et le nombre de NaN, d’Inf et de zéros, puis une carte de chaleur pour un tableau 2D ou une courbe pour un tableau 1D, et un histogramme.
4. Lisez les nombres dans la table Values, 32 lignes à la fois. Pour un tableau à 3 dimensions ou plus, tapez une tranche comme [5, :, :] dans le champ Slice.
5. Si le tableau a la forme d’une image, par exemple (H, W, 3) ou (N, 3, H, W), la section Image le dessine. Choisissez-y Layout, Frame et Range. Les matrices de flottants affichent à la place un bouton « Show as image ».
6. Cliquez sur « Save as .npy... » ou « Save as CSV... » pour écrire le tableau, ou la tranche, dans un nouveau fichier.

Ce qui est gratuit et ce qu’ajoute Zovo Pro

Tous les formats, les statistiques, les cartes de chaleur, les courbes, les histogrammes, les images, la table Values, les tranches, les tableaux bruts (raw arrays) et l’enregistrement en .npy ou en CSV sont gratuits. Python n’est pas nécessaire, et la visionneuse ne fait aucun appel réseau.

Scan all tensors lit chaque valeur de chaque tableau du fichier, pas un échantillon. Il signale les NaN, les Inf, les tableaux entièrement nuls ou constants et les flottants de 10 000 ou plus. Il donne le min, le max, la moyenne, l’écart type et la norme L2 exacts de chaque tableau dans un seul rapport, que vous pouvez filtrer et enregistrer en CSV, Markdown ou JSON. Vous trouvez le tableau défectueux d’un gros .npz sans cliquer sur chacun.

Utiliser Scan all tensors (Zovo Pro)

7. Ouvrez le fichier et cliquez sur le bouton « Scan all tensors » en haut de la visionneuse, ou faites un clic droit sur le fichier dans l’Explorer et choisissez « Zovo Pro: Scan Tensors for NaN, Inf and Zeros ».
8. Vous pouvez aussi lancer « NumPy Viewer Pro: Scan All Tensors for NaN, Inf and Zeros » depuis la Command Palette et choisir le fichier.
9. Une notification montre la progression, et Cancel arrête une longue analyse. Dans le rapport, utilisez le filtre « Only tensors to check », puis enregistrez le rapport en CSV, Markdown ou JSON.

Scan all tensors fonctionne 3 fois sur votre ordinateur avant de demander une licence. Il n’y a ni fenêtre surgissante ni compte à rebours.

Zovo Pro coûte 19 USD, payés une seule fois. Ce n’est pas un abonnement, et la licence active les outils Pro de toutes les extensions Zovo, pas seulement de Tensor Viewer. Après le paiement par carte (Stripe), votre clé de licence s’affiche sur la page suivante. Dans VS Code, lancez « Zovo Pro: Enter Zovo Pro license key » depuis la Command Palette et collez la clé. Elle est vérifiée sur votre ordinateur, sans connexion réseau. Avec GitHub Sponsors, choisissez le palier "$19 one time", puis lancez « Zovo Pro: I already paid: unlock with GitHub Sponsors ».

Une équipe de 5 personnes paie 59 USD une seule fois (par carte). Toutes les règles et tous les outils Pro sont sur la page Zovo Pro (en anglais).

Étapes dans Cursor, Windsurf ou VSCodium

1. Ouvrez la vue Extensions avec Ctrl+Maj+X (Cmd+Maj+X sur macOS).
2. Cherchez zovo.tensor-viewer et cliquez sur Install. Cursor, Windsurf et VSCodium installent les extensions depuis Open VSX, où celle-ci s’appelle zovo/tensor-viewer.
3. Si votre éditeur n’a pas de galerie, téléchargez le fichier .vsix sur la page Open VSX et lancez « Extensions: Install from VSIX... ».
4. Ensuite, tout fonctionne comme dans VS Code.

Ce que fait Tensor Viewer

• Fichiers .npy avec en-tête v1, v2 ou v3, en ordre C ou Fortran, dans les deux ordres d’octets.
• Archives .npz avec entrées stockées ou compressées (deflate), zip64 compris.
• bool, int8 à int64, uint8 à uint64, float16, float32, float64 et nombres complexes (statistiques sur le module).
• Tableaux en forme d’image, piles et lots, dessinés comme des images, une image à la fois.
• La même extension ouvre aussi les fichiers .safetensors, .gguf et PyTorch .pt, .pth et .ckpt.

Ce qu’il ne fait pas

• Les tableaux d’objets sérialisés avec pickle sont listés mais refusés, jamais exécutés. Les tableaux de texte et les tableaux structurés sont listés sans statistiques.
• Au-delà de 2 000 000 de valeurs, les statistiques et les graphiques sont calculés sur un échantillon (réglage tensorViewer.sampleValues). Le panneau indique quand les statistiques viennent d’un échantillon.
• Les entrées compressées d’un .npz ne sont lues que depuis le début. Les valeurs au-delà de leurs 64 premiers Mo ne s’affichent pas, et les entrées de plus de 512 Mo ne peuvent pas être enregistrées.
• Les images font au plus 512 pixels sur le grand côté. Les tableaux à 2 canaux et en ordre Fortran n’ont pas de vue image.
• L’export CSV s’arrête à 20 millions de valeurs. Les valeurs int64 au-dessus de 2^53 perdent leurs derniers chiffres dans la table et dans le CSV.

Questions fréquentes

Pour aller plus loin

Le guide en anglais donne plus de détails et d’autres options. Chaque fonction et chaque réglage sont décrits sur la page de Tensor Viewer (en anglais).

Faits vérifiés le 12 novembre 2026 sur la version actuelle du Marketplace.