Advanced Options (for Developers)
for FirstGlance in Jmol
These checkboxes apply to PDB Id's submitted from the form, and
also to the Gallery (when opened after a checkbox is changed).
The options checked below will be displayed at the bottom of the main entrance
to FirstGlance (where you specify the PDB code)
in red. These options can also be
specified in links to FirstGlance.
Report All JSmol Command Scripts, Their Execution Times + "Gaps" Between Scripts.
For developers testing/optimizing FirstGlance javascript.
A separate browser tab lists all scripts
along with their execution times,
facilitating scrutiny for inefficiencies.
Click the red T (for "Timing") below JSmol to generate the report.
- Mechanism:
When checked, the query parameter eltim=1 is passed to e.g.
fg.htm, which then sets eltimActive to true.
Every Javascript variable and function involved contains "eltim" (for ELapsed TIMes).
An earlier partial implementation uses variables and functions containing "elapsed".
These are now adapted to participate in the eltim reports.
(The boolean reportElapsed is now obsolete, but unused code may remain.)
-
JSmol Command Scripts:
Listing of all scripts sent to JSmol, and their execution times, is automatic.
Script recording occurs in the javascript function unchangedScriptToJmol(spt).
All JSmol command scripts pass through this function except a few instances that
call jsmolScript(spt) directly.
-
Within-Script Execution Times:
To report execution times at stages within a single script, the JSmol script command
javascript reportElapsed(locationDescription) must be inserted manually
into the script. This is done by including makeReportElapsedSpt(locationDescription)
in the script string.
These report "MidSPT" times.
("Script" is often abbreviated as "Spt" in the Javascript.)
See existing examples.
When this option is unchecked, calls to reportElapsed() have no effect.
-
"Gaps":
Reporting of execution times for FirstGlance Javascript (not within JSmol, termed "gaps"
between scripts)
requires manual insertion of calls to the Javascript function
reportElapsed(locationDescription).
See existing examples, which report "MidGAP" times.
When this option is unchecked, calls to reportElapsed() have no effect.
Debugging Mode (for developers modifying or testing the
FirstGlance javascript). Sets debugscript on, opens the Jmol console,
and displays other debugging information. When checked, the query
parameter db=1 is passed to e.g. fg.htm, which then sets
top.debuggingFG to true.
Feedback to