The derivatives tab will be used if and when the original file format is not jpg or png for images, or mp3 and ogg for audio, and webm for video. The image server (IIIF) that works with Spe_DAO requires image files to create the pyramidal tifs that are created for the zoom functionality. IIIF also hosts audio and video in the web browser, so these files must be converted to be compressed. You must create derivative files for any and all files that will be presented via the access system (ArcLight). 

Before you begin 

Note that the derivatives tool looks in the derivatives folder first to convert files with the “Input format” selected (docx, pdf, etc). This helps if you have already arranged your materials into the derivatives folder as it will convert all file formats within that folder without having to indicate a subpath for the masters folder (assuming that there are files within the masters that you don’t wish to convert). If there are multiple file formats, you will have to run the derivatives tool multiple times with for each input format. If you do not have any files in the derivatives folders, and do not indicate a subpath, it will assess all files in the masters folder with the indicated “Input format” and create derivative folders for each file found. 

Open

Required Fields for Images:

• Package ID:

  • The folder name of the SIP, such as apap301_h4fMLPL48CuxFPLpYxTmkL or ua950.009_qUQbs7GYhzmB3uL3yjH5uX.

• Input format:

  • File extension for preservation files in a SIP, such as TIF, PNG, or PDF.

  • You can only do one input format at a time, and unless specified, the Derivatives tool will scan all folders in derivatives for files matching that format and then convert them to the desired output format.

• Output format:

  • There are only three output formats: jpg (compressed images), png (larger images which are more helpful when wanting to convey a lot of detail), and pdf. PDFs cannot be used in the digital upload processes, but can be used to send scans to patrons per the Request Materials form. 

    • For output PDFs, all files in a folder will be combined into a PDF:

       ua809_JxkK2VWVFu7F8VWaTe72BG/

             derivatives/

                  book1.pdf

              masters/

                  book1/

                      page1.png

                      page2.png

                      ...

              metadata/

• For digital processing, the default format should be jpg unless otherwise specified by the archivist. If you believe that the jpg version is too small or distorts the image too much, please let an archivist know and we can determine if png would be a better format. 

• The output files will be added to newly created folders that are labeled with the same title as the original file from which it was derived. When uploading (by batch or single) you will need to link to the folder path instead of an individual file.

• Subpath (optional):

  • If you only wish to create derivative files from a certain folder from the masters directory, provide the file path here. As the tool scans the derivatives folder first it must be told to scan the masters folder first (by the subpath tool) and further narrowed by a file path

  • Must use forward slashes (/)

• Resize (optional):

  • Optionally resize argument for image conversion, sets maximum in pixels, such as '1000x1000'.

  • You should not resize images to be larger as it will distort the pixels, but you can downsize images to make them smaller or match other items within the same folder. 

• Density (optional): 

  • Optionally resolution argument for image conversion, such as '72' or '300'.

• Convert to monochrome image (only black and white) (optional):

  • Optional and rarely used.

Open

Required Fields for A/V derivatives:

• Package ID:

  • The folder name of the SIP, such as apap301_h4fMLPL48CuxFPLpYxTmkL or ua950.009_qUQbs7GYhzmB3uL3yjH5uX.

• Input format:

  • File extension for preservation files in a SIP, such as wav, mp3, mov, mp4,or m4v.

  • You can only do one input format at a time, and unless specified, the Derivatives tool will scan all folders in derivatives for files matching that format and then convert them to the desired output format.

• Output format:

  • There are only three output formats for a/v: ogg or mp3 for audio (if you have ogg, convert to mp3 and vice versa) or webm for video.

• Subpath (optional):

  • If you only wish to create derivative files from a certain folder from the masters directory, provide the file path here. As the tool scans the derivatives folder first it must be told to scan the masters folder first (by the subpath tool) and further narrowed by a file path

Note

• This process can take a while if there are many files that need to be converted.

• You may also need to run this step several times if there are multiple file formats within the same series or folder. All image files must be converted to their appropriate format before uploading.