Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/trolobezka/data2latex
Package prototype for simple generation of LaTeX tables and plots from scientific data for use in any document.
https://github.com/trolobezka/data2latex
latex latex-pdf numpy-array numpy-arrays pandas-dataframe plot plotting pylatex python python3 table
Last synced: 2 months ago
JSON representation
Package prototype for simple generation of LaTeX tables and plots from scientific data for use in any document.
- Host: GitHub
- URL: https://github.com/trolobezka/data2latex
- Owner: Trolobezka
- License: mit
- Created: 2023-05-06T15:38:10.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2023-05-18T11:20:43.000Z (over 1 year ago)
- Last Synced: 2024-11-15T10:28:24.673Z (3 months ago)
- Topics: latex, latex-pdf, numpy-array, numpy-arrays, pandas-dataframe, plot, plotting, pylatex, python, python3, table
- Language: Python
- Homepage: https://trolobezka.github.io/data2latex-docs
- Size: 623 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Data2LaTeX
[](https://github.com/psf/black)
This project is a part of my bachelor thesis which deals with data representation using **Python** and **LaTeX**. You can find the source code on my [GitHub](https://github.com/Trolobezka/data2latex).
The idea behind this package prototype is that generating LaTeX documents containing scientific data from Python should not be difficult and require many steps. Currently the package supports the creation of simple tables and two types of plots: scatter plots and line plots. The package uses the [PyLaTeX](https://github.com/JelteF/PyLaTeX) package to handle the document creation and compilation process. The main data sources are arrays and data tables from the popular packages `numpy` and `pandas`. A major inspiration for the module syntax is the `matplotlib.pyplot` module, which allows plots to be created in a few lines of code. The tables are created using the `tblr` environment from the `tabularray` package. The plots are created using the `tikzpicture` / `axis` environment from the `tikz` / `pgfplots` package.
## Examples
Examples with results can be found in the [documentation](https://trolobezka.github.io/data2latex-docs).
### Simple features
```python
import data2latex as dtol
dtol.section("Data2LaTeX")
dtol.text("This project is part of my bachelor thesis which deals with data representation using Python and LaTeX.")
dtol.finish("simple_features")
```
### Simple table
```python
import data2latex as dtol
data = [[1, 2, 3], [4, 5, 6], [7, 8, 9]]
dtol.table(data)
dtol.finish("simple_table")
```
### Simple plot
```python
import data2latex as dtol
X = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
Y = [84, 13, 94, 37, 80, 89, 90, 45, 55, 26, 92]
dtol.plot(X, Y, line="-", mark="*")
dtol.finish("simple_plot")
```
## Installation
```bash
python -m pip install --upgrade pip
python -m pip install --upgrade data2latex
```
## Development
```bash
python -m venv .venv
./.venv/Scripts/activate
python -m pip install --upgrade pip
python -m pip install .[dev]
```
## Generating documentation
```bash
sphinx-apidoc -o docs src/data2latex
./docs/make html
```
## Packaging
```bash
python clear.py
python -m pip install --upgrade build
python -m build
```
## Publishing
```bash
python -m pip install --upgrade twine
python -m twine upload dist/*
```