Importing from Packages

Expressions and Built-in Functions in Python

Next Topic(s):

Created:
 11th of August 2024
01:56:02 AM

Modified:
 2nd of October 2024
07:31:24 PM

Importing from Packages in Python

Python's rich ecosystem of packages and libraries allows you to extend the functionality of your programs by importing pre-built modules. These packages provide specialized functions, constants, and classes that can be used to perform a wide variety of tasks, from mathematical operations to data visualization.

Why Import Packages?

Packages in Python allow you to reuse code and avoid reinventing the wheel. By importing a package, you can access a wide range of functions and utilities that have been tested and optimized, helping you to write more efficient and reliable code.

Commonly Used Packages

For civil engineers and other professionals, the following packages are particularly useful:

math: Provides access to mathematical functions and constants, such as sine, cosine, logarithms, and pi.
time: Useful for handling time-related tasks, such as measuring execution time, pausing execution, and working with dates and times.
os: Facilitates interaction with the operating system, including file handling, directory management, and environment variables.
string: Contains functions for processing and manipulating strings, such as formatting, searching, and splitting.
PIL (Pillow): A powerful library for image processing, including opening, modifying, and saving images.
matplotlib: A plotting library for creating static, animated, and interactive visualizations, useful for data analysis and presentation.

Math Functions and Constants

The math module provides a wide range of mathematical functions and constants. Here’s a table summarizing some of the key functions and constants:

Math Functions and Constants
Function/Constant	Description	Example Usage	Return Type
`math.pi`	The mathematical constant π (pi)	`math.pi`	float
`math.e`	The mathematical constant e (Euler's number)	`math.e`	float
`math.sqrt(x)`	Returns the square root of x	`math.sqrt(16)` → `4.0`	float
`math.sin(x)`	Returns the sine of x (x in radians)	`math.sin(math.pi/2)` → `1.0`	float
`math.cos(x)`	Returns the cosine of x (x in radians)	`math.cos(0)` → `1.0`	float
`math.log(x, [base])`	Returns the logarithm of x to the given base	`math.log(100, 10)` → `2.0`	float
`math.exp(x)`	Returns e raised to the power x	`math.exp(2)` → `7.3890560989306495`	float

Do observe the difference between functions and constants. The first two rows with math.pi and math.e return a constant, while the rest are functions that take an argument. We will see a little bit more on functions in the subsequent chapters.

Time Functions

The time module is useful for time-related tasks. Here’s a summary of some key functions:

Time Functions
Function	Description	Example Usage	Return Type
`time.time()`	Returns the current time in seconds since the Epoch	`time.time()` → `1629092108.123456`	float
`time.sleep(seconds)`	Pauses execution for the specified number of seconds	`time.sleep(2)` → Pauses for 2 seconds	None
`time.ctime(seconds)`	Converts a time in seconds since the Epoch to a string	`time.ctime(time.time())` → `Thu Aug 26 08:21:48 2021`	str

OS Functions

The os module provides functions for interacting with the operating system:

OS Functions
Function	Description	Example Usage	Return Type
`os.getcwd()`	Returns the current working directory	`os.getcwd()` → `'/home/user'`	str
`os.listdir(path)`	Returns a list of directory contents	`os.listdir('/home/user')` → `['file1.txt', 'file2.txt']`	list
`os.remove(path)`	Deletes the specified file	`os.remove('file1.txt')`	None

String Functions

The string module includes functions for string manipulation:

String Functions
Function	Description	Example Usage	Return Type
`string.ascii_letters`	Returns a string containing all ASCII letters (both lowercase and uppercase)	`string.ascii_letters` → `'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'`	str
`string.digits`	Returns a string containing all decimal digits	`string.digits` → `'0123456789'`	str
`string.punctuation`	Returns a string containing all punctuation characters	`string.punctuation` → '!"#$%&'()*+,-./:;<=>?@[\\]^_`{\|}~'	str

Image Handling with Pillow (PIL)

Pillow (PIL) is a powerful library for opening, manipulating, and saving image files:

PIL Functions
Function	Description	Example Usage	Return Type
`PIL.Image.open(fp)`	Opens and identifies the given image file	`image = PIL.Image.open('image.jpg')`	Image
`image.save(fp)`	Saves the image under the given filename	`image.save('new_image.jpg')`	None
`image.resize(size)`	Returns a resized copy of the image	`new_image = image.resize((100, 100))`	Image

Plotting with Matplotlib

Matplotlib is a versatile plotting library for creating static, animated, and interactive visualizations:

Matplotlib Functions
Function	Description	Example Usage	Return Type
`matplotlib.pyplot.plot(x, y)`	Plots `y` versus `x` as lines or markers	`plt.plot([1, 2, 3], [4, 5, 6])`	None
`matplotlib.pyplot.show()`	Displays the figure	`plt.show()`	None
`matplotlib.pyplot.savefig(fname)`	Saves the current figure to the specified file	`plt.savefig('plot.png')`	None

Key Takeaway

Importing packages allows you to leverage Python’s vast library of modules to perform specialized tasks efficiently. By understanding how to use these packages, especially in fields like civil engineering, you can significantly enhance your productivity and the capabilities of your Python programs.