mpl_bsic 1.2.0

BSIC Plotting Library

mpl-bsic

Create matplotlib plots in BSIC Style!

Explore the docs »

Report Bug - Request Feature

About the Project

This package allows you to style matplotlib plots using BSIC Style (fonts, colors, logos, etc.) to later use them in BSIC articles. It also provides utility function to handle the formatting of the axis, check the size of the figures, and more!

Read the sections below for an overview of how to install and use the package. For further information, be sure to read the docs!

Table Of Contents

• About the Project
• Installation
• Docs and TLDR
• If the matplotlib fonts do not work
• Contributing
• Roadmap

Installation

The package supports all python versions starting from 3.9.0

To install, run

pip install mpl-bsic

Then you can import the functions from the module, for example

from mpl_bsic import apply_bsic_style

Docs and TLDR

Read the docs on this link. All the functions are explained extensively and you can find example code/plots.

WARNING: Be sure to read the docs for apply_bsic_style, and in particular how to make sure the style gets applied. You always have to make sure you call plt.show() (if in a script) even if you only plan to export the plot, since otherwise matplotlib won't run the animations which are required to apply the style to the title. And also read carefully the part about the figsize to use, especially when exporting to use in a Word file.

A brief overview of the functions of the module:

• apply_bsic_style: applies the BSIC styles to a plot (font families, font sizes).
• apply_bsic_logo: applies the BSIC logo to the plot. You can specify the size, location and logo type.
• check_figsize: checks the figsize of your plot, to make sure it will be rendered correctly in MS Word. To learn more about this, look at the documentation
• format_timeseries_axis: formats the x axis of a timeseries plot. You can specify the time unit (yearly, monthly, daily), the frequency (e.g. a tick every 3M), and the format (e.g. MM/YYYY or MMM YYYY)
• preprocess_dataframe: preprocesses a dataframe, by setting the index to the date (and converting to datetime) and transforming all the columns to lowercase for easier use in the project
• plot_trade: WIP

If the matplotlib fonts do not work

Check the full guide on the documentation. Anyway, you need to install Garamond and Gill Sans MT on your system and clear your matplotlib cache.

Contributing

If you have any ideas, features you would like to have implemented, or you find out any bugs within the function, be sure to open an issue and I will work on it as soon as possible. Or you can also fork the repo yourself and make a pull request to the project!

Roadmap

1. plot trade (as bloomberg with last price and stuff)
2. plot tables (instead of having to style them using Excel)