From 5f19b088d4a3406e40ffb4cb7d5a40ad254e0525 Mon Sep 17 00:00:00 2001 From: Stephanie Quintana <81270711+stephaniequintana@users.noreply.github.com> Date: Wed, 15 Jun 2022 04:36:11 -0500 Subject: [PATCH 1/3] Update README.md Added sample images to Output section --- README.md | 23 +++++++++++++++++++++-- 1 file changed, 21 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 14655437..86d88467 100644 --- a/README.md +++ b/README.md @@ -119,6 +119,8 @@ The mathematical expression which is run on each pixel follows a syntax we've ca If you change to HSV mode, you can set a different expression for Hue, Saturation, and Value of the resulting pixel, and get a color image, but it's usually easier to just do that in the Colorize step (see below). Finally, in RGB mode, you can set a different expression for each channel of the resulting pixel, R, G, or B. This is useful for swapping channels, like displaying R as B. + + Read more about Infragrammar and modes here: * https://publiclab.org/infragrammar @@ -165,13 +167,23 @@ Colorizing code for both processors can be found at https://github.com/publiclab ## Outputs +The output of the above is dependent on the quality of the input. When using an "Infragram" multispectral camera, careful white balancing is essential for good NDVI images. The following are two examples of well-white-balanced images. + +| ![](https://storage.googleapis.com/publiclab-production/public/system/images/photos/000/018/533/thumb/Rosco_26_filtered.JPG) | ![](https://storage.googleapis.com/publiclab-production/public/system/images/photos/000/001/647/thumb/IMG_0025.JPG) | +|:--:| :--:| +| *by [@mathew](https://publiclab.org/profile/mathew) - try processing [this image](https://storage.googleapis.com/publiclab-production/public/system/images/photos/000/018/533/thumb/Rosco_26_filtered.JPG) on [Infragram](https://infragram.org/sandbox/index.html)* | *by [@warren](https://publiclab.org/profile/warren) - try processing [this image](https://storage.googleapis.com/publiclab-production/public/system/images/photos/000/001/647/thumb/IMG_0025.JPG) on [Infragram](https://infragram.org/sandbox/index.html).*| + +Read more about white-balancing at [https://publiclab.org/wiki/infrablue-white-balance](https://publiclab.org/wiki/infrablue-white-balance). + +### Final Results + Once the image is converted and (optionally) colorized, it can be downloaded. But there are two other options: -### Export to PublicLab.org +#### Export to PublicLab.org The image is encoded as a data-url and a new tab is opened with the Public Lab Editor at https://publiclab.org/post, with the image "sent" to become the main image. This is convoluted but easier than sending the image separately; see the [code for this here](https://github.com/publiclab/infragram/blob/34d330001e3869da9caf34cb79d6dc7650c1db83/index.html#L235-L248). Images then appear with the tag `infragram-upload` on this page: https://publiclab.org/tag/infragram-upload -### Export to Image Sequencer +#### Export to Image Sequencer Similarly, we can "send" the image to https://sequencer.publiclab.org, as a data-url although it may fail for very large images since we must [send it in a GET request](https://github.com/publiclab/infragram/blob/34d330001e3869da9caf34cb79d6dc7650c1db83/index.html#L250-L254). It is then run through a similar (but not identical, unfortunately) set of steps of conversion and colorizing, in the step-by-step interface of Image Sequencer, for fine-tuning. Learn more about this technique here: https://publiclab.org/notes/warren/08-02-2018/use-image-sequencer-for-ndvi-plant-analysis-with-a-modified-mini-sport-camera @@ -191,3 +203,10 @@ See the deprecation label for more on this code: https://github.com/publiclab/in ## Pi and VR versions Two extra folders `/pi/` and `/vr/` are for different variants of the project, designed to be run on a [Raspberry Pi-based camera](https://publiclab.org/infragram-pi) (live-streaming video through the converter from the Pi camera) and for use with a VR headset with a Pi camera attached to the front. These are experimental but if major breaking changes are implemented in the main `index.html` file, we would like them to be ported over to these files as well, especially the `/pi/` version, so the interfaces look and work the same. + + + + + + + From cc0868c6dda2fe063197f881db957e9df826f915 Mon Sep 17 00:00:00 2001 From: Stephanie Quintana <81270711+stephaniequintana@users.noreply.github.com> Date: Wed, 15 Jun 2022 04:38:45 -0500 Subject: [PATCH 2/3] Update README.md --- README.md | 10 ---------- 1 file changed, 10 deletions(-) diff --git a/README.md b/README.md index 86d88467..5cb2df42 100644 --- a/README.md +++ b/README.md @@ -119,8 +119,6 @@ The mathematical expression which is run on each pixel follows a syntax we've ca If you change to HSV mode, you can set a different expression for Hue, Saturation, and Value of the resulting pixel, and get a color image, but it's usually easier to just do that in the Colorize step (see below). Finally, in RGB mode, you can set a different expression for each channel of the resulting pixel, R, G, or B. This is useful for swapping channels, like displaying R as B. - - Read more about Infragrammar and modes here: * https://publiclab.org/infragrammar @@ -128,7 +126,6 @@ Read more about Infragrammar and modes here: Conversion with Infragrammar is handled by the Processor, described below. - ## Processors Two separate systems are available for converting and colorizing: `javascript` and `webgl`, both using the [HTML Canvas API](https://developer.mozilla.org/en-US/docs/Web/API/Canvas_API). The [javascript](https://github.com/publiclab/infragram/blob/main/src/processors/javascript.js) processor is simpler to read, write, and debug but is slower. The [webgl](https://github.com/publiclab/infragram/blob/main/src/processors/webgl.js) processor is MUCH faster but very hard to code/modify/change. @@ -203,10 +200,3 @@ See the deprecation label for more on this code: https://github.com/publiclab/in ## Pi and VR versions Two extra folders `/pi/` and `/vr/` are for different variants of the project, designed to be run on a [Raspberry Pi-based camera](https://publiclab.org/infragram-pi) (live-streaming video through the converter from the Pi camera) and for use with a VR headset with a Pi camera attached to the front. These are experimental but if major breaking changes are implemented in the main `index.html` file, we would like them to be ported over to these files as well, especially the `/pi/` version, so the interfaces look and work the same. - - - - - - - From f804c26bcfca34613c5bb45d0a3647a4eaf41811 Mon Sep 17 00:00:00 2001 From: Stephanie Quintana <81270711+stephaniequintana@users.noreply.github.com> Date: Thu, 16 Jun 2022 08:45:36 -0500 Subject: [PATCH 3/3] Update README.md Great addition, @jywarren - this'll come in handy when including them as samples on the sandbox page, too. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 5cb2df42..95953dde 100644 --- a/README.md +++ b/README.md @@ -168,7 +168,7 @@ The output of the above is dependent on the quality of the input. When using an | ![](https://storage.googleapis.com/publiclab-production/public/system/images/photos/000/018/533/thumb/Rosco_26_filtered.JPG) | ![](https://storage.googleapis.com/publiclab-production/public/system/images/photos/000/001/647/thumb/IMG_0025.JPG) | |:--:| :--:| -| *by [@mathew](https://publiclab.org/profile/mathew) - try processing [this image](https://storage.googleapis.com/publiclab-production/public/system/images/photos/000/018/533/thumb/Rosco_26_filtered.JPG) on [Infragram](https://infragram.org/sandbox/index.html)* | *by [@warren](https://publiclab.org/profile/warren) - try processing [this image](https://storage.googleapis.com/publiclab-production/public/system/images/photos/000/001/647/thumb/IMG_0025.JPG) on [Infragram](https://infragram.org/sandbox/index.html).*| +| *A red-filtered image by [@mathew](https://publiclab.org/profile/mathew) - try processing [this image](https://storage.googleapis.com/publiclab-production/public/system/images/photos/000/018/533/thumb/Rosco_26_filtered.JPG) on [Infragram](https://infragram.org/sandbox/index.html).* | *A blue-filtered image by [@warren](https://publiclab.org/profile/warren) - try processing [this image](https://storage.googleapis.com/publiclab-production/public/system/images/photos/000/001/647/thumb/IMG_0025.JPG) on [Infragram](https://infragram.org/sandbox/index.html).*| Read more about white-balancing at [https://publiclab.org/wiki/infrablue-white-balance](https://publiclab.org/wiki/infrablue-white-balance).