ednarzinho 0.1.0

Biblioteca didática para resolução de matrizes com passo a passo verificado em pt-BR

ednarzinho

Biblioteca Python didática para resolução de matrizes com passo a passo verificado, em pt-BR.

Resolve matrizes — inclusive simbólicas (com r, m, sin(θ), √, etc.), produtos escalares e vetoriais — calcula determinante e inversa, e gera um notebook Jupyter pronto com a resolução completa. Cada resultado é conferido por um método independente: a biblioteca nunca devolve uma resposta errada em silêncio.

import ednarzinho as edz

edz.gerar_notebook([[2, 1], [3, 4]], "resolucao.ipynb")
# → cria um .ipynb com a matriz, o determinante, a inversa e o passo a passo.

Instalação

pip install ednarzinho

Requer Python 3.12+. Instala o SymPy automaticamente.

Uso

Caso principal: resolver uma matriz e gerar o notebook

A função gerar_notebook recebe a matriz (números ou expressões simbólicas em string) e escreve um .ipynb autossuficiente — pronto para entregar:

import ednarzinho as edz

A = [
    ["sqrt(1 - 2*m/r)", 0, 0, 0],
    [0, "sqrt((1-2*m/r)**(-1))*sin(theta)*cos(phi)", "r*cos(theta)*cos(phi)", "-r*sin(theta)*sin(phi)"],
    [0, "sqrt((1-2*m/r)**(-1))*sin(theta)*sin(phi)", "r*cos(theta)*sin(phi)", "r*sin(theta)*cos(phi)"],
    [0, "sqrt((1-2*m/r)**(-1))*cos(theta)", "-r*sin(theta)", 0],
]

edz.gerar_notebook(A, "resolucao.ipynb")          # determinante + inversa (padrão)
edz.gerar_notebook(A, "so_det.ipynb", operacoes=["determinante"])

Resolver direto no código

import ednarzinho as edz

A = edz.Matriz([[2, 1], [3, 4]])

r = edz.resolver(A, operacao="determinante")
print(r.valor)            # o determinante
print(r.markdown())       # passo a passo em Markdown

inv = edz.resolver(A, operacao="inversa")
print(inv.markdown())     # passo a passo da inversa (verificada por A·A⁻¹ = I)

Operações: determinante, inversa, gauss, gauss_jordan, sistema (com b=...). Formatos de saída de uma Resolucao: .markdown(), .latex(), .terminal().

Por que "verificado"?

Para matrizes simbólicas, a eliminação de Gauss pode dividir por pivôs que se anulam. Por isso a ednarzinho usa cofatores (expansão de Laplace para o determinante; método da adjunta para a inversa) e cruza cada resultado com um algoritmo independente (Berkowitz, A·A⁻¹ = I). Divergência → erro explícito, nunca um valor errado silencioso.

Desenvolvimento

git clone <URL-do-seu-repositorio>     # ajuste para o seu GitHub
cd ednarzinho
python -m pip install -e ".[dev]"
python -m pytest          # 344 testes
python -m ruff check src/

No Windows, se a ativação do venv falhar por política de execução, use .venv\Scripts\python.exe -m ... diretamente.

Licença

MIT — veja LICENSE.