Metadata-Version: 2.3
Name: tfs-pandas
Version: 3.9.0
Summary: Read and write tfs files.
Project-URL: homepage, https://github.com/pylhc/tfs
Project-URL: repository, https://github.com/pylhc/tfs
Project-URL: documentation, https://pylhc.github.io/tfs/ 
Project-URL: changelog, https://github.com/pylhc/tfs/blob/master/CHANGELOG.md
Author-email: OMC Team <pylhc@github.com>
License: MIT
Keywords: MAD-X,TFS
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.9
Requires-Dist: numpy>=1.24
Requires-Dist: pandas>=2.1
Provides-Extra: all
Requires-Dist: cpymad>=1.8.1; extra == 'all'
Requires-Dist: h5py>=3.0; extra == 'all'
Requires-Dist: numpy<2.0,>=1.24; (python_version < '3.10') and extra == 'all'
Requires-Dist: numpy>=1.24; (python_version >= '3.10') and extra == 'all'
Requires-Dist: pytest-cov>=2.9; extra == 'all'
Requires-Dist: pytest>=7.0; extra == 'all'
Requires-Dist: sphinx-codeautolink>=0.14; extra == 'all'
Requires-Dist: sphinx-copybutton>=0.4; extra == 'all'
Requires-Dist: sphinx-prompt>=1.7; extra == 'all'
Requires-Dist: sphinx-rtd-theme>=2.0; extra == 'all'
Requires-Dist: sphinx>=7.0; extra == 'all'
Requires-Dist: tables>=3.9; extra == 'all'
Requires-Dist: zstandard>=0.15.2; extra == 'all'
Provides-Extra: doc
Requires-Dist: sphinx-codeautolink>=0.14; extra == 'doc'
Requires-Dist: sphinx-copybutton>=0.4; extra == 'doc'
Requires-Dist: sphinx-prompt>=1.7; extra == 'doc'
Requires-Dist: sphinx-rtd-theme>=2.0; extra == 'doc'
Requires-Dist: sphinx>=7.0; extra == 'doc'
Provides-Extra: hdf5
Requires-Dist: h5py>=3.0; extra == 'hdf5'
Requires-Dist: numpy<2.0,>=1.24; (python_version < '3.10') and extra == 'hdf5'
Requires-Dist: numpy>=1.24; (python_version >= '3.10') and extra == 'hdf5'
Requires-Dist: tables>=3.9; extra == 'hdf5'
Provides-Extra: test
Requires-Dist: cpymad>=1.8.1; extra == 'test'
Requires-Dist: h5py>=3.0; extra == 'test'
Requires-Dist: numpy<2.0,>=1.24; (python_version < '3.10') and extra == 'test'
Requires-Dist: numpy>=1.24; (python_version >= '3.10') and extra == 'test'
Requires-Dist: pytest-cov>=2.9; extra == 'test'
Requires-Dist: pytest>=7.0; extra == 'test'
Requires-Dist: tables>=3.9; extra == 'test'
Requires-Dist: zstandard>=0.15.2; extra == 'test'
Description-Content-Type: text/markdown

# TFS-Pandas

[![Cron Testing](https://github.com/pylhc/tfs/workflows/Cron%20Testing/badge.svg)](https://github.com/pylhc/tfs/actions?query=workflow%3A%22Cron+Testing%22)
[![Code Climate coverage](https://img.shields.io/codeclimate/coverage/pylhc/tfs.svg?style=popout)](https://codeclimate.com/github/pylhc/tfs)
[![Code Climate maintainability (percentage)](https://img.shields.io/codeclimate/maintainability-percentage/pylhc/tfs.svg?style=popout)](https://codeclimate.com/github/pylhc/tfs)
<!-- [![GitHub last commit](https://img.shields.io/github/last-commit/pylhc/tfs.svg?style=popout)](https://github.com/pylhc/tfs/) -->
[![GitHub release](https://img.shields.io/github/v/release/pylhc/tfs?logo=github)](https://github.com/pylhc/tfs/)
[![PyPI Version](https://img.shields.io/pypi/v/tfs-pandas?label=PyPI&logo=pypi)](https://pypi.org/project/tfs-pandas/)
[![Conda-forge Version](https://img.shields.io/conda/vn/conda-forge/tfs-pandas?color=orange&logo=anaconda)](https://anaconda.org/conda-forge/tfs-pandas)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.5070986.svg)](https://doi.org/10.5281/zenodo.5070986)

This package provides reading and writing functionality for [**Table Format System (TFS)** files](http://mad.web.cern.ch/mad/madx.old/Introduction/tfs.html).
Files are read into a `TfsDataFrame`, a class built on top of the famous `pandas.DataFrame`, which in addition to the normal behavior attaches a dictionary of headers to the `DataFrame`.

See the [API documentation](https://pylhc.github.io/tfs/) for details.

## Installing

Installation is easily done via `pip`:

```bash
python -m pip install tfs-pandas
```

One can also install in a `conda`/`mamba` environment via the `conda-forge` channel with:

```bash
conda install -c conda-forge tfs-pandas
```

## Example Usage

The package is imported as `tfs`, and exports top-level functions for reading and writing:

```python
import tfs

# Loading a TFS file is simple
data_frame = tfs.read("path_to_input.tfs", index="index_column")

# You can access and modify the headers with the .headers attribute
useful_variable = data_frame.headers["SOME_KEY"]
data_frame.headers["NEW_KEY"] = some_variable

# Manipulate data as you do with pandas DataFrames
data_frame["NEWCOL"] = data_frame.COL_A * data_frame.COL_B

# You can check the validity of a TfsDataFrame, and choose the behavior in case of errors
tfs.frame.validate(data_frame, non_unique_behavior="raise")  # or choose "warn"

# Writing out to disk is simple too
tfs.write("path_to_output.tfs", data_frame, save_index="index_column")
```

Reading and writing compressed files is also supported, and done automatically based on the provided file extension:

```python
import tfs

# Reading a compressed file is simple, compression format is inferred
df = tfs.read("path_to_input.tfs.gz")

# When writing choose the compression format by providing the appropriate file extension
tfs.write("path_to_output.tfs.bz2", df)
tfs.write("path_to_output.tfs.zip", df)
```

## License

This project is licensed under the `MIT License` - see the [LICENSE](LICENSE) file for details.
