Instant Clue is a Python based desktop application (GUI) using the PyQt6 (since 0.12.0) library for data visualization and analysis. The software was developed to equip everyone with a tool that enables analysis and visualization of high dimensional data sets in an easy and playful way.
Please find the executables for Windows and Mac in the Releases section.
A written tutorial is available at the Wiki Page. Please let us now in the discussions for urgent topics to cover in the tutorial. We are now focusing on providing much better introduction material to get you started swiftly. We are working on video tutorials which will be available here https://www.instantclue.de.
We are establishing a web application to share app graphs with collaborators. The website is available at https://app.instantclue.de and will be avaiable for everyone soon.
The master branch is the developing branch. For each release (not dev. builds) a new branch with the version number is created. Please put pull requests to the master branch.
Please report Issues and Bugs using the GitHub issue functionality.
Please open a discussion to suggest new features and/or discuss new plot types. But also urgent tutorial topics. (We are at the moment working intensively on the Wiki Page so please take a look.)
First download the code and extract it. Open terminal (mac) or command line tool (windows) and navigate to instantclue/src/main/python Then create a virtual environment to not mix up required package versions with your python installation using
python3 -m venv env #mac
source env/bin/activate # activate env
or
py -m venv env #windows
.\env\Scripts\activate
Then use the requirements.txt file to install required packages and finally start InstantClue. Please be aware that the package combat is not in the requirements table because it has very specific versioning requirements of pandas and numpy. Therefore we recommend to install combat first and then install the remaining packages and ingore the warning about the numpy/pandas version mismatch (so far it works in the tests). Please note that using Pyinstaller requires some optimization. If you want to create your own executable please contact us for custimized hooks.
pip install -r requirements.txt #install packages
python3 main.py #starts InstantClue
If you found usage of Instant Clue useful within your scientific publication, please consider to cite the original article was published in Scientific reports. However, really any acknowledgement of Instant Clue is highly appreciated.
Nolte et al. Instant Clue: A Software Suite for Interactive Data Visualization and Analysis, Scientific reports 8, 12648 (2018)