Using handcalcs to Convert Python Calculations into LaTeX Formulas

Mathematics underpins data science and machine learning, and accurate formula computation is critical; developers often need a way to display calculations in a readable, handwritten‑style format.

The handcalcs library converts Python calculation code into LaTeX formulas, presenting the computation steps similarly to how a teacher writes on a blackboard.

Basic usage – Jupyter cell magic : import the library with import handcalcs.render , then start a cell with the magic command %%render followed by ordinary Python statements, e.g.: %%render a = 2 b = 3 c = 2*a + b/3

Basic usage – function decorator : import the decorator from handcalcs.decorator import handcalc , decorate a function that returns locals() , for example: @handcalc() def my_calc(x, y, z): a = 2*x / y b = 3*a c = (a + b) / z return locals()

The decorator returns a tuple (latex_code: str, locals: dict) , where locals contains all variables from the function’s namespace.

Additional features : special comment tags control layout – # Parameters arranges many parameters in three columns, # Short compresses long derivations, # Long expands them, and # Symbolic displays purely symbolic expressions.

handcalcs also simplifies printing multiple variables, supports subscript notation (including nested subscripts), and can render Greek letters by using their English names (e.g., alpha , beta ).

Limitations : the library does not handle collection types such as list , tuple , or dict , and reusing variable names across notebook cells may produce incorrect calculations.

Despite these minor drawbacks, handcalcs provides a handy way for developers to verify and present complex mathematical computations directly within Python notebooks.