-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
cbbd5c3
commit e514744
Showing
1 changed file
with
38 additions
and
2 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,7 +1,43 @@ | ||
# GoVizzy Usage | ||
|
||
## Running GoVizzy | ||
## Launching GoVizzy | ||
See the build and run documentation [here](build.md). | ||
|
||
## Basic Usage | ||
TBD | ||
### Setup | ||
After launching GoVizzy, select the box containing %run Main.py and run it. | ||
|
||
### Console | ||
The console displays all status and error messages generated by GoVizzy. To view the console, click on the ledger icon in the bottom bar. | ||
|
||
### File Entry | ||
Enter the location and filename of a .cube file in the text box below the logo. If the cube file is valid, GoVizzy will make a copy of the .cube file, then plot it. | ||
If the .cube file cannot be found or is malformed, a messaged will be printed on the console. | ||
|
||
## Plot Controls | ||
All plots shown by GoVizzy can be interacted with. They can be rotated on all three axes by clicking and dragging. Additionally, they can be zoomed by scrolling on them. | ||
|
||
## New, Save, and Exit | ||
On the bottom right of the GoVizzy window are two buttons, "New Cube" and "Save". On the top right is a red exit button. | ||
|
||
### New Cube | ||
The "New Cube" button closes the current visualization and provides a textbox where a new .cube file can be specified. The previous visualization will be completely lost, unless saved beforehand. | ||
|
||
### Save | ||
The "Save" button exports the visualization as it current appears to an image file. **Not currently implemented.** | ||
|
||
### Exit | ||
The exit button terminates the GoVizzy application within Jupyter Notebook. GoVizzy can be relaunched by restarting the kernel in Jupyter Notebook, and following the Setup steps above. | ||
|
||
## Menus | ||
GoVizzy provides two different menus, "Slice Options" and "Mesh Options." The menu is switched using the drop down on the top right of the GoVizzy window. "Slice Options" is the default. | ||
The state of each menu is preserved when switching between them. | ||
|
||
### Slice Options | ||
The "Slice Options" menu provides the controls for 3D slices; 3 slider and checkbox pairs. Each checkbox controls whether or not the slice plane for that axis will be shown. | ||
The corresponding slider controls where the slice plane is located along its axis. One or multiple of the slice planes can be present simultaniously. | ||
|
||
### Mesh Options | ||
The "Mesh Options" menu provides controls for the 3D mesh visualization of the .cube file. Each atom in the visualization has its own submenu. Click on the atom name to reveal its menu. | ||
On the atom submenus, the visibility, color, and scaling factor for the atom can be controlled. Each atom is controlled individually, and any number of atoms may be modified simultaniously. | ||
|