Archival Manual | Cataloging Images

Assigning Image Numbers

Historically, images in the MVZ Archives were cataloged in a separate collection with a unique series of image numbers. To maintain continuity, new images are assigned numbers in the same series regardless of whether they are formally cataloged in the Archives or whether they are linked to cataloged records in other MVZ collections.

Uploading Images to TACC

All media are uploaded to the Texas Advanced Computing Center (TACC) for web access. Media should be uploaded at their original resolution. After they are ingested onto the web server, they will be processed into lower resolution versions for web viewing or listening.

The basic steps are as follows:

  1. Become a TACC user. All MVZ media are uploaded to a project titled “MVZ-Media-Archives” through the TACC User Portal. In order to access the project, you need to be added as a user.
  2. Secure FTP to Corral. Use a secure FTP site to transfer files to the Corral system at TACC. You will need a TACC token for authentication. See the Arctos Handbook for instructions on how to do that. Be sure to place files in the appropriate directory. Archival images go into one of two directories:
    1. tif files: subfolder MVZ_Img —> images
    2. jpeg files: subfolder MVZ_Img —> born_jpeg
  3. Contact TACC. Email Chris Jordan at TACC to notify him that there are media ready to ingest.
  4. Remove files. One media are ingested, remove them from the Corral directory so that you don’t mix old files with new ones that are added later.

Links to TACC directories with MVZ archival images:

High resolution photos (not born jpeg)https://web.corral.tacc.utexas.edu/MVZ/images/MVZ_img/images/
Web version photos (not born jpeg)https://web.corral.tacc.utexas.edu/MVZ/images/MVZ_img/images/jpg/
Thumbnail version photos (not born jpeg)https://web.corral.tacc.utexas.edu/MVZ/images/MVZ_img/images/tb/

High resolution photos (born jpeg)https://web.corral.tacc.utexas.edu/MVZ/images/MVZ_img/born_jpeg/
Web version photos (born jpeg)https://web.corral.tacc.utexas.edu/MVZ/images/MVZ_img/born_jpeg/jpg/
Thumbnail version photos (born jpeg)https://web.corral.tacc.utexas.edu/MVZ/images/MVZ_img/born_jpeg/tb/

Linking Images in Arctos

Once the media have been uploaded and ingested at TACC, they will be processed into jpeg and thumbnail versions for web viewing. Born digital jpeg files will be processed to a lower resolution jpeg version as well as a thumbnail.

After the media files have been processed, they are ready for linking to data in Arctos. If there are just a few media, this step can be done by creating media directly in Arctos (also see “How to Create Media” in the Arctos Handbook). Alternatively (e.g., for larger data sets), you can bulkload a media metadata file with basic information about the media and its relationship(s) to other data.

Creating media directly in Arctos

Login to Arctos. You will need “Manage Media” permissions in order to create, upload, or edit media.

If the media is of a cataloged record (specimen or observation):

  1. Search for the cataloged record.
  2. In the Media block on the specimen detail page, click on “Attach/Upload Media” (link in upper right corner).
  3. For most media, we will use Option 2 (Create Media from URL). This assumes that the media (web version and thumbnail) are at TACC. There may be times when you want to upload media directly (e.g.,  a text file with data, a scan of related correspondence, etc.), in which case you can use Option  1 (Upload Media). This will upload media directly, but will not put the files into one of our existing directories.
  4. Complete all fields (see screenshot below):
    1. URL: This should be the web version (jpeg file). For born digital files that are already in jpeg format, use the file in the jpg subdirectory that has the “web” prefix.
    2. Preview URL: This is the thumbnail version in the “tb” subdirectory..
    3. Media Type: image.
    4. Mime Type: image/jpeg.
    5. License: Select “CC BY” (Creative Commons with Attribution).
    6. Relationship: Shows cataloged_item (this is automatically selected if you’re creating media from the cataloged record).
    7. Created by Agent: Person who took the photograph. Enter the last name and hit the tab key to select the person from the Agents table.
    8. Description: A description of the media, e.g., “Dorsal view of MVZ:Bird:85693.”
    9. Made Date: The date that the image was created.
    10. Click on Create Media.

Bulkloading media metadata to Arctos

  1. Login to Arctos. You will need “Manage Media” permissions in order to create, upload, or edit media.
  2. Go to Batch Tools —> Bulkload Media Metadata
  3. Download a CSV template, or use one of the sample spreadsheets provided below. Fill out the metadata and save the file in CSV format. (Tip: Use a Text Editor such as Textpad to check the file and remove any extra rows at the bottom. Excel typically adds one extra row, but sometimes there are more.)
  4. Choose a file to upload, and click on “Upload this file.”
  5. Be patient! It takes a while to process, so refresh your screen periodically. The Status column in the Media Bulkloader (in “My Stuff“) will show “pass” if the data look good.
  6. The Status column also will show any errors with the data (e.g., if the media URI provided in the data is invalid). You will need to fix and reload any data with errors.
  7. Once the data pass their check, they will be in the queue to load. Again, be patient! The time to load depends on what else is in the queue.
  8. Once they have loaded, values in the Status column will change from “pass” to “loaded.” You will receive an email indicating the number of loaded records in the Media Bulkloader. Delete the records by going to “My Stuff” (accessible only if you’re logged in) in the Media Bulkloader: DELETE from temp media where status = anythingloadeds