chicolucio/matplotlove

Animated hearts for Valentine's Day. Or any day you want to show your love

Matplotlove

A simple project to plot animated hearts for Valentine's Day. Or any day you want to show your love.

The heart shape graphs come from math equations. The script generates points for the equations with SymPy or NumPy and plots the points with Matplotlib.

Valentine's Day, also called Saint Valentine's Day or the Feast of Saint Valentine, is celebrated annually on February 14 in many regions of the world.

Usage

1. clone the repo, not a package yet :-(
2. create a virtual environment with Python 3.8+
3. activate the virtual environment
4. install dependencies
5. run the script and follow the instructions

git clone https://github.com/chicolucio/matplotlove
cd matplotlove
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python matplotlove.py

Can I use matplotlove being single?

Sure. And here is a song for you:

Lonely people - America

This is for all the lonely people
Thinking that life has passed them by
Don't give up
Until you drink from the silver cup
And ride that highway in the sky

This is for all the single people
Thinking that love has left them dry
Don't give up
Until you drink from the silver cup
You never know until you try

Well, I'm on my way
Yes, I'm back to stay
Well, I'm on my way back home

This is for all the lonely people
Thinking that life has passed them by
Don't give up
Until you drink from the silver cup
She'll never take you down or
Never give you up
You'll never know until you try

Click in the image below to listen:

Contributing

All contributions are welcome.

Issues

Feel free to submit issues regarding:

• recommendations
• more heart animations
• enhancement requests and new useful features
• code bugs

There are some open issues waiting for your help, see here.

Pull requests

• before starting to work on your pull request, please submit an issue first
• fork the repo
• clone the project to your own machine
• commit changes to your own branch
• push your work back up to your fork
• submit a pull request so that your changes can be reviewed

License

Beerware, see LICENSE. Yeah, I like beer.

matplotlove's Issues

Installable package and separate classes from CLI

As I've read on the README, this project isn't yet an installable package, maybe that would be a good idea!

• I'll be submitting a PR for just that in some time.

Also, I'd separate the CLI part from the hearts classes, so that the code would be a bit easier to read, but still, if that's not on your scope, please to edit out the changes!

Port to Streamlit

Some ideas

• a better CLI
  • without eval
  • with options to change frames, interval, blit, size, colormap
  • interaction through sys argv with argparse or similar

More hearts:

• link 1
• link 2
• link 3

Text messages:

It would be nice to be able to put text messages like:

First part of the message

Heart animation

Second part of the message

Slow animations

The animations from classes Heart05 to Heart08 are extremely slow.
I'm not sure why, but I think is due to the Rational method from SymPy.
Think about another way to implement these classes, maybe not using SymPy.