Método append()

Combina linhas de um ou mais dataframes em um único dataframe anexando um dataframe ao final do outro.

Sintaxe

dataframe_1_name.append([dataframe_2_name, dataframe_3_name, ...n], common_columns_only = True|False, all_chars = True|False)

Parâmetros

Nome Descrição
nome_dataframe_2, nome_dataframe_3, ...n

O dataframe ou os dataframes a serem anexados.

Os dataframes são anexadas na ordem em que são especificados. O dataframe de saída contém as linhas do dataframe_1, seguidas pelas linhas do dataframe_2 e assim por diante.

Os dataframes de origem podem ter colunas diferentes ou idênticas.

common_columns_only = True | False
  • True somente os campos comuns a todos as dataframes sendo anexadas são incluídos na dataframe de saída.

    As colunas de dataframe são consideradas comuns quando têm um nome idêntico.

  • False todas as colunas de todas os dataframes são incluídas no dataframe de saída. Os valores NaN aparecem no dataframe de saída quando não existe nenhuma coluna no dataframe de origem.
all_chars = True | False
  • True converte todos os campos não caractere em todos os dataframes sendo anexados para o tipo de dados de cadeia.

    Essa conversão global para dados de cadeia garante que todas as colunas com nomes idênticos serão anexadas sem causar erro.

  • False o tipo de dados de colunas não caractere nos dataframes sendo anexados permanece inalterado.

Retorna

Dataframe do HCL.

Exemplos

Anexar dataframes com estruturas idênticas

Você anexa os dataframes Trans_Jan, Trans_Feb e Trans_Mar em um único dataframe denominado Trans_Q1, que inclui todas as linhas dos três dataframes de origem.

Todos os dataframes de origem têm um conjunto de colunas idêntico. Portanto, não importa se você especifica True ou False para common_columns_only.

Trans_Q1 = Trans_Jan.append([Trans_Feb, Trans_Mar], common_columns_only = False, all_chars = False)

Anexar dataframes com estruturas de dados diferentes

Você tem dataframes separados que contêm dados de funcionários de várias divisões da empresa. Você precisa de todos os dados de funcionários em um único dataframe para executar algumas análises. A maioria das colunas é a mesma em todos os dataframes, mas algumas colunas não necessárias para a análise são únicas de alguns dataframes.

Você usa common_columns_only para especificar que apenas as colunas que são iguais em todos os dataframes são incluídas no dataframe de saída. Se a coluna não estiver presente em um desses dataframes, será omitida da saída.

Employees_All = Employees_HQ.append([Employees_West, Employees_South], common_columns_only = True, all_chars = False)