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.

1. 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. An 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

This will use the following resource: https://www.ch.ic.ac.uk/rzepa/cub2jvxl/ where you will find options to upload a variety of property files. Others can be added on request to Henry Rzepa These JVXL isosurfaces are all generated from a Gaussian Cube file, containing the property desired. This cube file can in turn be generated using eg Gaussview, from the Results/surfaces/contours menu option of that program. There you will have the option of specifying a resolution for the generated cube. In the first instance, use the coarse cube until you are sure the property computed is what you want.
The document has DOI: 10.14469/hpc/9536

2. XY plots