## Parameters

NameTypeDescriptionExpected ValuesDefault Value
sensorstringThe specific IR sensor."IRL" or "IRR""IRL"

## Description

The function returns the state of the specified IR sensor. It returns True if the current IR sensor value is greater than the threshold value, else False.

## Example ### IR Sensor Calibration – Python

The example demonstrates how to calibrate the IR sensors to detect black lines on the white surface in Python Coding Environment.

#### Logic

An IR sensor consists of 2 LEDs: one which transmits the IR light and one which receives the IR light. When the IR rays are transmitted, they bounce from the nearest surface and get back to the receiver LED. That’s how an IR sensor detects an object. But to detect colors, we depend on the number of rays the surface reflects:

1. The dark surface will absorb more IR rays and as a result, the receiver will get fewer IR rays. 2. White or shiny objects will absorb fewer IR rays and as a result, the receiver will get more IR rays. We can get the sensor values in PictoBlox and based on that value we can estimate whether the surface is black or white.

1. If the sensor detects the black line, its output value is increased. This means that the sensor is active.
2. If it detects the white area, its output value decreases. This means that the sensor is inactive.

We will call the threshold value above which the sensor detects the black line. If the sensor value is less than the threshold, it means that the sensor hasn’t detected the line yet. Alert: IR sensors DON’T work in sunlight. IR rays from the sun increase the overall threshold of the sensors therefore they stay active all time. A closed environment or nighttime is the place/time to work with your line following robot.

#### Code

``````sprite = Sprite('Tobi')

quarky = Quarky()

quarky.cleardisplay()
quarky.setirthreshold("IRL", 3000)
quarky.setirthreshold("IRR", 3000)

while True:
if quarky.getirstate("IRL"):
quarky.setled(1, 1, [0, 255, 0], 20)
else:
quarky.setled(1, 1, [255, 0, 0], 20)

if quarky.getirstate("IRR"):
quarky.setled(7, 1, [0, 255, 0], 20)
else:
quarky.setled(7, 1, [255, 0, 0], 20)``````

#### Calibrating the IR Sensors

Now, run the code by clicking the green flag and bringing the black line of the track close to the IR sensor. One of the following three conditions will happen:

1. Your calibration value is HIGH: The black region will not be detected in this case. Reduce the calibration value. 2. Your calibration value is LOW: The white region will not be detected in this case. Therefore, increase the calibration value. 3. Your calibration value is OK. The white and black regions are detected accurately. Now modify the script to add the detection value for the right IR sensor.

#### Output  ### Robot Pet – Python

The example demonstrates how to make a vertical robot pet that senses the hand on the IR sensor and acts accordingly in the Python Coding Environment.

#### Code

``````sprite = Sprite('Tobi')
quarky = Quarky()
import time

quarky.setorientation(2)
quarky.setirthreshold("IRL", 3000)
quarky.setirthreshold("IRR", 3000)

while True:
if quarky.getirstate("IRL"):
if quarky.getirstate("IRR"):
quarky.cleardisplay()

else:
pass
quarky.runrobot("LEFT", 100)
time.sleep(0.3)
quarky.stoprobot()

else:
pass
if quarky.getirstate("IRR"):
quarky.runrobot("RIGHT", 100)
time.sleep(0.3)
quarky.stoprobot()

else:
pass
quarky.showemotion("happy")
quarky.playsounduntildone("QuarkyIntro")``````

#### Output  ### Line Follower Robot – Full – Python

The example demonstrates how to make a line follower robot with Quarky in the Python Coding Environment.

#### Code

``````sprite = Sprite('Tobi')
quarky = Quarky()

# User Defined Functions
def LED_Feedback():
if quarky.getirstate("IRL"):
quarky.setled(1, 1, [42, 255, 0], 100)

else:
pass
quarky.setled(1, 1, [255, 0, 0], 100)

if quarky.getirstate("IRR"):
quarky.setled(7, 1, [42, 255, 0], 100)

else:
pass
quarky.setled(7, 1, [255, 0, 0], 100)

quarky.setirthreshold("IRL", 3000)
quarky.setirthreshold("IRR", 3000)

while True:
LED_Feedback()
if (quarky.getirstate("IRL") and quarky.getirstate("IRR")):
quarky.stoprobot()

else:
pass
if quarky.getirstate("IRL"):
quarky.runmotor("R", "FORWARD", 40)
quarky.runmotor("L", "BACKWARD", 25)

else:
pass
if quarky.getirstate("IRR"):
quarky.runmotor("L", "FORWARD", 40)
quarky.runmotor("R", "BACKWARD", 25)

else:
pass
quarky.runrobot("FORWARD", 40)``````

#### Output  ### Line Follower Robot – Simplified – Python

The example demonstrates how to make a simplified line following a robot with Quarky in the Python Coding Environment.

#### Code

``````sprite = Sprite('Tobi')
quarky = Quarky()

quarky.setirthreshold("IRL", 3000)
quarky.setirthreshold("IRR", 3000)
quarky.initializelinefollower(35, 40, 10)

while True:
if not (quarky.getirstate(35) and quarky.getirstate(34)):
quarky.dolinefollowing()

else:
quarky.stoprobot()``````

#### Output 