The process of iteration is omnipresent in the Python language. Iteration enables the items within a collection to be indexable, and provides sequence types the capability to preserve the order of a sequence. An iterable is a class that contains the collection of data and the iter function – which in turn invokes the iterator. An iterator is a class which contains its very own ‘iter’ function, which returns itself, and invokes the ‘next’ function that continues with the process of iteration till the limit of the collection has been reached.

The class 'Polygon' accepts the number of vertices (greater than or equal to 3) and the circumradius of a polygon as input arguments. The various functions within the class calculate the measures of interior angle, edge length, apothem, area and perimeter for the polygon, till two places after decimal.

Brief descriptions of the functions defined within the Polygon class are as follows:

The initializer function defines that the class accepts two parameters - the number of vertices of the polygon whose properties have to be calculated, and the circumradius of the same. Circumradius is expressed as the radius of an imaginary circle that can be inscribed around the polygon.

Polygon(numberofvertices, circumradius)

The dunder method of representation function describes the messages that are displayed when the class Polygon is called without an argument.

Polygon() (this invokes the repr function)

The dunder method of equality has been defined to compare and return with an affirmative when the dimensions - number of vertices and circumradii - of two input polygons are equal.

polygon1 == polygon2

where, polygon1 = Polygon(numberofvertices1, circumradius1), polygon2 = Polygon(numberofvertices2, circumradius2)

The dunder method of greater than has been defined to compare and return with an affirmative when the number of vertices of one input polygon is greater than the other.

polygon1 > polygon2

where, polygon1 = Polygon(numberofvertices1, circumradius1),
polygon2 = Polygon(numberofvertices2, circumradius2)

A brief description of the test cases that have been employed for the respective functions are as follows:

Finally, the class has been converted into a module. It has been successfully demonstrated that the module can be incorporated and initiated as per the usage protocols.

This class creates a sequence of polygons with varying number of vertices and the same circumradius. The least possible number of vertices that a polygon can possess is three. The index of the sequence corresponds to the number of vertices in the polygon (which means that index values under 3 are not accepted). The circumradius is assumed to be the same for all the polygons. Brief descriptions of the functions defined within the Polygon class are as follows:

The class is initialized in a way that it can accept the arguments of maximum vertices and circumradius.

PolygonSequence(maxvertices, circumradius)

The dunder method of length returns the number of polygons that are present within the sequence.

len(PolygonSequence(maxvertices, circumradius))

The dunder method of getitem returns the item in the sequence as per the index or the slice.

custompolygon[3]

or

custompolygon[5:9:1]

where custompolygon = PolygonSequence (maxvertices, circumradius)

The dunder method returns the instance of iterator class, which will make the iteration run till the length of the dataset.

The dunder method of representation returns the polygon with the maximum number of vertices and the common circumradius.

PolygonSequence()

A polygon that has the highest area to perimeter ratio is denoted as the maximum efficiency polygon. This function finds the polygon which has the maximum efficiency among all the others within the sequence.

PolygonSequence(maxvertices, circumradius). maximum_efficient_polygon()

A brief description of the test cases that have been employed for the respective functions are as follows:

Finally, the class has been converted into a module. It has been successfully demonstrated that the module can be incorporated and initiated as per the usage protocols.

The class PolygonSequenceIterator has been implemented to function as an iterator. In consistence with the features of an iterator class, it has both the ‘iter’ and the ‘next’ functions within them. Brief descriptions of the functions defined within the Polygon class are as follows:

The class is initialized in a way that it can accept the arguments of maximum vertices and circumradius. In addition, in order to maintain the state of iteration within the collection a variable ‘index’ has been employed, which has been initiated with 0.

PolygonSequenceIterator(number of vertices, circumradius)

This dunder method of iteration returns the instance of this class (self).

PolygonSequenceIterator()

This dunder method of maintains the state of iteration within the collection, and stops the process once of the dataset has been exhausted. It also returns the value of the next element.

PolygonSequenceIterator()

A brief description of the test cases that have been employed for the respective functions are as follows:

The following table illustrates the test cases that have been employed to check the various aspects of document formatting of the README.md and the session9.py files.