How To

This page explains how you can make your own collation model using the VisColl 1.0 SIMS Collation Modeler, and then create an HTML+SVG package using the SIMS Collation Visualizer.

The creation of a visualization using the SIMS implementation of VisColl involves three separate steps

  1. Create a Collation Model using the SIMS Collation Modeler
  2. Create an Image List
  3. Generate a Collation Visualization using the SIMS Collation Visualizer

Step one: Create a Collation Model

SIMS Collation Modeler Tutorial

To create a collation model, use the Collation Modeler form (currently at http://tinyurl.com/CollModel/ and described at https://github.com/demery/collation-modeling)

Export the Leaves XML from the Collation Modeler.

Step Two: Create an Image List

This step is only necessary if you want to link your collation diagrams to image files, creating virtual bifolia. If you only need the diagrams, you can skip to the third step.

In addition to the Leaves XML file, you will also need to have a file listing URLs to images, matched with the folio or page number for those images.

The simplest way to create this file is using Excel. First, create a spreadsheet with folio or page numbers in the first column, and the corresponding image URL in the second column (do not include column headings). For example (urls are false):

1rhttp://project.org/image1r.jpg
1vhttp://project.org/image1v.jpg
2rhttp://project.org/image2r.jpg
2vhttp://project.org/image2v.jpg

If you are using manuscripts from OPenn, you can use the template spreadsheet here to build your image list using this Spreadsheet on Google Docs (you will eventually need to past data into Excel, so be sure you have Excel installed and open on your computer): 

https://docs.google.com/spreadsheets/d/1AGVSWzRT5nMjs-y6MO5qhfN2ygGZQMfeawCr3mf3W-Q/edit?usp=sharing

Follow the instructions on the first tab.

However you generate your Image List, you will need to save the file as an XML file in Excel (Save As -> Excel 2004 XML Spreadsheet).

 

SIMS Collation Visualizer Tutorial

To generate a Collation Visualization, go to this site:

http://138.197.87.173:8080/xproc-z/visualize-collation/

(please email Dot at dorp@upenn.edu if the Collation Visualizer is not working)

Load the Collation Model and the Image List where indicated.

Click “Submit”. In a few moments, you will be asked to download a .zip file containing the full Collation Visualization (in HTML). There will be one HTML file for each quire, plus a folder of supporting materials. You will need to keep everything together in order for it to work.

NOTE: Some computers are downloading the .zip file in which the file name is surrounded by single quotes (i.e., literally, ‘VisColl.zip’). Your computer will not recognize the .zip’ file extension and will be unable to open this file. You will need to edit the file name and remove the single quotes. Once you do this, your computer will recognize the file type and will be able to open it. So, if your computer can’t open the file after downloading, check to see if it has single quotes around it.

The Collation Visualization online tool uses XProc-Z, developed by Conal Tuohy and available at his github: https://github.com/Conal-Tuohy/XProc-Z

Many thanks to Conal for incorporating the XSLT files found in this repository into the XProc pipeline that runs as Collation Visualization.

%d bloggers like this: