PresentationPDF Available

Introdução ao Jupyter Notebook: Como instalar e começar a escrever seus códigos

Authors:

Abstract

Esta apresentação é uma gentil introdução ao Jupyter Notebook e aborda como instalar a distribuição Anaconda, como verificar sua instalação e como criar um ambiente virtual especial para o uso do Jupyter Notebook (via Anaconda Prompt). Ademais, o PDF contém anexo um notebook que serve de tutorial aos iniciantes, mostrando como escrever e editar textos, bem como executar códigos em Python, abordando desde a criação de funções à visualização de dados. Por fim, o documento aponta para referências pertinentes, como um curso introdutório de Python (ministrado pelo PET-SI da UFSM), um vídeo sobre o Jupyter Notebook (gravado pela Universidade dos Dados) e documentações relevantes.
Introdução ao Jupyter Notebook
Como instalar e começar a escrever seus códigos
Felipe Ramos de Mello
Orientador: Prof. William D’Andrea Fonseca
Unive rsidade Fe deral de Santa Ma ria ENGENHARIA ACÚSTICA | UFSM
EAC
,
Abril de 2023
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 1/25
Sumário
Apresentação
1Introdução
2Instalação
3Configuração
4Meu primeiro Notebook
5The End
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 2/25
Apresentação
Sumário
Apresentação
1Introdução
2Instalação
3Configuração
4Meu primeiro Notebook
5The End
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 3/25
Apresentação
Apresentação
Está apresentação serve de apoio para os alunos de
Processamentos de Digital de Sinais 2 (EAC-UFSM) e
Acústica Básica (PPGAUP-UFSM).
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 4/25
Introdução
Sumário
Apresentação
1Introdução
2Instalação
3Configuração
4Meu primeiro Notebook
5The End
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 5/25
Introdução
Introdução o que é o Jupyter Notebook?
O Jupyter Notebook é uma aplicação web que permite ao usuário:
Escrever e executar códigos computacionais
(em linguagens como Python, Julia, R etc);
Apresentar conteúdo gráfico
(via bibliotecas como Matplotlib, por exemplo); e
Renderizar textos
(escritos em Markdown).
Seus documentos são chamados de Notebooks.
Para mais informações, checar as referências [1,2].
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 6/25
Introdução
Introdução o que é o Jupyter Notebook?
>
The Kernel
The Notebook
Nb
ServidorCliente Kernel
Documento
Jupyter
Interface ao
usuário
WebSockets ZeroMQ
Linguagens
de programação
Figure 1: Fluxograma de funcionamento do Jupyter Notebook
(adaptado de Rodriguez [2].)
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 6/25
Instalação
Sumário
Apresentação
1Introdução
2Instalação
3Configuração
4Meu primeiro Notebook
5The End
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 7/25
Instalação
Instalação o jeito mais fácil [1/2]
É possível instalar o Jupyter Notebook e os kernel separadamente e
de forma manual.
Todavia, a forma mais fácil é utilizar uma distribuição.
Para esse tutorial, a distribuição escolhida é o Anaconda.
Para baixar e instalar o Anaconda, acesse este link e desça a página
para selecionar o pacote de acordo com seu sistema operacional
(vide Figura 2, esse tutorial considera o uso do Windows 10).
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 8/25
Instalação
Instalação o jeito mais fácil [2/2]
Figure 2: Instaladores do Anaconda para diversos sistemas operacionais.
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 9/25
Instalação
Instalação Anaconda [1/2]
Para instalar o Anaconda em Windows, siga os passos (retirados do site oficial):
1Inicie o instalador previamente baixado e clique em next.
2Na sequência, você será convidado a ler os termos de uso. Para prosseguir é necessário
aceitá-los clicando em I agree.
3Na próxima tela, selecione se o Anaconda será instalado para todos os usuários ou não.
Recomenda-se instalar apenas para o usuário atual (just me). Selecione e clique em next.
4Aqui, selecione o caminho de destino de sua instalação. Em caso de dúvida, siga o
sugerido pelo instalador e clique em next.
5Por fim, serão mostradas algumas opções. Marque as recomendadas e deixe desmarcada
a opção Add Anaconda 3 to my PATH environment variable (vide Figura 3). Clique em
install.
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 10/25
Instalação
Instalação Anaconda [2/2]
Figure 3: Opções de instalação do Anaconda. Aqui é recomendado não adicionar
o Anaconda ao PATH do Windows.
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 11/25
Instalação
Verificando a instalação
A distribuição Anaconda vem com dois programas principais:
Anaconda Navigator: interface gráfica que permite gerenciar os pacotes e
programas instalados na distribuição; e
Anaconda Prompt: linha de comando ligada ao Anaconda (vamos utilizá-la).
É necessário verificar se a instalação foi bem sucedida.
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 12/25
Instalação
Verificando a instalação
Para verificar via Anaconda Navigator:
Em iniciar, digite “Anaconda Navigator” e clique para abrir o programa. Se a
instalação foi bem sucedida, o programa abrirá normalmente.
Para verificar via Anaconda Prompt:
Em iniciar, digite “Anaconda Prompt” e clique para abrir o programa.
Uma tela de comando será aberta. Nela, digite conda list. Caso tudo esteja
funcionando, será exibida uma lista com todos os pacotes instalados e suas
versões.
Outra forma de testar é digitar python. Se o Anaconda estiver funcionando, o
termo “anaconda” constará na versão do Python instalada.
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 12/25
Configuração
Sumário
Apresentação
1Introdução
2Instalação
3Configuração
4Meu primeiro Notebook
5The End
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 13/25
Configuração
Configuração ambientes virtuais em Python
Estamos interessados em escrever Notebooks utilizando o Python como kernel.
Apesar do Anaconda instalar tudo o que precisamos para usar o Python, existem
algumas práticas que evitarão problemas em projetos maiores.
A principal dessas práticas é a criação de ambientes virtuais.
Um ambiente virtual é um ambiente Python isolado, no qual é possível instalar
bibliotecas e dependências específicas para uma aplicação sem interferir com o
Python instalado no sistema (ou outros ambientes virtuais), evitando possíveis
conflitos como problemas de versão, por exemplo.
Para mais informações sobre como o Anaconda lida com ambientes, checar a referência [3].
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 14/25
Configuração
Configuração criação de um ambiente virtual
Antes de criar nosso ambiente virtual, a primeira tarefa é verificar se o
Anaconda está atualizado.
Para isso, abra o Anaconda Prompt e digite o comando
conda update -n base -c defaults conda
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 15/25
Configuração
Configuração criação de um ambiente virtual
Antes de criar nosso ambiente virtual, a primeira tarefa é verificar se o
Anaconda está atualizado.
Para isso, abra o Anaconda Prompt e digite o comando
Figure 4: Comando digitado no Anacompda Prompt.
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 15/25
Configuração
Configuração criação de um ambiente virtual
Com o Anaconda atualizado, digite comando:
conda create -c conda-forge -n jupyter-env jupyter numpy scipy matplotlib cython
O Anaconda fará uma busca online e listará todos os pacotes que serão instalados.
Na sequência, perguntará se desejas proceder. Digite “y” e confirme.
Ao fim, o Anaconda criará um ambiente chamado jupyter-env com os pacotes
jupyter, numpy, scipy, matplotlib e cython instalados.
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 15/25
Configuração
Configuração sobre os pacotes
Jupyter: pacote com as ferramentas para utilização do Jupyter Notebook.
Numpy: pacote para cálculos numéricos em Python, com funções otimizadas para
o uso de matrizes (em maneira similar ao Matlab, site oficial).
Scipy: oferece algoritmos otimizados para cálculos numéricos (site oficial).
Matplotlib: biblioteca para plots e gráficos (site oficial).
Cython: é uma extensão do Python com objetivo de aumentar sua performance
(aos moldes da linguagem C, site oficial).
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 16/25
Meu primeiro Notebook
Sumário
Apresentação
1Introdução
2Instalação
3Configuração
4Meu primeiro Notebook
5The End
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 17/25
Meu primeiro Notebook
Ativação do ambiente e inicialização do Jupyter
Para iniciar o ambiente virtual previamente criado, execute o seguinte
comando no Anaconda Prompt:
conda activate jupyter-env
Para iniciar o Jupyter, por sua vez, basta digitar o comando
jupyter notebook. O Anaconda abrirá uma página no navegador
similar a ilustrada na Figura 4.
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 18/25
Meu primeiro Notebook
Inicialização do Jupyter [1/3]
Figure 4: Tela de inicialização do Jupyter Notebook.
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 19/25
Meu primeiro Notebook
Inicialização do Jupyter [2/3]
Note que o Jupyter Notebook inicializa-se na primeira pasta do disco (/) e, nesse
caso, é necessário selecionar a pasta de trabalho manualmente.
Uma dica é inicializar o Jupyter Notebook diretamente na pasta onde serão salvos
os arquivos.
Para isso, localize ou crie essa pasta e copie seu caminho, como exemplificado na
Figura 5.
Figure 5: Copiando o caminho para uma pasta.
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 20/25
Meu primeiro Notebook
Inicialização do Jupyter [3/3]
Com o caminho da pasta definido, antes de iniciar o Jupyter
Notebook via Anaconda Prompt, digite o comando:
cd caminho_para_a_pasta
Na sequência, basta inicializar o Jupyter Notebook via o comando
jupyter notebook no Anaconda Prompt.
Agora, a tela de início será a pasta selecionada.
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 21/25
Meu primeiro Notebook
Meu primeiro Jupyter Notebook
Para que vocês possam testar os procedimentos e se familiarizarem
com o Jupyter Notebook, foi disponibilizado um arquivo intitulado
meu_primeiro_notebook.ipynb.
Para acessá-lo, clique no ícone ou verifiquem os
arquivos anexos a este PDF.
Sintam-se encorajados para abri-lo, testá-lo e explorá-lo!
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 22/25
The End
Sumário
Apresentação
1Introdução
2Instalação
3Configuração
4Meu primeiro Notebook
5The End
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 23/25
The End
Esperamos que essa apresentação tenha sido a fagulha inicial para
você fazer seus próprios códigos no Jupyter.
Demais informações podem ser consultadas em diversos fóruns na
internet, como o StackExchange.
O canal Universidade dos Dados, no YouTube, possui uma introdução
bem concisa ao Jupyter Notebook, mostrando a interface e suas
funcionalidades. É um bom ponto de partida e um complemento a
este documento (link de acesso).
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 24/25
Referencias
Referencias I
1. Jupyter Team. The Jupyter Notebook.Acesso em abril de 2023. 2015. url:
https://jupyter-notebook.readthedocs.io/en/stable/.
2. Roberto Rodriguez. Threat Hunter Playbook.Acesso em abril de 2023. 2022. Chap. Tutorials Jupyter
Notebooks. url:https://threathunterplaybook.com/tutorials/jupyter/introduction.html.
3. Managing environments.Acesso em abril de 2023. Anaconda, Inc. 2017. url:
https://conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html.
EAC
Felipe Mello & Will Fonseca Jupyter Tutorial (PDS2 & Acústica Básica) 25/25
ResearchGate has not been able to resolve any citations for this publication.
The Jupyter Notebook. Acesso em abril de 2023
  • Jupyter Team
Jupyter Team. The Jupyter Notebook. Acesso em abril de 2023. 2015. url: https://jupyter-notebook.readthedocs.io/en/stable/.