Prerequisites: [wiki:SoftwareOverviewControl Control Systems Overview] = Lesson 1: Getting Started = If you want to tell a computer to do something, you have to communicate with the computer in a programming ''language''. When we say language, we mean it. A language has words and grammar and everything else, just like French. Computers, despite what you may think, are dumb. They do only exactly what you tell them to, and don't guess or interpret. If say to your Mom or Dad "Hey, can you bring me that thing?", there's a (slim) chance they may bring you the right "thing". A computer wont. Ever. Just a cold, unfeeling "'''ERROR'''". A programming language is very precise, and to tell a computer what you want, you have to be precise too. In this training session, we'll introduce programming to you, and make some things work. You know, those ''things''. Hang on, it gets harder from here. (A quick note...If you know all this already and are getting bored...CONGRATULATIONS! Here's a '''[https://www.youtube.com/watch?v=x94yTpv0T1k link]''' to some cute corgi puppy videos as your reward. Then, come back and dive into a later section. This is all self-paced.) We'll be starting with a programming language called [https://www.python.org/ Python], specifically Python 3. There are a lot of programming languages. Some are created because they're better for solving certain problems, others because people are bored and want to try something new. Python has been around for a while, and its pretty popular because its easy to use. The team uses Java to control the robot but that language is a little trickier. We'll get to that one later once you get a handle on the basics. Python, like every programming language, has a structure. Here are the big parts: * ''Variables'': Things you assign to and read from. Like in Algebra. `a="Dump Truck"` sets the variable A to the string "Dump Truck". You can set them to numbers to or fancy things like lists. They're basically the nouns. * ''Control Structures'': These are instructions like IF this is true THEN do that…. These are like grammar rules, like use active voice, or use punctuation. * ''Functions'': These do things. They take nouns as arguments, do something, and can return nouns. In `redCar = paintCarRed(blueCar)`, `paintCarRed` is a function. They're the verbs, they do things, and they take variables and return variables. Some functions are built in to Python, but you can create your own. * ''Libraries'': A lot of other people have written functions to do things. A lot of things. When these things are bundled together they're called libraries. You can tell a computer to use a library and save your self a lot of typing. Much like in English, you blend all of these together to create stories, or ''programs''. Both have a beginning middle and end. So lets write the first program that all programmers start with: "Hello World" {{{ #!python a="Hello World" print(a) }}} This tells the computer to print, you guessed it, "Hello World" Now you try it...Do the following: 1. Then highlight the code above, right click and click `Copy`. This put the code on the clipboard so you can share it with another window. 1. Go [https://www.tutorialspoint.com/execute_python3_online.php here]. This site is our code editor for training purposes, and its pretty cool. You can put code in the center section, and click '''Execute''' to run it. The lower window shows the results. 1. On that page, highlight all the code already in the center window. 1. Right click and pick `Paste`. This should replace everything in the window with the contents above. 1. Finally click `Execute` right above the center window to run the program. You can see the results in the green box below (it scrolls, so look at the last lines) (From now on, we'll call this step "''Go [https://www.tutorialspoint.com/execute_python3_online.php here] and run the code above''". (Just come back to these steps if ever you forget how to do that). After a bit, you'll be rewarded with the following message in the bottom window: {{{ Hello World! }}} The program told the computer to print the value of variable a on the screen. And, boom, now you're a programmer. The rest of learning how to code is just more details. This is the end of Lesson 1. = Lesson 2: Control Structures = In lesson 1, we had you create a program, "Hello World". Now, "Hello World" is not too exciting if you want to program robots, but its an important first step. We showed you how to run a function (or verb) `print`, which does something (shows on the screen the value of its argument `a`, where `a` is assigned the value "Hello World". If you want to do more in a program and actually make decisions in your code, we need to introduce control structures. == If-Then-Else: Decide, already! == Take the program below, it uses an If-Then-Else control structure to ask the program to make a decision, and run code based on that decision. You'll use these all the time. {{{ #!python location = 'HERE' print("Welcome to our store\n") if location == 'HERE': print("We're here! Come on in\n") print("Our ours are 11:00am-11:52am\n") else: print("Go away, we're out eating tacos\n") print("Hope you had a good time") }}} ''Go [https://www.tutorialspoint.com/execute_python3_online.php here] and run the code above.'' It should print: {{{ Welcome to our store We're here! Come on in Our ours are 11:00am-11:52am Hope you had a good time                                                                                                                                                                                                                             }}} Three things to note about this program: 1. The double equals in location=='HERE' on the first line. It is called an ''expression''. In this case it is an equals expression (other kinds of comparisons in python are listed here) . It returns ''True'' when the condition evaluates to ''True'', otherwise its ''False''. Note on that line the word 'HERE' is in quotes. That's to indicate its a string (a text value) not some variable (which doesn't exist). If you used ''='' instead of ''=='' it wouldn't work as you expected because it would be a variable assignment. If a IF-THEN-ELSE statement ever behaves in an unexpected way, check for this problem first, its a really common mistake. 1. Spacing and indents are important in Python. the line "We're here..." and the line below it are indented to indicate they are part of a statement ''block'' that runs when the condition evaluates to ''True''. The second block on the else is run when the condition to ''False'', and only contains one line. If you want to do stuff outside of the IF-THEN, don't indent it like the first and last print statements. 1. You'll see that a few of the print statements end with a \n. This is called a ''escape sequence'', and its shorthand for a newline. When the computer sees it in a print statement, it will add an extra line to the output. [[Here|https://www.quackit.com/python/reference/python_3_escape_sequences.cfm]] are some other escape sequences you can use. Now, in the editor replace the line with the if ''expression'' with {{{ if location == 'Poughkeepsie, NY': }}} and run it again. What happens? It should print "Go away, we're out eating tacos". Why? If I was in Poughkeepsie, I'd be out eating tacos too. Yummmm, tacos. If you're writing your own code, you don't want to provide an ''else'', just omit the word else: and the indented block you want to run with it. For example: {{{ #!python medianSalary=98260 #Median annual salary of a software engineer in the US. Yes, really. salary=90000 if salary > medianSalary: print("Whohoo! Dinner's on you!") }}} ''Go [https://www.tutorialspoint.com/execute_python3_online.php here] and run the code above.'' It should print: {{{ }}} Yep, nothing was output. Nada. In this case, we used variables which were numbers, and a greater-than expression to compare them. Since the condition was ''False'', nothing was printed. (Also note the text in the code that starts with a # sign. The pound sign and everything after it on that line is called a ''comment'', and its a way to put some notes in the code that the program doesn't run. The robotics team wants you to put comments in your code a lot--it makes the code easier to read and understand. And we like it when we can understand you.) Now for a couple of other control structures that you should know... == For Loop: Stop Hitting Yourself! == The For loop control structure runs code repeats over a variable. Try running this one: {{{ #!python fruits = ['banana', 'apple', 'mango'] for fruit in fruits: print("Current fruit :", fruit) print("That's alotta fruit!") }}} It should output: {{{ Current fruit : banana Current fruit : apple Current fruit : mango }}} This example loops over an ''array'' (a fancy word for a list) of fruits, and prints each value out, each line starting with the text "Current fruit:". To understand this, pretend that the FOR loop has a big arrow in pointing to the first value in the fruits ''array''. The first time it runs, this arrow,{{{fruit}}} is pointing to the first value in the ''array'', {{{banana}}}, which it then sets to be the value of the index variable ''fruit''. After it prints the message, the for loop senses through arcane magic that there are other values in fruits, so it just moves the pointer to the second value and repeats. After the third fruit, the loop knows there's nothing left so FOR loop exits and prints "That's alotta fruit!" Note that the "Current fruit..." print statement is indented. Just like in a IF-THEN-ELSE control structure, you can run a block of of multiple lines of code in a for loop, just indent all the lines. For loops are handy if you want to avoid repeating yourself in code, and do the same thing over and over again. The less code you write, the less chance you can make a mistake. Not to mention its easier to read. == While Loop: One more time around the block, Alfred! == A While loop is the more charming cousin of the FOR loop, this one repeats as long as its condition is ''True''. If the condition is false when it gets to the While loop, the While loop wont run at all. {{{ #!python count = 0 while (count < 9): print ("The count is:", count) count = count + 1 count = count + 1 # Yup, lets do it again because we're E-VIL print("Good bye!") }}} ''Go [https://www.tutorialspoint.com/execute_python3_online.php here] and run the code above.'' It should print {{{ }}} Oh no, I'm tired, so I'm not going to tell you the answer for this one. You should be seeing a pattern by now. You tell me---what should it print? Count starts out at 0, and as long as count is less than 9 it will run the code in the block, then it will print "Good bye!". What else does it print out? == Compound Control Structures: Here a Control Structure, There a Control Structure, Everywhere a Control Structure... == Lastly, you can combine all three of these in any sort of combination, and nest them. This is how you do real work in a program. For example, try running this one: {{{ #!python count=1 while (count<=7): if (count==4): print("more!") else: print(count, "potato,") count+=1 print("score!") }}} What does it output? See how the indenting works when nesting? Note that `count+=1` is shorthand for `count=count+1` because not typing those extra characters __could save your life__. Now, modify the code to make it repeat the word potato each time based on the current value of count, and run it. When you're done, the output should look like: {{{ 1 potato 2 potato potato 3 potato potato potato more! 4 potato potato potato potato 5 potato potato potato potato potato 6 potato potato potato potato potato potato 7 potato potato potato potato potato potato potato score! }}} Yeah, this is a little harder, but I bet you can do it. Ask a neighbor for help if you need to. I'll give you three hints: 1. You can tell a print to not end with a new line by adding an end="" to the print statement, like this `print("Im a teapot!",end="")`''. '' 1. An empty print statement `print("")` just prints a new line, basically wrapping any line you're on. 1. If you want to loop over a set of numbers, use a `range()`. For example, `for x in range(0,5)` will make x go from 0 to 4 incrementing 1 each time it loops. The first number is where x starts, and the second number is where x will stop __minus 1__. Don't ask why---its just the way computers and programs work. Don't believe me? Fine. [https://softwareengineering.stackexchange.com/questions/110804/why-are-zero-based-arrays-the-norm Don't say I didn't warn you.] The solution is [wiki:ProgrammingAnswerPotatoExercise here]. This concludes Lesson 2. = Lesson 3: Functions = So are you tired of just printing stuff yet? In the last lesson, we introduced you to all sort of ways to make decisions and loop over code to make your program easier to read and shorter too. Functions do things in your code. You've already used two: print (yes that's a function), and range (assuming you did the last exercise of the last less and didn't cheat). The actual code run in these functions can be pretty big. Imagine if you had to type it out every time you wanted to use it. That would get old, confusing, and error prone fast. Functions can take variables arguments as input, and may return variables as output. Here's a few handy functions built in to Python: * `input(prompt)`: Prompts the user for input by showing the prompt screen, returning whatever the user entered after they hit . * `pow(x,y)`: Return x^y^ * `round(x,[n])`: Rounds a decimal number x to n digits after the decimal point. The [] means that the n is optional, if you don't include it, n=0. * `sum(iterable)`: Sums all the numbers in the list ''iterable''. * `.isdigit()`: Strings and some other variable types like lists have some special functions just for them, called methods. This one returns true of all of the digits in the string are numbers, others are [[https://docs.python.org/3/library/stdtypes.html#string-methods|here]]. '123' would return ''True'', "Cat" would return ''False''. Handy for validation. You call them *on* the variable itself, and it has to have a value before you can call these methods. * `int(string)`: Converts an string to a number (so you can do things like math on it). Here's some examples of how they're used (don't forget to look at earlier lessons for range() and print(). {{{ #!python a=input("Enter a number, any number-->") # Enter something at the prompt. Program will wait at this point. print(a); b = pow(2,2) print(b) #Result is 4 (2 to the power of 2) c = round(3.14159, 2) print(c) #Result is 3.14 d = sum([1,2,3,4]) print(d) #Result is 10 e = "123" f = e.isdigit() print(f) #Result is True g = int("123") print(g) #Result is 123 }}} Try running these yourself, making sure the results are as expected. You can even combine these functions with control structures to do some interesting stuff, and even nest them. For example, try running this (entering values for x and why when prompted. Try putting in non-numeric or decimal values too): {{{ #!python x="" # Put a dummy string in x and y so both while-nots below work. Pretty slick, eh? Programming uses tricks like this all the time. y="" while not x.isdigit(): # Note the "not"...in this case if x is not all digits, run the block of code in the while loop x=input("Enter x-->") while not y.isdigit(): y=input("Enter y-->") z = pow(int(x),int(y)) if z > 100: print("That's-a big number!") else: print("Aw, its only",z) }}} '''But wait, there's more'''...you can create your own functions. That way, if you come up with cool way to do something you can reuse it and don't have to repeat yourself as much. For instance: {{{ #!python def singHappyBirthday(age, names): # a custom function for name in names: for count in range(0, age): print("Happy Birthday to You!") if count == age-2: print("Happy Birthday, Dear", name) singHappyBirthday(6,['Milla', 'Emma']) # now use it. }}} Run this one. What does it output? A lovely happy birthday song for two kids? Now imagine if you had to write a program to print out a happy birthday for every single person in your grade without it. It'd get pretty ugly, fast. The keyword `def` is used in Python to indicate a custom function, and you have to ''def''ine it in your program before you use it. This function takes an argument of an age, and second argument of a list of names. The "singHappyBirthday" line at the end actually ''calls'' or runs the custom function, with the two arguments it needs. A function can return a value too, by using the Python keyword `return` for example: {{{ #!python def isOver9000(power): if power>9000: # you could also express this if-then-else statement as "return power>9000" return True else: return False isGokuPowerfulEnough = isOver9000(9001) print(isGokuPowerfulEnough) }}} Now your turn... Modify the 'That's-a big number" exercise above, adding a custom function called called inputNumber to input one number, and use it instead of repeating the while-not stuff. Run it and verify the output is the same. Much easier to read, no? By using functions, you can perform powerful operations that are built in the to the language, or someone created. These function in turn can use other functions and build on top of them to make more advanced programming commands. This concludes lesson 3. Here's the [[ThatsaBigNumberSolution|solution]] == Lesson 4: Libraries == Now that you seen the basics of the Python language, and have created your own functions. Its time to see what else is out there. It turns out there are A LOT of libraries out there for python that do pretty much everything you want, from advance machine intelligence, to 3D graphics, to yes controlling robots. These libraries were created by others and are offered for free, and others may be offered at a cost. You can find these libraries by googling for with the term " python library". For example "spell check python library". This turns up [https://pythonhosted.org/pyenchant/ PyEnchant] which describes how to use and access the library.  There are probably others. To use it in code, you use the !`import` keyword in Python like so:   {{ #!python import enchant d=enchant.Dict("en_US")  # Selects the US english dictionary bad=check("Helo") good=check("Hello") }} It would be a enormous effort to create your own spell check library, so this saves a lot of time.   We'll be using this when we program robots because a lot of work has already been done. [[[wiki:ProgrammingReserve Programming]Archive | Programming Archive]]