Quais são os argumentos de 'níveis', 'chaves' e nomes na função concat do Pandas?

A função pandas.concat é uma ferramenta poderosa para combinar vários objetos Series ou DataFrame ao longo de um eixo especificado. Além dos argumentos básicos para especificar os objetos a serem concatenados e o eixo ao longo do qual concatená-los, concat também fornece vários argumentos opcionais que permitem personalizar a saída resultante. Três desses argumentos são níveis, chaves e nomes.

níveis

O argumento de níveis é usado para especificar os níveis do MultiIndex resultante. Se os níveis não forem especificados, o Pandas irá inferir os níveis das chaves. No entanto, você pode especificar níveis para substituir os níveis inferidos ou para criar um MultiIndex com um conjunto específico de níveis.

O argumento de níveis usa uma lista de sequências. Cada sequência representa um nível do MultiIndex. As sequências podem ser qualquer tipo de objeto que possa ser usado para criar um objeto pandas.Index.

Por exemplo, o código a seguir cria um MultiIndex com dois níveis:

df = pd.concat([df1, df2], keys=[['a', 'b'], ['c', 'd']], levels=[['A', 'B'], ['C', 'D']])

O MultiIndex resultante terá dois níveis, 'A' e 'B', e dois níveis, 'C' e 'D'. O primeiro nível do MultiIndex serão os valores 'a' e 'b', e o segundo nível serão os valores 'c' e 'd'.

chaves

O argumento das chaves é usado para especificar as chaves para o MultiIndex resultante. Se as chaves não forem especificadas, o Pandas usará os nomes dos objetos que estão sendo concatenados. No entanto, você pode especificar chaves para substituir as chaves inferidas ou para criar um MultiIndex com um conjunto específico de chaves.

O argumento chaves usa uma lista de objetos. Cada objeto representa uma chave para o MultiIndex resultante. Os objetos podem ser qualquer tipo de objeto que possa ser usado para criar um objeto pandas.Index.

Por exemplo, o código a seguir cria um MultiIndex com duas chaves:

df = pd.concat([df1, df2], keys=['a', 'b'])

O MultiIndex resultante terá duas chaves, 'a' e 'b'. O primeiro nível do MultiIndex será o valor 'a' e o segundo nível será o valor 'b'.

nomes

O argumento de nomes é usado para especificar os nomes para o níveis do MultiIndex resultante. Se os nomes não forem especificados, o Pandas usará os nomes dos objetos que estão sendo concatenados. No entanto, você pode especificar nomes para substituir os nomes inferidos ou para criar um MultiIndex com um conjunto específico de nomes.

O argumento de nomes usa uma lista de strings. Cada string representa o nome de um nível do MultiIndex resultante. As strings podem ser qualquer string válida.

Por exemplo, o código a seguir cria um MultiIndex com dois nomes:

df = pd.concat([df1, df2], keys=[['a', 'b'], ['c', 'd']], names=['A', 'B'])

O MultiIndex resultante terá dois nomes, 'A ' e 'B'. O primeiro nível do MultiIndex serão os valores 'a' e 'b', e o segundo nível serão os valores 'c' e 'd'.