Pular para o conteúdo

    Capítulo 2, Ambiente

    Instalando e importando o NumPy

    Duas linhas deixam o NumPy pronto, e a maioria dos problemas de iniciantes vem de a instalação ter ido parar em um Python diferente do que você está usando.

    Código deste capítulo: ambiente/cap02_instalacao.py

    Instalar

    O NumPy se instala como qualquer pacote Python, dentro de um ambiente virtual, como o curso de Python mostrou. Escolha a ferramenta que você usa:

    Terminal
    uv init meu-projeto
    cd meu-projeto
    uv add numpy
    

    O uv add cria o ambiente, instala o pacote e o registra no pyproject.toml. Para executar um arquivo no ambiente do projeto, use uv run arquivo.py.

    O NumPy distribui versões já compiladas (wheels) para os sistemas e versões do Python mais comuns. Por isso a instalação leva segundos e não exige compilador.

    Importar, e a convenção `np`

    ambiente/cap02_instalacao.pylinhas 10 a 17
    import sys
    from pathlib import Path
    
    import numpy as np
    
    print("versão 2 ou superior:", int(np.__version__.split(".")[0]) >= 2)
    print("onde está o NumPy:", Path(np.__file__).parent.name)
    print("este Python existe no disco:", Path(sys.executable).exists())
    
    Saída
    versão 2 ou superior: True
    onde está o NumPy: numpy
    este Python existe no disco: True
    

    O apelido np não é uma regra da linguagem, mas é uma convenção tão forte que toda documentação, todo tutorial e toda resposta na internet a assumem. Usar outro apelido só faz você traduzir o que lê.

    Para ver como o seu NumPy foi construído (quais bibliotecas de álgebra linear ele usa, por exemplo), existe o show_config:

    ambiente/cap02_instalacao.pylinha 19
    np.show_config()
    

    Quando o import falha

    O erro mais comum é instalar com o pip em um terminal e receber No module named 'numpy' no editor. Quase sempre isso significa que são dois Pythons diferentes: o do terminal recebeu o pacote, e o do editor (ou do notebook) não. Para descobrir qual Python está rodando e se ele enxerga o NumPy:

    Terminal
    python -c "import sys; print(sys.executable)"
    python -m pip show numpy
    python -c "import numpy; print(numpy.__version__, numpy.__file__)"
    
    SintomaCausa provávelO que fazer
    No module named 'numpy' no editorO editor usa outro interpretadorSelecione o interpretador do .venv do projeto
    No module named 'numpy' só no notebookO kernel é de outro ambienteInstale ipykernel no ambiente e escolha esse kernel
    Versão inesperadaDois ambientes com versões diferentesCompare sys.executable nos dois lugares
    Erro de instalação por falta de compiladorVersão do Python sem wheel disponívelUse uma versão do Python suportada pelo pacote

    A regra que me poupa tempo

    Sempre use python -m pip em vez de pip puro. Assim o pip é obrigatoriamente o do interpretador que você chamou, e o pacote cai no lugar certo.

    Exercício 1

    Um diagnóstico do ambiente

    Escreva diagnostico() que devolva um dicionário com a versão do NumPy, a versão do Python (como tupla de dois números) e se o executável do Python existe no disco.