Metadata-Version: 2.1
Name: fluxvis
Version: 1.0.0a2
Summary: Visualize floppy disk flux patterns
Home-page: https://github.com/adafruit/fluxvis
Author: Jeff Epler for Adafruit Industries
Author-email: jeff@adafruit.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown

<!--
SPDX-FileCopyrightText: 2022 Jeff Epler for Adafruit Industries

SPDX-License-Identifier: CC-BY-4.0
-->

# Flux Visualize

Produce flux visualization from any flux files recognized by greaseweazle

Visualization of a Commodore 1541 floppy as mastered by fluxengine:

<p align="center"
   
![Visualization of Commodore 1541 floppy as mastered by fluxengine](https://github.com/adafruit/fluxvis/raw/main/etc/disk.jpg)
</p>

When a fluxengine-style CSV file with decoder information is supplied, the interpretation of each portion of the disk is shown:
<p align="center"
   
![Colors show interpretation of disk structure](https://github.com/adafruit/fluxvis/raw/main/etc/diskcolor.jpg)
</p>

 * Blue: metadata
 * Green: successfully decoded data
 * Red: data could not be decoded

# Usage
 * `pip install fluxvis`

 * Get your flux in a greaseweazle-compatible format such as `.scp` or in the ".a2r" format.

 * Use a commandline like
   ```
   python -mfluxvis --tracks 35 --diameter 108 --stride 2 write dos33.scp dos33.png
   ```
   or
   ```
   python -mfluxvis --tracks 35 --diameter 108 --stride 2 show dos33.scp
   ```

# Credits

Flux reading is done via embedded copies of
[greaseweazle](https://github.com/keirf/greaseweazle) and
[a2rchery](https://github.com/a2-2am/a2rchery).  Thanks to @keirf and @a2-4am
for these tools!  See the source code for additional information.


