Método DataFrame.rename() do Pandas

Beginner

Introdução

Neste laboratório, aprenderemos como usar o método DataFrame.rename() no Pandas para alterar ou modificar os rótulos de um DataFrame.

Dicas para a VM

Após a inicialização da VM, clique no canto superior esquerdo para mudar para a aba Notebook e acessar o Jupyter Notebook para praticar.

Às vezes, pode ser necessário aguardar alguns segundos para que o Jupyter Notebook termine de carregar. A validação das operações não pode ser automatizada devido a limitações no Jupyter Notebook.

Se você enfrentar problemas durante o aprendizado, sinta-se à vontade para perguntar ao Labby. Forneça feedback após a sessão, e resolveremos o problema prontamente para você.

Importando as Bibliotecas Necessárias

Primeiramente, precisamos importar a biblioteca pandas, que nos permitirá trabalhar com DataFrames.

import pandas as pd

Criando o DataFrame

Em seguida, criaremos um DataFrame de exemplo que usaremos ao longo do laboratório.

df = pd.DataFrame({"A": [1, 2, 3], "B": [4, 5, 6],"C": [7, 8, 9]})

Alterando os Rótulos das Colunas

Para alterar os rótulos das colunas no DataFrame, podemos usar o método DataFrame.rename(). Nesta etapa, mudaremos os rótulos das colunas de "A", "B" e "C" para "a", "b" e "c", respectivamente.

df = df.rename(columns={"A": "a", "B": "b", "C": "c"})

Alterando os Rótulos do Índice

Para alterar os rótulos das linhas ou do índice no DataFrame, também podemos usar o método DataFrame.rename(). Nesta etapa, mudaremos os rótulos do índice de 0, 1 e 2 para "index_1", "index_2" e "index_3", respectivamente.

df = df.rename(index={0: "index_1", 1: "index_2", 2: "index_3"})

Tratamento de Erros

Por padrão, o método DataFrame.rename() ignora quaisquer erros que ocorram durante a alteração dos rótulos. No entanto, podemos gerar um erro definindo o parâmetro errors como "raise". Nesta etapa, tentaremos alterar o rótulo de uma coluna inexistente, o que resultará em um KeyError.

df = df.rename(columns={"A": "a", "B": "b", "D": "d"}, errors="raise")

Resumo

Neste laboratório, aprendemos como usar o método DataFrame.rename() no Pandas para alterar os rótulos de um DataFrame. Podemos modificar tanto os rótulos das colunas quanto os rótulos do índice usando este método. Também vimos como lidar com erros ao alterar rótulos. Este método é útil quando precisamos renomear ou modificar os rótulos de nossos dados para análise ou apresentação.