Package: dfvue
A simple GUI to view csv filesAbout dfvuedfvueis a minimal GUI for a quick view of csv files. It uses an input panel
similar to Excel to check visually that the csv file is read correctly. It
provides most options of pandas’read_csvmethod to be very versatile on the
possible csv format.dfvueis a Python script that can be called from within Python or as a
command line tool. It is not supposed to produce publication-ready plots but
rather provide a quick overview of the csv file.The complete documentation fordfvueis available from:https://mcuntz.github.io/dfvue/Quick usage guidedfvuecan be run from the command line:dfvuecsv_file.csvor from within Python:fromdfvueimportdfvuedfvue('csv_file.csv')where the csv file is optional. The latter can be left out and a csv file can be
opened with the “Open File” button from withindfvue.Note,dfvueuses theTkAggbackend ofmatplotlib. It must be called
before any other call tomatplotlib. This also means that you cannot launch it
from withiniPythonif it was launched with–pylab. It can be called from
within a standardiPython, though, or usingipython –gui tk.General layoutOn opening,dfvuepresents currently only one panel for producing
scatter/line plots. This is the look in macOS light mode (higher resolution
images can be found in thedocumentation):The pane is organised in this fashion: the plotting canvas, the Matplotlib
navigation toolbar and the pane, where one can choose the plotting variables and
plotting options. You can open another, identical window for the same csv file
with the button “New Window” on the top right. You can then also read in a new
csv file in one of the windows with the button “Open File”.Reading a csv fileThe “Read csv file” window opens when a csv file is given.The csv file can be given on the command line:dfvuecsv_file.csvfrom within Python:fromdfvueimportdfvuedfvue('csv_file.csv')or being selected from the “Choose csv file” selector that opens when hitting
the button “Open File”.The “Read csv file” window reads the first 40 rows of the csv file with pandas’read_csvmethod using the options given in the pane. It shows the resultingpandas.DataFramein tabulated format. Changing focus from one option entry to
another, for example by hitting the <tab> key, re-reads the first 40 rows of the
csv file withpandas.read_csvusing the selected options in the form. Hitting
<enter> or <return> within the window reads the entire csv file using the
selected options and returns to the plotting panels. This is the same than
pressing the “Read csv” button in the lower right corner.The options in the form are pandas’read_csvdefault options except forparse_date, which is set toTrueinstead ofFalsehere. Hover over the
entry boxes to see explanations of the options in the tooltip.If the csv file includes a Date/Time column, it is best to set this column as
the index of thepandas.DataFrameby usingindex_col. Correctdatetimeis
indicated if the index has the data typedatetime64[ns]in the plot panels.
This is then correctly interpreted by the underlying Matplotlib when plotting,
zooming, or panning the axes.dfvuesets the index ifindex_colis used
but also provides the original column.missing_valueis not an option of pandas’read_csv. It is here for
convenience and any number entered inmissing_valuewill be added to pandasna_values.Scatter/Line panelHere is the Scatter/Line panel in macOS dark mode, describing all buttons,
sliders, entry boxes, spinboxes, and menus:The default plot is a line plot with solid lines (line style ‘ls’ is ‘-‘). One
can set line style ‘ls’ to None and set a marker symbol, e.g. ‘o’ for circles,
to get a scatter plot. A large variety of line styles, marker symbols and color
notations are supported.Installationdfvueis an application written in Python. If you have Python installed,
then the best is to installdfvuewithin the Python universe. The easiest
way to installdfvueis thence viapip:python-mpipinstalldfvueor viaConda:condainstall-cconda-forgedfvueWe also provide a standalonemacOS appand aWindows executablethat come
with everything needed to rundfvueincluding Python. The macOS app should
work from macOS 10.13 (High Sierra) onward (tested on mac OS X 10.15, macOS 11,
12, and 13). Drop me a message if it does not work on newer operating systems.See the installationinstructionsin thedocumentationfor more information.Licensedfvueis distributed under the MIT License. See theLICENSEfile for
details.Copyright (c) 2023- Matthias Cuntzdfvueuses theAzuretheme (v2.0) byrdbendeon Linux and Windows.Standalone applications are produced withcx_Freeze, currently maintained byMarcelo Duarte.