List of things we want to include
Adding steps about the tools and installing those tools ( rawtherapee, mobaxterm)
Steps in rawtherapee
Pics or screenshots will be very helpful
Provide video overview
Backlog Spreadsheet:
| Lref gdrive file | ||
|---|---|---|
|
| Table of Contents | ||
|---|---|---|
|
1. Download Batch
When downloading a Field batch, we must be navigated navigate to the correct location. We can use Use this string of commands:
| Code Block |
|---|
cd .. cd psa _images/field_tools/ python3 fielddownload_SUNNYraw_pipelinebatch.py <batch_name> |
2. Color Profiling in RawTherapee
...
| Code Block |
|---|
./RawTherapee_5.8.AppImage |
Be sure we are located within the field_tools folder.
RawTherapee will launch in an separate window and open to the most recent profile that has been worked on. Select the appropriate batch and allow it to load. Scroll through and make a mental note if some images are out of the ordinary (i.e. too bright, too dark, out of focus, etc.).
...
We want to use an image with a color checker, if one is available within the batch. Choose the most average looking picture (lighting and color-wise). If they all look reasonably similar, we can choose whichever we want.
...
*In Field applications, we typically use a large Color Checker is typically used. The Semifield Color Checker may might be used instead, but the larger one is preferred for this application. Either is acceptable.
...
To bring in a recent profile, we use find the folder icon towards the top right of the screen, located to the left of the save button. This will open a window containing a list of saved profiles within the local user. We want to choose Choose the most recent date in relation to the one we are working on now. The toggle tool is helpful for name and date modified, making it easier to find most recent profilesimage being worked on.
2.22 Color Picker
Once a previous profile is loaded in and applied, we want to use the color picker tool. The Color Picker tool is accessible by found on the tool bar above the working image or on “Pick” within use the White Balance tab on the panel to the right. Choose “Pick”.
...
Only one square on the Color Checker is used for in this application. Referring to the image above, the gray we want is residing two squares above the black is the color to use. Use this gray for every profile you make.When finished, be sure to choose . Choose the hand icon to return to normal cursor mode.
2.23 Adjust exposure & saturation
Now, we navigate into the Exposure tab. This is the only tab we will work used in preprocessing, aside from the tab to access the Color Picker. There are only a few helpful settings to toggle here.
Our The goal is to create an image that looks most closely like a real-life view of these plants. Our eyes are The human eye is the most accurate check, but it can be helpful to keep an eye on reference the color graph in located on the top left that of the scree. It shifts when settings are changed. A good rule of thumb is for the peak of the three curves to land near this region of the graph.
...
*Laptop screens and Monitor settings will impact what we are working onperception of images. Try to always use the same screen when creating color profiles.
Exposure Compensation & Highlight Compression
These two go hand-in-hand. Exposure compensation should always be set to slightly more than Highlight Compression
Lightness
Has a similar effect to Exposure Compensation
Saturation
Toggle keeping in mind the intensity of colors on the color checker.
2.24
...
Save, apply,
...
adjust,
...
exit
...
Before exiting the program, we must apply our the new profile to the rest of the images within in the batch. This can easily be done by:
CRTL+A
Right click
Hovering over Processing profile Operations
Hovering over Apply
Scrolling/Hovering to the desired profile
Selecting profile
Wait for profile to apply to all images
Sometimes, applying to all images takes a bit of time to complete. RawTherapee will not allow clicking out of the selected images or scrolling unless it has finished applying to the selected images. We will know what images have had a new profile applied to them by looking for the There will be a gray check icon in the upper left corner of the individual imageimages, the new profile has been applied.
...
If most images look acceptable and a handful , but some do not, we can choose select images by holding the CTRL key and clicking each image. Once all are selected, find the tab labeled “Batch Edit” on the right-side panel. Stick with toggling Toggling the same sliders we changed from earlier. Do this until satisfied with the results. No need to re-save anything. As long as every imaged image within the batch’s folders of our batch have the grey check mark, we are ready it is okay to exit RawTherapee and send the batch into the pipeline.
3. Running the pipeline
When the color profile has been saved, we must send it through it is time to send the batch into the pipeline. Be sure to be navigated Navigate to the Field folder and make if not already there. Make a new screen, use . Use uppercase r (-R) to create a new screen. If returning to an already existing screen, use lowercase r (-r) with the appropriate screen name.
...
To exit the screen, use CTRL+A D
...
4.
...
Checking the success of the pipeline
If there is an indication the pipeline is finished running, we want to crosscheck the # of images within the original batch with the # of JPGs and PP3s created.
We can use both of these lines respectively:
| Code Block | |
|---|---|
| wide | ls /mnt/research-projects/r/raatwell/longterm_images3/field-batches/<batch>/developed-images/*.jpg | wc -l |
| Code Block | ||
|---|---|---|
| ||
ls /mnt/research-projects/r/raatwell/longterm_images3/field-batches/<batch>/developed-images/*.pp3 | wc -l |
And compare to The # of ARWs should be 0. Check using:
| Code Block | breakoutMode | wide
|---|
ls /mnt/research-projects/s/screberg/longterm_images/field-batches/<batch>/*.ARW | wc -l |
As long as the output # we get from each of these of the first two commands are equivalent , we know we have successfully applied to each other the color profile has successfully been applied to every image in the batch.
If the # of JPGs and PP3s are not equivalent to the original # of images, try running the pipeline again within the same screen. Double check the name of the batch that was typed in, this is where errors are likely to happen. Also, be sure to be navigated to the Field Semifield folder. If we are within the Semifield navigated to the Field folder, the pipeline will run successfully.
not be successful.
Example: TX_2023-09-29
Step 1 : Cross-check the original image count to the Backlog spreadsheet
| Code Block |
|---|
ls /mnt/research-projects/r/raatwell/longterm_images3/field-batches/<batch>/developed-images/*.pp3 | wc -l |
The output number should equal the sum of the batch (if applicable: add 01+02+02, etc.)
Common & Useful Commands
Available batches:
| Code Block | ||
|---|---|---|
| ||
ls /mnt/research-projects/r/raatwell/longterm_images3/field-batches/ -lh |
# of ARW:
| Code Block | breakoutMode | wide
|---|
ls /mnt/research-projects/s/screberg/longterm_images/field-batches/<batch>/*.ARW | wc -l |
# of PP3 created:
| Code Block | breakoutMode | wide
|---|
ls /mnt/research-projects/r/raatwell/longterm_images3/field-batches/<batch>/developed-images/*.pp3 | wc -l |
# of JPG files processed:
| Code Block | breakoutMode | wide
|---|
ls /mnt/research-projects/r/raatwell/longterm_images3/field-batches/<batch>/developed-images/*.jpg | wc -l |