dylannalex / curvipy

Make math animations in a few lines of code.

Hi 👋, I'm Dylan

I am a passionate Systems Engineering student with a deep love for Mathematics and an innate fascination with Data Science, Machine Learning, and Artificial Intelligence. I'm enthusiastic about collaborating on projects that involve data analysis, Python programming, and creatively solving complex challenges. Currently, I'm actively engaged in a research group, focusing on metaheuristics optimization. I love to learn new stuff every day and to share my knowledge with others at my blog.

⚡️ Skills

I'm proficient at:

• Languages: Python, C, C++, Java
• Data Science: Numpy, Pandas, Matplotlib, Selenium
• Tools: Git, Jupyter, VS Code, TeX
• Databases: MySQL

📕 Latest blog posts

• UdemyPy - Free Udemy courses every day!
• K-Means Clustering for Image Quantization
• Demystifying the Monty Hall Problem: A Step-by-Step Guide
• Random Circle Problem
• ElectriPy

📈 Stats

curvipy's Issues

Add contributing guide

Problematic return type of the `points` method

The Curve class and its subclasses use the method points to return the curve points.
Currently, the return type of the points method is list[int | float].
But the return type should be list[tuple[int | float, int | float]]

Export animations to GIF, MP4, etc.

Updating _vector.py

We should add __eq__, __str__ and __repr__ methods to the module

Type Error in `_plotter.py`

In the _plotter.py file in lines 334 & 383 the variable font_size has the type str, but it should be converted to int during assignment.

curvipy/curvipy/_plotter.py

Line 334 in d6bfa3c

font_size = self.axes_config.ticks_font[1]

as it is needed for the line

curvipy/curvipy/_plotter.py

Line 344 in d6bfa3c

text_offset = -font_size * len(number_str) * w * 0.5e-3

Show numbers on the x and y axes

A few aspects to keep in mind:

• Number shown depend on 'curvipy.Plotter.x_axis_scale' and 'curvipy.Plotter.y_axis_scale'.
• Add a new 'curvipy.Plotter' attribute to indicate the quantity of numbers to be displayed on the axes.
• Add a method 'curvipy.ScreenFacade' to display text on screen. This method will be used by 'curvipy.Plotter' to display the numbers on the axes.

[Documentation] The docs needs an update

The docstrings need some updates. A few minor typos and grammatical errors need to be corrected.

Translate README.md to spanish

Create README.es.md file, a translated version of README.md.

Add vector addition and subtraction operations.

Given the vectors $\vec{v}$ and $\vec{w}$, we want to compute $\vec{n} = \vec{v} + \vec{w}$ and $\vec{m} = \vec{v} - \vec{w}$ as shown below:

import curvipy

v = curvipy.Vector([10, 10])
w = curvipy.Vector([5, -5])
n = v + w
m = v - w

This is not possible on Curvipy 1.0.1. To do so, users have to calculate $\vec{n}$ and $\vec{m}$ manually:

import curvipy

v = curvipy.Vector([10, 10])
w = curvipy.Vector([5, -5])
n = curvipy.Vector([10 + 5, 10 + (-5)])
m = curvipy.Vector([10 - 5, 10 - (-5)])

Add axes labels

This implies adding two new attributes to 'curvipy.AxesConfiguration' class:

• 'curvipy.AxesConfiguration.x_label'
• 'curvipy.AxesConfiguration.y_label'

Update GIFs from docs/source/img for curvipy v1.1.0

GIFs shown on documentation (both README and docs) are from curvipy v1.0.1. To update the animations, just run the code shown above the GIF and record the screen with some third party software (e.g. ActivePresenter).

Add tests

Create a tests directory for testing Curvipy classes.

A rotation function

A function that rotates the curve by a certain $\theta$ angle. The implementation is easy, it will take $\theta$, and the curve as input, and method is just like TransformedCurve, but the matrix used will be:

$$A(\theta)=\begin{pmatrix} \cos\theta & -\sin\theta\\ \sin\theta & \cos\theta \end{pmatrix}$$

Add an 'exclude' parameter to 'curvipy.Interval'

The idea is to exclude a list of values from the interval, so they won't be considered when plotting the curve.

curvipy.Interval:
    Parameters
    ----------
    start : int or float
        Real number in which the interval starts.
    end : int or float
        Real number in which the interval ends.
    samples: int
        Number of values within the interval. The more samples, the more precise the \
        curve plot is.
    exclude: list[int or float]
        List of values that will be excluded from the interval.

Example: imagine we want to plot the curve $f(x) = 1/x$ on the interval $x \in [-a, a]$. Since $f(0)$ is not defined, the current way of doing that is to create two intervals:

import curvipy


def f(x):
    return 1 / x


plotter = curvipy.Plotter()

a = 10
curve = curvipy.Function(f)
interval_one = curvipy.Interval(-a, -0.1, 100)
interval_two = curvipy.Interval(0.1, a, 100)

plotter.plot_curve(curve, interval_one)
plotter.plot_curve(curve, interval_two)
plotter.wait()

With an 'exclude' parameter on 'curvipy.Interval' class, we could accomplish the same goal with only one interval:

import curvipy


def f(x):
    return 1 / x


plotter = curvipy.Plotter()

a = 10
curve = curvipy.Function(f)
interval = curvipy.Interval(-a, a, 200, exclude=[0])

plotter.plot_curve(curve, interval)
plotter.wait()

If somebody wants to work on it, please make a comment. Implementing this is not as easy as it seems and might need modifications in other classes like curvipy.Plotter and/or curvipy.Curve.