Table of Contents

Overview

This is a temporary workflow until the JRSO has the opportunity to integrate image reduction in the CorrDownloader Correlation Downloader application.

To use images in the Correlator 4 application, you need to:

1. retrieve the correct images from the LORE;
2. place the images in a specifically named R directory;
3. run the provided R script to reduce and rename the images;
4. place the reduced images in the correlation data directory from where the Correlator app will import them.

Retrieve the images from LORE:

...

• img_redux_input
• img_redux_output

In the input folder, you :

• create a subfolder with the hole name, as in 'U1476A'

...

• place all images downloaded for that hole in the folder

...

• , as in:
  • img_redux_input/U1476A/(all image files for Hole U1476A)
• Note: you can keep the hole folders or delete them when you are done with a hole. Just make sure only one is not commented out in the script.

...

Modify the script to run the batch of images you want to reduce.8)    you need to change some lines so the script knows where folders are
a.    line 39 top_dir : here enter the directory path where the folder img_redux_input is. On a Mac open Terminal, and drag the folder from Finder into Terminal: Example: correlator:~daq$ /Users/daq/Documents/Exp392_StratigraphicCorrelation/Correlator_Exp392/ImageRedux/img_redux_input
=> now fill between the quotes: “/Users/daq/Documents/Exp392_StratigraphicCorrelation/Correlator_Exp392/ImageRedux/img_redux_input”
Do not use the ~daq$
b.    line 56: Change the test Name to the Hole Name Folder (U1579A) Name
Example ‘U1579A’
9)    Now run the script by clicking the RUN green arrow in R studio
10)    Wait and hope all is fine, takes a while to process the images, they should be in img_redux_output folder when successful
11)    Move images to other folder and import from there to Correlator

• If you name your top directories differently than shown in previous section, you need to adjust the folder names.
  • Ask your friendly technician if you struggle with directory paths.
  • Once this is set correctly, it should not bother you for the remainder of the project.
• Add or edit a line in section '1.3. Set the test'.
  • Typically, a test means running all image files of a hole, but it could also be any subset of images. Thus, you typically want:
    •  test="U1476A"
    • Note quotation marks! The test name must exactly match a subfolder name in the img_redux_input folder (or the script will create it).
  • You can overwrite the hole name for each test, or you can add test lines: the last one that is not commented out will be executed.
    • #test="U1476A"     #Will be skipped
    • #test="U1476B"     #Will be skipped
    • test="U1476C"      #Will be executed

Run the script:

• Save the changes to the script (recommended).
• Select all and press command-return or click the green RUN arrow.
• Get coffee and a cookie.
• The reduced images should be in the img_redux_output folder.
  • Images should each be in the order of ~200 kb, which is the maximum that Correlator can display.
  • The resulting size is based on the latest camera resolution and the reduction parameters set in the script. If you are working with older images that had half the resolution, the parameters might have to be adjusted in the script.

Place the reduced images in the Correlator folder

As recommended elsewhere, you should have a data folder for each site in your top folder from where Correlator is importing data, something like:

• .../StratigraphicCorrelation
  • IMG_REDUX
    • img_redux_input
    • img_redux_output
  • Site U1476
    • data_type-hole files from Correlation Downloader
    • hole folders with images from IMG_REDUX
  • Site U1477

Now move your test (hole) folder from the img_redux_output folder in the the site data folder.