dsutils

class dsutils.DSFrame(df)

Classe que extende a funcionalidade de um pandas.DataFrame

Adiciona uma propriedade nas instâncias da classe pandas.DataFrame chamado ds, a partir da onde é possível acessar todos os métodos implementados nesta classe.

Exemplo:

>>> import pandas
>>> # Obrigatório importar o módulo para registrar a propriedade 'ds'
>>> import dsutils
>>> pd = pandas.DataFrame([[1, 2], [3, 4], [5, 6]], columns=[['i', 'c']])
>>> pd.ds.classcols = ['c']
>>> # Cópia do DataFrame contendo apenas as instâncias
>>> pd.ds.instances
>>> # Cópia do DataFrame contendo apenas as classes
>>> pd.ds.classes
>>> # Cópia do DataFrame com as instâncias normalizaas e balanceaas
>>> pd.ds.normalized.ds.balanced.ds.instances

property df: pandas.core.frame.DataFrame

Tipo de retorno

DataFrame

property classcols: list[str]

Tipo de retorno

list[str]

property train: pandas.core.frame.DataFrame

Tipo de retorno

DataFrame

property classes: pandas.core.frame.DataFrame

Tipo de retorno

DataFrame

property instances: pandas.core.frame.DataFrame

Tipo de retorno

DataFrame

property nona: pandas.core.frame.DataFrame

Tipo de retorno

DataFrame

property numericals: pandas.core.frame.DataFrame

Tipo de retorno

DataFrame

property categoricals: pandas.core.frame.DataFrame

Tipo de retorno

DataFrame

property normalized: pandas.core.frame.DataFrame

Tipo de retorno

DataFrame

property balanced: pandas.core.frame.DataFrame

Tipo de retorno

DataFrame

property reduced: pandas.core.frame.DataFrame

Tipo de retorno

DataFrame

property reduced3d: pandas.core.frame.DataFrame

Tipo de retorno

DataFrame

split(size=0.3)

Tipo de retorno

tuple[DataFrame, DataFrame]

class dsutils.DSLog

Classe auxiliar para interface com módulo logging do Python.

Esta classe configura o módulo logging do Python definido um nível de log customizado para que as mensagens não conflitem com os logs do sistema ou de outros módulos.

Além disso, são definidos métodos para facilitar e padronizar a geração de logs.

Variáveis

DSINFO – Nível de log customizado

DSINFO: int = 45

static log(msg, level=45)

Gera uma mensagem de log.

Gera uma mensagem de log cujo nível padrão é DSINFO.

Tipo de retorno

None

static logged(func=None, *, msg=None, level=45)

Decorador para gerar mensagens de log automaticamente.

Este método tem como objetivo ser utilizado como decorador de funções ou outros métodos, gerando uma mensagem de log com o nome da função ou método decorado quando este é executado.

Exemplo:

>>> import dsutils
>>>
>>> @dsutils.DSLog.logged
>>> def teste():
>>>     return 1
>>>
>>> teste() # Gera um log informando que teste está em execução

dsutils.logged(func=None, *, msg=None, level=45)

Decorador para gerar mensagens de log automaticamente.

Este método tem como objetivo ser utilizado como decorador de funções ou outros métodos, gerando uma mensagem de log com o nome da função ou método decorado quando este é executado.

Exemplo:

>>> import dsutils
>>>
>>> @dsutils.DSLog.logged
>>> def teste():
>>>     return 1
>>>
>>> teste() # Gera um log informando que teste está em execução

dsutils.log(msg, level=45)

Gera uma mensagem de log.

Gera uma mensagem de log cujo nível padrão é DSINFO.

Tipo de retorno

None

class dsutils.DSTime

Classe auxiliar para interface com módulo time do Python.

static timed(func=None, *, msg=None, level=45)

Decorador para cronometrar a execção de código automaticamente.

Este método tem como objetivo ser utilizado como decorador de funções ou outros métodos, cronometrando seu tempo de execução automaticamente. Ao final da execução da função ou método decorado, é gerado um log com o seu tempo de execução utilizando o método DSLogger.log().

Exemplo:

>>> import dsutils
>>>
>>> @dsutils.DSTimer.timed
>>> def teste():
>>>     return 1
>>>
>>> teste() # Gera um log informando o tempo de execução da função

dsutils.timed(func=None, *, msg=None, level=45)

Decorador para cronometrar a execção de código automaticamente.

Este método tem como objetivo ser utilizado como decorador de funções ou outros métodos, cronometrando seu tempo de execução automaticamente. Ao final da execução da função ou método decorado, é gerado um log com o seu tempo de execução utilizando o método DSLogger.log().

Exemplo:

>>> import dsutils
>>>
>>> @dsutils.DSTimer.timed
>>> def teste():
>>>     return 1
>>>
>>> teste() # Gera um log informando o tempo de execução da função

class dsutils.DSPlot

class Color(yellow='#ddb310', darkgreen='#005900', lipstick='#b80058', azure='#008cf9', darkgray='#585858', green='#006e00', lavender='#d163e6', brown='#b24502', coral='#ff9287', darkblue='#000078', indigo='#5954d6', turquoise='#00c6f8', olive='#878500', jade='#00a76c', gray='#bdbdbd', darkpink='#8a034f')

yellow: str = '#ddb310'

darkgreen: str = '#005900'

lipstick: str = '#b80058'

azure: str = '#008cf9'

darkgray: str = '#585858'

green: str = '#006e00'

lavender: str = '#d163e6'

brown: str = '#b24502'

coral: str = '#ff9287'

darkblue: str = '#000078'

indigo: str = '#5954d6'

turquoise: str = '#00c6f8'

olive: str = '#878500'

jade: str = '#00a76c'

gray: str = '#bdbdbd'

darkpink: str = '#8a034f'

class Marker

point = '.'

circle = 'o'

plus_filled = 'P'

hexagon2 = 'H'

star = '*'

square = 's'

x_filled = 'X'

diamond = 'D'

triangle_down = 'v'

color = DSPlot.Color(yellow='#ddb310', darkgreen='#005900', lipstick='#b80058', azure='#008cf9', darkgray='#585858', green='#006e00', lavender='#d163e6', brown='#b24502', coral='#ff9287', darkblue='#000078', indigo='#5954d6', turquoise='#00c6f8', olive='#878500', jade='#00a76c', gray='#bdbdbd', darkpink='#8a034f')

marker = DSPlot.Marker()

pyplot_rc = {'axes.axisbelow': False, 'axes.edgecolor': 'lightgrey', 'axes.facecolor': 'None', 'axes.grid': False, 'axes.labelcolor': 'dimgrey', 'figure.facecolor': 'white', 'lines.solid_capstyle': 'round', 'patch.edgecolor': 'w', 'patch.force_edgecolor': True, 'text.color': 'dimgrey', 'xtick.bottom': False, 'xtick.color': 'dimgrey', 'xtick.direction': 'out', 'xtick.top': False, 'ytick.color': 'dimgrey', 'ytick.direction': 'out'}

class dsutils.DSDataDir

path = '/home/docs/checkouts/readthedocs.org/user_builds/equiperocket/checkouts/latest/data'

static join(*args)

dsutils.datadir

apelido de dsutils.dsdatadir.DSDataDir

class dsutils.DSExercise(title)

static text(*args, **kwargs)

static columns(*args, **kwargs)

item(item, *resolutions)

print()