Preparing Live View documents for the Imperial college Data Repository

This document describes the general principles behind preparing a live view or live preview display of data deposited in the Imperial College Data Repository.

Preparing the files for live preview: Isosurfaces prepared using CubGen in compressed JVXL format

The files necessary to produce a live view, as illustrated by DOI: 10.14469/hpc/6273

1. The root document, index.html, which contains the Javascript commands to load a JSmol window. An example of this document can be downloaded here.
2. A stylesheet, table.css An example of this document can be downloaded here
3. A DOI resolver script, needed if the data file has been registered with a repository and issued a DOI identifier. This can be here
4. A .XYZ coordinate file for the molecule. An example can be seen here
5. A JVXL compressed isosurface file. An example can be seen here
6. Any required image files, an example of which is here. Use SVG if possible to ensure accurate scaling.

Actions

1. Initiate a data deposition, using https://data.hpc.imperial.ac.uk/publish/
2. Complete the title and description boxes and then upload all the files above, other than the root document index.html
3. Now edit the root document index.html to include the various data files in the following manners
   1. The coordinate and isosurface files will be transcluded into the root document using the following syntax
      <a href="javascript:displayLocalCub('J6_den.cub.xyz', 'J6_den.cub.jvxl', 'NCI surface')">View NCI surfaces</a>
   2. Image files are included by first determining the URL of the the specified image. Thus the image example above can be obtained by "right clicking" the link to the file from the just uploaded file list, which will appear something like:
      https://data.hpc.imperial.ac.uk/resolve/?doi=6273&file=2 Use this URL in invoking the HTML instance, as eg
      <img align="right" alt="" src="https://data.hpc.imperial.ac.uk/resolve/?doi=6273&file=2">
   3. If you want to load a data file directory from the repository rather than uploading a copy as described above, then invoke it as:
      <a href="javascript:show_jmol();javascript:handle_jmol('10.14469/hpc/5085',%20';frame 18;font label 16;zoom 140;spin 3;set echo bottom left;font echo 20 serif bolditalic;color echo green;echo methyl axial, N eq;')">(<i>S</i>,<i>R</i>,<i>S</i>)</a>
      where 10.14469/hpc/5085 is eg the DOI of the (in this case assumed) Gaussian deposited data.
4. When the index.html document has been appropriately customised with the items above, it can be uploaded to the data set as per above. It should now produce a live display of the files, as specified above.
5. You may find the index.html has to be edited a number of times before the final version is accepted. Take care to label each version with a version number (root document, V5). You cannot delete old version, you can only add new ones.

Preparing JVXL files