Introdução ao Tablesaw

Importando dados em Java

Anthony Markham

VP Quant Developer

Importando Tablesaw

Uma biblioteca para manipulação de dados
Importação mais comum: import tech.tablesaw.api.*
Importações adicionais para funcionalidades específicas, por exemplo:
- import tech.tablesaw.api.DoubleColumn
- import tech.tablesaw.api.StringColumn
Operações estatísticas: import tech.tablesaw.aggregate.*

¹ https://jtablesaw.github.io/tablesaw/

Formato tabular

Dados organizados em linhas e colunas
Colunas = variáveis/características
Linhas = observações/instâncias

Uma imagem mostrando uma tabela de exemplo, com colunas e linhas rotuladas.

Formato tabular

Pode usar arrays ou coleções para armazenar dados

// Abordagem tradicional Java (trabalhosa)
import java.util.Arrays;
import java.util.List;

List<String> names = Arrays.asList("Anna", "Bob", "Carlos");
List<Integer> ages = Arrays.asList(25, 34, 42);

Criando uma tabela

Opções: do zero, de um arquivo externo ou de colunas existentes

// Criando do zero
Table employees = Table.create("Employees")
    .addColumns(
        StringColumn.create("Name", "John", "Lisa", "Omar"),
        DoubleColumn.create("Salary", 50000, 60000, 55000)
    );

// De colunas existentes
StringColumn dept = StringColumn.create("Department", 
    "Sales", "Marketing", "Engineering");
Table departments = Table.create("Departments", dept);

Métodos addColumns() e create()

Metadados da tabela

Dimensões: table.shape()
Nomes das colunas: table.columnNames()
Estrutura da tabela: table.structure()
Pré-visualizar dados: table.first(n), table.last(n)

// Imprimir dimensões
System.out.println(data.shape());  // [linhas, colunas]

[10, 4]

Metadados da tabela

// Imprimir nomes das colunas
System.out.println(table.columnNames());

[Dia, Temperatura, Precipitação]

// Imprimir estrutura detalhada
System.out.println(table.structure());

         Estrutura da tabela          
 Índice  |   Nome da Coluna   |  Tipo da Coluna  |
     0  |            Dia  |       STRING  |
     1  |    Temperatura  |       DOUBLE  |
     2  |  Precipitação  |       DOUBLE  |

Metadados da tabela

// Pré-visualizar as três primeiras linhas
System.out.println(table.first(3));

                  tabela                  
    Dia     |  Temperatura  |  Precipitação  |
    Segunda |         22.5  |              0  |
   Terça    |           24  |            2.5  |
 Quarta     |         23.2  |            5.2  |

Adicionando colunas

Adicionando colunas: table.addColumns(newColumn)

// Adicionar uma nova coluna
DoubleColumn bonus = DoubleColumn.create("Bonus", 1000, 1500, 2000);
employees = employees.addColumns(bonus);

Removendo e renomeando colunas

// Remover uma coluna
employees = employees.removeColumns("StartDate");

// Renomear uma coluna
employees.column("Salary").setName("AnnualSalary");

// Obter o tipo da coluna
employees.column("Salary").type();

ColumnType.INTEGER

Tabelas modificadas são retornadas 💡

Resumo

Método/Sintaxe	Descrição
`Table.create("TableName")`	Cria uma nova tabela com o nome dado
`StringColumn.create("ColumnName", values)`	Cria uma coluna de string
`table.shape()`	Retorna dimensões como [linhas, colunas]
`table.columnNames()`	Retorna nomes das colunas na tabela
`table.structure()`	Mostra informações da estrutura da tabela
`table.first(n)`	Retorna as primeiras n linhas da tabela
`table.last(n)`	Retorna as últimas n linhas da tabela
`table.addColumns(newColumn)`	Adiciona uma nova coluna à tabela

¹ https://www.javadoc.io/doc/tech.tablesaw/tablesaw-core

Vamos praticar!

Importando dados em Java