Chapter 2: Programming Karel

The simplest style of Karel program uses text to specify a sequence of built-in commands that should be executed when the program is run. Consider the simple Karel program below. The text on the left is the program. The state of Karel's world is shown on the right:

Press the "Run" button to execute the program. Programs are typically written in a special application called an Integrated Development Environment (IDE) and most Karel programs are written in an IDE called PyCharm. Like an IDE, this reader has the ability to execute programs in order to help you see how things work as you learn.

Understanding the Program Structure

The program is composed of several parts. The first part consists of the following lines:

# File: FirstKarel.py
# -----------------------------
# The FirstKarel program defines a "main"
# function with three commands. These commands cause
# Karel to move forward one block, pick up a beeper
# and then move ahead to the next corner.

These lines are an example of a comment, which is simply text designed to explain the operation of the program to human readers. Comments in both Karel and Python begin with the characters # and include the rest of the line. In a simple program, extensive comments may seem silly because the effect of the program is obvious, but they are extremely important as a means of documenting the design of larger, more complex programs.

The second part of the program is the line:

from karel.stanfordkarel import *

This line requests the inclusion of all definitions from the karel.stanfordkarel library. This library contains the basic definitions necessary for writing Karel programs, such as the definitions of the standard operations move() and pick_beeper(). Because you always need access to these operations, every Karel program you write will include this import command before you write the actual program.

The final part of the Karel program consists of the following function definition:

def main():
    move()
    pick_beeper()
    move()

These lines represent the definition of a new function, which specifies the sequence of steps necessary to respond to a command. The function definition consists of two parts: The first line constitutes the function header and the indented code following is the function body.

The first word in the function header, def, is part of Python's syntactic structure. It says that you are creating a new function. The next word on the header line specifies the name of the new function, which in this case is main. The main() command plays a special role in a Karel program. When you start a Karel program it creates a new Karel instance, adds that Karel to a world that you specify, and then issues the main() command.

How the Program Executes

The effect of running the program is defined by the body of the main() function, which is a sequence of commands that the robot will execute in order. For example, the body of the main() function for the FirstKarel program is:

move()
pick_beeper()
move()

Thus, if the initial state of the world matches the example given in Chapter 1, Karel first moves forward into the corner containing the beeper, picks up that beeper, and finally moves forward to the corner just before the wall.

Programming Challenge

The FirstKarel program defined above doesn't do very much as yet. Let's try to make it a little more interesting. Suppose that the goal is not simply to get Karel to pick up the beeper but to move the beeper from its initial position to the center of a ledge.

From here, the next step is to turn left to begin climbing the ledge. That operation is easy, because Karel has a turn_left() command in its standard repertoire. However, Karel's language includes a turn_left() command, but no turn_right() command.

At this point, you have your first opportunity to begin thinking like a programmer. You have one set of commands, but not exactly the set you need. What can you do? Can you accomplish the effect of a turn_right() command using only the capabilities you have? The answer, of course, is yes. You can accomplish the effect of turning right by turning left three times. After three left turns, Karel will be facing in the desired direction.

Chapter 2: Programming Karel

The simplest style of Karel program uses text to specify a sequence of built-in commands that should be executed when the program is run. Consider the simple Karel program below. The text on the left is the program. The state of Karel's world is shown on the right:

Press the "Run" button to execute the program. Programs are typically written in a special application called an Integrated Development Environment (IDE) and most Karel programs are written in an IDE called PyCharm. Like an IDE, this reader has the ability to execute programs in order to help you see how things work as you learn.

Understanding the Program Structure

The program is composed of several parts. The first part consists of the following lines:

These lines are an example of a comment, which is simply text designed to explain the operation of the program to human readers. Comments in both Karel and Python begin with the characters # and include the rest of the line. In a simple program, extensive comments may seem silly because the effect of the program is obvious, but they are extremely important as a means of documenting the design of larger, more complex programs.

The second part of the program is the line:

This line requests the inclusion of all definitions from the karel.stanfordkarel library. This library contains the basic definitions necessary for writing Karel programs, such as the definitions of the standard operations move() and pick_beeper(). Because you always need access to these operations, every Karel program you write will include this import command before you write the actual program.

Function Definitions

The final part of the Karel program consists of the following function definition:

These lines represent the definition of a new function, which specifies the sequence of steps necessary to respond to a command. As in the case of the FirstKarel program itself, the function definition consists of two parts that can be considered separately: The first line constitutes the function header and the indented code following is the function body.

The first word in the function header, def, is part of Python's syntactic structure. It says that you are creating a new function. The next word on the header line specifies the name of the new function, which in this case is main. Defining a function means that Karel can now respond to a new command with that name.

The main() command plays a special role in a Karel program. When you start a Karel program it creates a new Karel instance, adds that Karel to a world that you specify, and then issues the main() command. The effect of running the program is defined by the body of the main() function, which is a sequence of commands that the robot will execute in order.

Available Karel Commands

კარელი - მეორე თავი

ძირითადი ბრძანებები და კარელის პროგრამირების საფუძვლები

Chapter 5: Control Flow with Karel

Control flow is one of the most important concepts in programming. It allows Karel to make decisions and repeat actions based on conditions. In this chapter, we'll explore how to use if statements, while loops, and other control structures to make Karel behave intelligently.

While Loops

A while loop allows Karel to repeat a set of commands as long as a certain condition is true. This is incredibly useful when we don't know exactly how many times we need to repeat an action. For example, Karel can move forward until hitting a wall, or pick up beepers until there are none left.

If Statements

The if statement allows Karel to make decisions. Karel can check a condition and execute different code depending on whether the condition is true or false. You can also use else to specify what should happen when the condition is false.

Try It Yourself!

Below is an interactive code editor where you can write Karel programs. Try modifying the code to make Karel perform different tasks. Click Run Code to see your program in action!

Common Patterns

Here are some common control flow patterns you'll use frequently with Karel:

• Move to wall: Use while front_is_clear(): move()
• Turn right: Call turn_left() three times
• Turn around: Call turn_left() twice
• Clear all beepers: Use while beepers_present(): pick_beeper()

Chapter 5: Control Flow with Karel

Control flow is one of the most important concepts in programming. It allows Karel to make decisions and repeat actions based on conditions. In this chapter, we'll explore how to use if statements, while loops, and other control structures to make Karel behave intelligently.

While Loops

A while loop allows Karel to repeat a set of commands as long as a certain condition is true. This is incredibly useful when we don't know exactly how many times we need to repeat an action. For example, Karel can move forward until hitting a wall, or pick up beepers until there are none left.

If Statements

The if statement allows Karel to make decisions. Karel can check a condition and execute different code depending on whether the condition is true or false. You can also use else to specify what should happen when the condition is false.

Try It Yourself!

Below is an interactive code editor where you can write Karel programs. Try modifying the code to make Karel perform different tasks. Click Run Code to see your program in action!

Common Patterns

Here are some common control flow patterns you'll use frequently with Karel:

• Move to wall: Use while front_is_clear(): move()
• Turn right: Call turn_left() three times
• Turn around: Call turn_left() twice
• Clear all beepers: Use while beepers_present(): pick_beeper()