README-en.md edited on August 3, 2016 at 4:15pm

README-en.md

@@ -6,11 +6,12 @@
 
 [Verano 2016 - Ive - Coralys]
 
-Two common tasks when working with arrays of data is to search for and sort the data in ascending or descending order. Two well known simple sorting algorithms are the Selection Sort and the Bubble Sort. Sorting algorithms make up part of many programs; for example, contact lists, search engines, etc. In this laboratory experience, you will complete an application to process images and pratice the use of sorting algorithms. You will also learn about the `QImage` library from `Qt` and about the median filter used in image processing to remove noise, in this case, a pesky tourist.
+Two common tasks when working with arrays of data is to search for and sort the data in ascending or descending order. Two well known simple sorting algorithms are the Selection Sort and the Bubble Sort. Sorting algorithms make up part of many programs; for example, contact lists, search engines, spreadsheets, etc. In this laboratory experience, you will complete an application to process images and pratice the use of sorting algorithms. You will also learn about the `QImage` library from `Qt` and about the median filter used in image processing to remove noise, in this case, a pesky tourist.
 
-## Objectives
 
-1. Practice sorting arrays by selection and the bubble method.
+## Objectives:
+
+1. Practice sorting arrays by the selection and the bubble method.
 
 2. Practice the use of decision and repetition structures.
 
@@ -27,7 +28,7 @@ This laboratory experience is an adaptation of the nifty assignment presented by
 
 Before arriving at the laboratory you should have:
 
-1. Reviewed the selection sort and bubble sort algorithms.
+1. Reviewed the selection sort and the bubble sort algorithms.
 
 2. Familiarized yourself with the `push_back()`, `at(i)`,  `size()`, and `clear()` methods in the C++ `vector` class.
 
@@ -41,9 +42,9 @@ Before arriving at the laboratory you should have:
 
 ---
 
-## Pixels:
+## Pixels
 
-The smallest element in an image is called a pixel. This unit consists of a single color. Since each color is a combination of tones of the primary red, green and blue colors, it is coded as an unsigned integer whose bytes represent the tones of red, green and blue of the pixel (Figure 1). One fourth of a byte specifies what is known as the *alpha composition*, which defines the opacity of the pixel (0xff is completely opaque and 0x00 is completely transparent, i.e. invisible). This combination is known as the *ARGB* of the color for “Alpha-Red-Green-Blue”. For example a pixel of pure red has an RGB representation of `0xffff0000`, while a pixel of pure white has an RGB representation of `0xffffffff` (since the color white is the combination of the red, green and blue tones in their maximum intensity). Throughout this laboratory experience, we will assume the pixel’s alpha has total opacity (0xff).
+The smallest element in an image is called a pixel. This unit consists of a single color. Since each color is a combination of tones of the primary colors red, green and blue, it is coded as an unsigned integer whose bytes represent the tones of red, green and blue of the pixel (Figure 1). One fourth of a byte specifies what is known as the *alpha composition*, which defines the opacity of the pixel (0xff is completely opaque and 0x00 is completely transparent, i.e. invisible). This combination is known as the *ARGB* of the color for “Alpha-Red-Green-Blue”. For example, a pixel of pure red has an RGB representation of `0xffff0000`, while a pixel of pure white has an RGB representation of `0xffffffff` (since the color white is the combination of the red, green and blue tones in their maximum intensity). Throughout this laboratory experience, we will assume the pixel’s alpha has total opacity (0xff).
 
 ---
 
@@ -53,9 +54,9 @@ The smallest element in an image is called a pixel. This unit consists of a sing
 
 ---
 
-In `Qt`, a `QRgb` type is used to represent **ARGB** values. Using certain functions that will be described below we can obtain the red, green and blue components of the `QRgb` value of a pixel and manipulate the images. In this lab we will not manipulate the alpha channel of the pixels.
+In `Qt`, a `QRgb` type of data is used to represent **ARGB** values. Using certain functions that will be described below, we can obtain the red, green and blue components of the `QRgb` value of a pixel and manipulate the images. In this laboratory experience we will not manipulate the alpha channel of the pixels.
 
-Today’s laboratory experience will use the `QImage` class. This class permits access to the data of the pixels of an image to manipulate it. The documentation for the `QImage` class can be found in http://doc.qt.io/qt-4.8/qimage.html.
+Today’s laboratory experience will use the `QImage` class. This class allows access to the data of the pixels of an image in order to manipulate it. The documentation for the `QImage` class can be found in http://doc.qt.io/qt-4.8/qimage.html.
 
 ---
 
@@ -66,7 +67,7 @@ Today’s laboratory experience will use the `QImage` class. This class permits
 
 Image processing is used in a wide variety of socially relevant applications. People daily apply image processing filters to their pictures before posting them in a social media.  Social media, cameras, and mobile devices use image processing for face recognition. Researchers use image processing to count organisms inside a scanned space, to detect anomalies inside computer tomography (CT) scans, and in general to reveal information about scanned objects. 
 
-The median filter is one of the simplest filters used in image processing. It is very useful for removing undesired objects from images. Let's say that you encounter the most interesting tree in the world and you would like to photograph it.  You set up your photography equipment, the light is perfect, and the colors are beautiful. To be sure that you capture the perfect photo, you take three of them. However, at the exact moment that the photos were taken a pesky tourist photobombed your master creation.  The median filter will help you remove the tourist from the photo by merging the three photos into a tourist-free nature shot.
+The median filter is one of the simplest filters used in image processing. It is very useful for removing undesired objects from images. Let's say that you encounter the most interesting tree in the world and you would like to photograph it.  You set up your photography equipment, the light is perfect, and the colors are beautiful. To be sure that you capture the perfect photo, you take three of them. However, at the exact moment that the photos were taken, a pesky tourist photobombed your master creation.  The median filter will help you remove the tourist from the photo by merging the three photos into a tourist-free nature shot.
 
 Given three or more images of the same space, a median filter works as follows: for each pixel position $$(x,y)$$ find the median color among the images, then use the median color in the merged image.  
 
@@ -84,11 +85,12 @@ The *median* of a list of numbers is the value that separates halve the numbers
 
 For example, the median of {3,5,2,7,11} is 5 since the ordered array is {2, 3, 5, 7, 11}. The median of {3,9,3,2,10,11} is 6 since the ordered array is {2, 3, 3, 9, 10, 11} and the average of 3 and 9 is 6.
 
-### Median of pixels
+
+### Median of Pixels
 
 The method we will be using in this laboratory experience to acquire the median of various pixels will be the following: we will determine the median of its red, green and blue components, and then create a new pixel using these medians. The following example illustrates the procedure.
 
-#### Example:
+**Example:**
 
 Suppose we have to find the median of the three pixels with values `0xff223344`, `0xff112233`, and `0xff001155`.
 
@@ -100,6 +102,7 @@ Therefore, the median of the pixels will be `0xff112244`, composed of the median
 
 Notice that the result can be a pixel with a color that did not exist among the originals. Despite that, this detail does not affect the application we will be implementing in this laboratory experience.
 
+
 ---
 
 !INCLUDE "../../eip-diagnostic/pesky-tourist/en/diag-pesky-tourist-02.html"
@@ -156,7 +159,7 @@ The objects of the `QImage` class have the following methods that will be useful
 
 	`int greenContent = qGreen(originalImage.pixel(1,1));`.
 
-5. The following code assigns to the red component of the pixel `(1, 1)` of `editedImage` the average of the values of the red tone that are in pixel `(1, 1)` of `originalImage1` and `originalImage2` and does the same to the green and blue components.
+5. The following code assigns to the red component of the pixel `(1, 1)` of `editedImage` the average of the values of the red tone that are in pixel `(1, 1)` of `originalImage1` and `originalImage2`, and does the same to the green and blue components.
 
 ---
 
@@ -180,23 +183,23 @@ int main() {
 }
 ```
 
----
 
+---
 
 !INCLUDE "../../eip-diagnostic/pesky-tourist/en/diag-pesky-tourist-01.html"
 <br>
 
 
-
 ---
 
 ---
 
+
 ## Laboratory Session:
 
 The project `PeskyTourist` contains the skeleton for the application to remove the noise from an image. In today’s laboratory experience, you will complete the application to process images using the median filter to remove the noise of an image, in this case, a pesky tourist. You will be working in the `Filter.cpp` file.
 
-#### General algorithm to remove noise from an image
+#### General Algorithm to Remove Noise from an Image
 
 ```
 
@@ -211,7 +214,7 @@ Output: an image without noise
 
 ```
 
-## Exercise 1: Implement the function to order a vector of integers
+## Exercise 1 - Implement the Function to Order a Vector of Integers
 
 To find the median of the components of the colors in a pixel, we have to use a sorting function. In this part you will implement the Selection Sort.
 
@@ -239,7 +242,7 @@ To find the median of the components of the colors in a pixel, we have to use a
 5. Create a unit test to validate the `Sort` function and invoke it from the `RemoveNoise` function.
 
 
-### Exercise 2: Calculate the median of a vector of integers
+### Exercise 2 - Calculate the Median of a Vector of Integers
 
 #### Instructions
 
@@ -248,7 +251,7 @@ To find the median of the components of the colors in a pixel, we have to use a
 2. Create a unit test to validate the `Median` function and invoke it from the `RemoveNoise` function.
 
 
-### Exercise 3: Calculate the median of each pixel
+### Exercise 3 - Calculate the Median of Each Pixel
 
  Complete the `MedianPixel` function that receives a vector of pixels (of type `QRgb`) and returns the pixel `QRgb` corresponding to the median of the pixels. The median of the pixels is composed of the median of each color component of the pixels.
 
@@ -259,7 +262,7 @@ In the code we provide a function you can use to validate the `MedianPixel` func
 To compute the median of pixels, for each of the color components (red, green and blue), extract the component in a vector and invoke the function `Median` to calculate the median of this vector. For example, if we receive a vector with the pixels 0xff112233, 0x113344, and 0x224455, one of the first tasks of the algorithm would be to extract the red components and create a vector with them: 0x11, 0x11 y 0x22. Afterwards this vector will be sent to the `Median` function to obtain the median (and we will obtain 0x11 as a result). This will be done also for the green and blue components.
 
 
-### Exercise 4: Remove noise
+### Exercise 4 - Remove Noise
 
 Your last task is to complete the `RemoveNoise` function that receives a vector of images with noise and the reference to the edited image that will have the noise removed.
 
@@ -273,9 +276,9 @@ When you complete the function, the `Remove Noise` button will execute your algo
 
 ---
 
-##Deliverables
+## Deliverables
 
-Use "Deliverable" in Moodle to upload the `Filter.cpp` file that contains the functions you implemented in this laboratory experience. Remember to use good programming techniques, by including the names of the programmers involved, and documenting your program.
+Use "Deliverable" in Moodle to upload the `Filter.cpp` file that contains the functions you implemented in this laboratory experience. Remember to use good programming techniques, include the names of the programmers involved, and document your program.
 
 ---