New users should start with our pre-built Windows and MacOS applications. More detailed download and launch instructions can be found at the Minerva website, in addition to complete instructions and tutorials.
The GitHub Pages site build is stored at minerva-story. The source code for the minified bundle is stored at minerva-browser.
The Python Flask server along with automated testing is stored at minerva-author. The React UI is stored at minerva-author-ui
All commands should be run in "Terminal" on MacOS and "Anaconda Prompt" on Windows.
First, download this repository through the git command line:
git clone https://github.com/labsyspharm/minerva-author.git
- Microsoft C++ Build Tools
- Install Anaconda
- Move openslide "bin" directory to "minerva-author/src"
- Run
conda install -c anaconda git
Then run the following commands to set up the development environment:
cd minerva-author
conda env create -f requirements.yml
conda activate minerva-author
Then run the following commands to set up the development environment:
cd minerva-author
conda env create -f requirements.yml
conda activate minerva-author
python src/app.py
-
Browser window should open automatically, if not then open a browser to
localhost:2020 -
Browse or copy the file path to an OME-TIFF or SVS
-
Click import and wait for the generation of a full pyramid
At minimum, you'll need to type one 'Group' name into the top dropdown to create a group. For each group you create, you can select channels from the second dropdown and set up their rendering settings with the various sliders. After you hit 'save', look in the directory of the executable (or app.py) for a new folder which contains the generated Minerva Story, with configuration files and an image pyramid.
The project contains automated tests using the pytest framework. To run the test suite, simply execute in the project folder:
pytest
All pushes to master will update the current draft relase.
To package the application as a standalone executable, run script:
bash package_mac.sh
Fetch OpenSlide binaries from https://openslide.org/download/#windows-binaries and save the .dll files to /src. Then run script:
package_win.bat