Metadata-Version: 2.4
Name: pvevti
Version: 2025.8.11.4
Summary: A package with utilities expressly for the VTI/PVE teams at DTNA.
Project-URL: Homepage, https://northamerica.daimlertruck.com/
Author-email: Aidan Benjamin <aidan.benjamin@daimlertruck.com>
License-Expression: MIT
License-File: LICENSE
Keywords: DTNA,Daimler,PVE,VTI
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Requires-Dist: contextily
Requires-Dist: geopandas
Requires-Dist: matplotlib
Requires-Dist: pandas
Description-Content-Type: text/markdown

# PVE-VTI Utility Package

**pvevti** is a pip-installable package intended to provide easy access to a suite of tools and enable accelerated analysis and modification of CSV files. The package is developed and maintained by the Vehicle Thermodynamics and Integration team under Product Validation Engineering at DTNA.

## Installation

To install **pvevti**, ensure `pip` is installed. `pip` is installed by default with any modern python installation. To check installation, enter `pip list`; if `pip` is installed, a list of packages installed to the local machine should be printed.

With `pip` verified to be functioning, simply enter `pip install pvevti`. A network connection is required to pull the files when installing or updating the package.

To update **pvevti**, enter `pip install pvevti --upgrade`. If you believe a dependency is not being met, **pvevti** is improperly installed, or source files were altered, force a reinstall with `pip install pvevti --upgrade --force-reinstall`.

To check if **pvevti** is installed, simply attempt to import the package in a python CLI or script.

## Usage

**pvevti** is composed of a few modules:
 - **csvutil**: Utilities associated with CSV manipulation, loading, and saving.
 - **pdfutil**: Utilities associated with PDF creation, management, and saving. 
 - **jsonutil**: Utilities associated with JSON reading and management.
 - **genutil**: Utilities associated with packaging and managing data, manipulating and extracting properties, and all pandas DataFrame manipulation (including conversions, filters, and GPS management).

The package is documented, in both source code and docstring formats. Most input arguments are typechecked, and safety rails exist to minimize the number of uncaught errors in a given process.

As with any package, use `pip uninstall pvevti` to remove the package and its dependencies. 

It is suggested to only import the modules you need; for example, instead of `import pvevti` a user who only needs the general utilities should run `import pvevti.genutil as gu`. This increases semantic legibility and decreases import time.

## Reference

For reference, please refer to [`docs.md`](docs.md). Examples of usage are found at the last section of the docs markdown file.