A Beginner’s Guide to Python for Data Science - Part 5 Adding Comments in Python

 



In the last article, we introduced statements and indentation in Python.

Next, let’s discuss commenting in Python.
Comments are descriptions of the code under consideration. So we can write one or more lines of explanation.

There can be times when you need to write some long and complicated code for a task. After it is complete, you might save the file somewhere, but when you refer to the code sometime in the future, let’s say, after three or four months, you may not be able to understand the code you have written yourself!

To help yourself and anyone going through your code, in the hope of understanding its utility, you should generously use comments to clarify the written code.

Commenting is necessary, especially for the complicated functions you might have created for a specific task.

There are a few ways to declare a comment inside Python. The easiest way is to use a hash symbol (#).

When we use the hash symbol inside our code, the python interpreter ignores whatever is present after the hash sign.

Let’s take the example where we used the “for loop” to print the first ten numbers. Now, say we are sharing this code with someone who doesn’t understand how “for loops” work and what should be the expected output. We can help the person by writing a comment just before the code, as shown below:
# A for loop to print the numbers from 1 to 10
for i in range(1, 11):
print(i)

You can observe that when you run the above code, Python does not complain about the explanation we have written because it just ignores it, thanks to the hash symbol.
Let’s write the previous comment in multi-lines.
# A for loop to print
# the numbers from 1 to 10
for i in range(1, 11):
print(i)

The second method to write multi-line comments is via the use of triple quotes, as shown below:
'''A for loop to print
the numbers from 1 to 10'''
for i in range(1, 11):
print(i)

So, whenever you need to write a multi-line comment for any code, my suggestion is the triple quotes for the task. It would be easier to comment using them than the hash symbol on every line.
And there we have it.If you found this useful, you can check the below book and have a copy for yourself by going to :


Thank you for reading.

Until next time!

Comments

Post a Comment

Popular posts from this blog

A Beginner’s Guide to Python for Data Science - Part 1 Installing the required software

Image
  Let’s discuss how someone interested in coding and data science can begin their journey. You see many people learning Python and data science. Once they have their data analyst or data scientist jobs, they lead a comfortable lifestyle thanks to the value their skillset generates for society, directly allowing the individual to earn a lot of money. You decide to give it a try, and you get yourself a laptop. Now, the questions you get are something like the following: Where do you begin? Which course do you take? These are critical questions to be answered if you want to reach your desired goal. With the available options on the internet, you might feel a little dizzy just going through choices of the various courses. This article is my attempt to make your journey a little more comfortable. I will focus on the Python language, but be aware that we have many coding languages to choose from for learning this skill set. We will begin by installing the required software for learning data
Read more

A Beginner’s Guide to Python for Data Science - Part 2 Creating our first python project

Image
  In the  last article , we introduced the software installation process required for data science in python. In this blog, we will begin creating our first project in Pycharm. We can open Pycharm and click on the plus sign to create a new project, as shown below: Now, as soon as you click on create the project button, you will go to another screen where you have to mention the desired project name, as shown below: The default project name is ‘untitled’, as shown in the image above. Next, we see a small triangle shape symbol under the “Location” part of the screen. When we click the triangle, Pycharm provides us with many options, as shown below: In the options above, we see one titled “New Environment Using”. If we click the drop-down menu, we see one of them is “Conda”, which is short for “Anaconda”. We need to select this option before clicking on the Create button to be sure that we are creating the new environment using anaconda distribution. One important thing you should remembe
Read more

A Beginner’s Guide to Python for Data Science - Part 4 Statements and Indentation in Python

Image
  In the  last article , we introduced the jupyter notebook and its functionality. Now that we have learnt the basics of the jupyter notebook, it’s time we get to the meat of the matter, i.e. time to start learning Python. Statements: The first thing we will discuss is “Statements and Indentation”. A Statement is any instruction or set of commands given to Python, or we can say that a statement is any code executable inside Python. So a simple addition that we performed while checking the installation is an example of a statement. There are two types of statements that you would generally see in Python, they are: Single-line statement. Multi-line statement. Let’s see an example of a multi-line statement. We will add the first six numbers for the task. We will run the following command: my_variable = (1 + 2 + 3 + 4 + 5 + 6) As soon as we print the variable we see that we get the sum of desired numbers. In the above code, I entered the entire addition in one line, which could also have b
Read more