Geinium
Home › A tour of the window

A tour of the window

The menu bar, the tool bar, the page bar on the left, the workspace, and the panels that can be opened beside it.

The window has five regions: the menu bar and the tool bar across the top, the page bar down the left edge, the workspace that fills the rest, and the status bar along the bottom. Panels for the project folder, the jobs and the log can be opened beside the workspace when they are needed; they start closed so that the page has the whole window.

The Home page of a new installation. Look at the three cards:
The Home page of a new installation. Look at the three cards: "Run MD" for one complex, "Batch queue" for many, and "Results" to open a finished job folder or a result bundle. The "Recent" list below fills with every result you open.

The regions

RegionWhat it is for
Menu barEvery command, grouped as File, Edit, View, Simulation, Analysis, Tools, Window and Help. Menus and shortcuts lists each command with its shortcut.
Tool barThe commands used most, described button by button below.
Page barOne button per page, from Home at the top to Simulate, with Settings at the bottom. The page shortcuts are Ctrl+1 to Ctrl+8 (the Viewer is F3).
WorkspaceThe page that is open.
Status barThe last message on the left; on the right, while a job runs, the job, its stage, the speed and the time left, with a progress bar. A warning such as "No hardware acceleration" or "3D view unavailable" appears here only when something needs attention.

The tool bar, button by button

ButtonWhat it doesWhen to use it
"Open"File > Open (Ctrl+O): structures, trajectories, plots, logs, project files and result bundles, each routed to the page that handles it.To look at any file Geinium reads.
"Open results"Opens a finished job folder, or a folder of jobs, on the Results page (Ctrl+Shift+O).To return to a job that is already done.
"Run MD"Opens the Run MD page for a new job (Ctrl+N).To simulate one complex.
Start queueRuns the waiting jobs of the batch queue (F5).After adding jobs, or to continue a paused queue.
PauseStops the running job at its next checkpoint (F6); starting again continues from there.To free the PC for a while without losing work.
Stop after stageLets the running stage finish, then stops.Before shutting the PC down at a clean point.
"Show in viewer"Loads the structure and trajectory of the open result into the viewer.To look at the motion behind a figure.
"Export results"Opens the export dialog for the open result (Ctrl+E).To write the PDF report, images and raw data.
Viewer beside pageShows the viewer to the right of the current page (F4).To compare a figure with the structure without switching pages.
CameraSaves the current viewer image (File > Save viewer image).For a quick picture of the view.
Project, Jobs, Log (right)Open or close the three panels (Ctrl+Shift+P, Ctrl+J, Ctrl+L).See Panels below.
Half-filled circle (far right)Toggles between the light and the dark theme (Ctrl+Shift+T).When the light around you changes.

A button that cannot act yet is greyed: "Show in viewer" and "Export results" need an open result, and the three queue buttons need waiting or running jobs.

The pages

PageWhat it is forChapter
HomeThe three ways in and the list of recent results.This page
Run MDOne complex: input, protocol, preparation, and the live monitor of the running job.The Run MD page
BatchA queue of complexes with shared defaults.The Batch queue
ResultsEvery figure and table of a finished job, several jobs side by side, and the export.The Results page
ViewerStructures and trajectories in three dimensions.The 3-D viewer
AnalysisSingle analysis tools and plots of .xvg files.The Analysis page
BuilderBuilding a system step by step with every option visible.The System Builder page
SimulateRunning a protocol of the Builder, a run input or a project, and following any run log.The Simulate page
SettingsTheme, data library, viewer and external command.Settings

Panels

Three panels can be docked beside the workspace. Each is opened from the right end of the tool bar, from View > Panels and tool bars, from the Window menu, or with its shortcut. They can be dragged to another edge or floated, and the layout is remembered; Window > Reset window layout restores the default with all panels closed.

PanelWhat it holdsWhen to open it
Project (Ctrl+Shift+P)A project folder with its file tree (double-click opens a file on the page that handles it) and the list of recent files. The folder button opens a folder; the plus button creates a new project folder with a project.json and the subfolders 00_input to 07_results. That layout is for organising your own files and is not the layout of a job folder (see Project file keys).When you work with files by hand, for example on the Builder or the Analysis page.
Jobs (Ctrl+J)Every job of the queue with the columns "Job", "State", "Stage", "Progress" and "Result", a summary line, and the buttons "Start queue", "Pause" and "Results". Double-clicking a finished job opens its results, a running job opens the monitor, any other job opens the Batch page.To follow a queue while you look at results on another page.
Log (Ctrl+L)Every message of the program with its time and level, a "Show" filter, "Save" and "Clear". See Monitoring a running job.When a stage reports a warning, or to keep a record of a session.
The Project panel docked on the left. Look at the folder bar with its two buttons (open a folder, create a new project folder), the file tree that shows only the file types Geinium reads, and the
The Project panel docked on the left. Look at the folder bar with its two buttons (open a folder, create a new project folder), the file tree that shows only the file types Geinium reads, and the "Recent files" list underneath.

Themes

The window follows the Windows light or dark setting by default. View > Theme switches to "Light" or "Dark" for this application, or back to "Follow Windows"; Ctrl+Shift+T toggles. Settings > Appearance > Theme holds the same choice. Figures are always drawn on a white sheet, in both themes, because that is how they will be printed and published.

The Home page in the dark theme. The
The Home page in the dark theme. The "Recent" list now holds one result, opened from P:\Geinium\Jobs.
The Results page in the dark theme. The window is dark, but the figure sheets stay white, exactly as they appear in the report.
The Results page in the dark theme. The window is dark, but the figure sheets stay white, exactly as they appear in the report.

Display scaling

The window follows the display scaling set in Windows. Controls, text, tables and figures scale together, and the layout reflows: the cards of the Home page stack when the window is narrow, the System Builder changes from two columns to one, and the buttons of the Batch page wrap onto a second line. The three pictures below show the same Results page on three screens.

A 1920 x 1080 screen at 125 % scaling. All three columns of the overview fit.
A 1920 x 1080 screen at 125 % scaling. All three columns of the overview fit.
A 2560 x 1440 screen at 150 % scaling. The same layout with larger type.
A 2560 x 1440 screen at 150 % scaling. The same layout with larger type.
A 3840 x 2160 screen at 200 % scaling. Look at the right edge and the bottom: no control is cut off, and the tables scroll inside their cards rather than pushing the page wider than the window.
A 3840 x 2160 screen at 200 % scaling. Look at the right edge and the bottom: no control is cut off, and the tables scroll inside their cards rather than pushing the page wider than the window.