WIP

• force computation working with collections and paths
• integration in magpylib interface
• docs
• current sheet
• review

LINK TO DOCS

Biggest changes:

• User guide
• Physics and Computation
• Examples

This will completely replace the magpylib_force package.

@fslanovc, @Alexboiboi and @luizenger any anyone else please give it a try and give me feedback on the interface - it should be very intuitive to magpylib users. Here is a simple example:

import numpy as np
import magpylib as magpy

cube = magpy.magnet.Cuboid(
    dimension=(1, 1, 1),
    polarization=(.1, .2, .3)
)
circ = magpy.current.Circle(
    diameter=2,
    current=1e3,
    position=(0, 0, 1),
    meshing=50,
)
F, T = magpy.getFT(cube, circ)

print(f'force: {np.round(F, decimals=2)} N')
# force: [ 13.65  27.31 -81.93] N

print(f'torque: {np.round(T, decimals=2)} Nm')
# torque: [-8.55  4.27 -0.  ] Nm

Also if any of you mange to give me a code review it would be appreciated - but ofc its a few 1000 lines of code ;(

1. Prio1 the module fieldFT.py
2. Prio2 the module target_meshing.py
3. Prio2 class_BaseTarget.py and all inheritance
4. Prio4 test_force.py