Metadata-Version: 2.1
Name: dataframeviewer
Version: 1.6.15
Summary: PyQt5 application to visualize pandas DataFrames
Home-page: UNKNOWN
Author: Rafael Arvelo
Author-email: rafaelarvelo1@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Requires-Python: >=3.6
Requires-Dist: pandas
Requires-Dist: numpy
Requires-Dist: PyQt5
Requires-Dist: openpyxl
Requires-Dist: matplotlib
Requires-Dist: qdarkstyle


Overview
--------

The **Data Viewer** is a Qt Python application to view, edit, plot, and
filter data from various file types.

The Data Viewer utilizes the ``pandas`` module along with the
``Qt for Python`` module to provide a familiar spreadsheet-like GUI for
any type of data that can be stored in a pandas ``DataFrame``.

The intention of this application is to provide a high-performance,
cross-platform application to review and analyze data. The Data Viewer
provides a faster and more optimized alternative for viewing and
plotting data files in a table format as opposed to other applications
such as Microsoft Excel or OpenOffice.

Supported Input Formats
~~~~~~~~~~~~~~~~~~~~~~~
::

   Note: Input formats are automatically recognized based on the
   filename.

The Data Viewer currently supports the following input formats:

-  CSV (comma-delimited, tab-delimited)
-  TXT (plain-text files)
-  JSON (Javascript Object Notation)
-  PICKLE (Python Pickle Format)
-  XLSX (Microsoft Excel or OpenOffice files)

Supported Operating Systems
~~~~~~~~~~~~~~~~~~~~~~~~~~~

The following operating systems have been tested and confirmed to
operate the application nominally:

-  Windows 10
-  MacOS Version 11.2 (Big Sur) using Apple M1
-  Linux (CentOS, Ubuntu)

Other operating systems are untested but will likely function if they
are supported by the Qt for Python version documented in
requirements.txt

Setup Instructions
------------------

Dependencies
~~~~~~~~~~~~

-  ``pandas``
-  ``numpy``
-  ``PyQt5``
-  ``openpyxl``
-  ``matplotlib``
-  ``QDarkStyle``

Application Setup / Installation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Note: If you are using an Anaconda installation, you can skip these
setup steps and proceed directly to the `Starting the Application`_ section.

The recommended setup method is to use an isolated installation via the `virtualenv`_ module.

.. _virtualenv: https://virtualenv.pypa.io/en/latest/

``virtualenv`` installation on Windows:

.. code:: bash

   virtualenv venv
   source venv/Scripts/activate
   pip install dataframeviewer

``virtualenv`` installation on MacOS / Linux:

.. code:: bash

   virtualenv venv
   source venv/bin/activate
   pip install dataframeviewer

Local installation (on any platform):

.. code:: bash

   pip install dataframeviewer

Starting the Application
------------------------

Run as a module

.. code:: bash

   python -m dataframeviewer

Run with sample data

.. code:: bash

   python -m dataframeviewer --example

Run with input file(s)

.. code:: bash

   python -m dataframeviewer -f file1.csv file2.csv ...

To show the full command line option list

.. code:: bash

   python -m dataframeviewer --help


If using Anaconda 3 on windows with Git Bash installed, you can use the ``run.sh`` script.
This is only valid when running directly from the git source repository.

.. code:: bash

   ./run.sh

See the User Manual for application usage instructions.


