Skip to content

Commit 9d9685a

Browse files
committed
fix documentation warnings
1 parent 46a8871 commit 9d9685a

File tree

3 files changed

+18
-19
lines changed

3 files changed

+18
-19
lines changed

documentation/source/intro.rst

Lines changed: 12 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -17,42 +17,42 @@ The ``MagneticComponent`` class
1717
---------------------------------------
1818
.. currentmodule:: femmt.MagneticComponent
1919

20-
.. autoclass:: MagneticComponent
21-
:members: set_core, set_air_gaps, set_insulation, set_stray_path, set_winding_window, create_model, single_simulation, excitation_sweep, mesh, thermal_simulation, femm_reference, femm_thermal_validation
20+
.. autoclass:: femmt.MagneticComponent
21+
:members: set_core, set_air_gaps, set_insulation, set_stray_path, create_model, single_simulation, excitation_sweep, mesh, thermal_simulation, femm_reference, femm_thermal_validation
2222
:special-members: __init__
2323

2424
The ``Core`` class
2525
--------------------------------------
26-
.. autoclass:: femmt.Model.Core
26+
.. autoclass:: femmt.Core
2727
:special-members: __init__
2828

2929
The ``AirGaps`` class
3030
--------------------------------------
31-
.. autoclass:: femmt.Model.AirGaps
31+
.. autoclass:: femmt.AirGaps
3232
:members: add_air_gap
3333
:special-members: __init__
3434

3535
The ``Insulation`` class
3636
--------------------------------------
37-
.. autoclass:: femmt.Model.Insulation
37+
.. autoclass:: femmt.Insulation
3838
:members: add_winding_insulations, add_core_insulations
3939
:special-members: __init__
4040

4141
The ``Conductor`` class
4242
--------------------------------------
43-
.. autoclass:: femmt.Model.Conductor
43+
.. autoclass:: femmt.Conductor
4444
:members: set_rectangular_conductor, set_solid_round_conductor, set_litz_round_conductor
4545
:special-members: __init__
4646

4747
The ``WindingWindow`` class
4848
--------------------------------------
49-
.. autoclass:: femmt.Model.WindingWindow
49+
.. autoclass:: femmt.WindingWindow
5050
:members: split_window, combine_vww
5151
:special-members: __init__
5252

5353
The ``VirtualWindingWindow`` class
5454
--------------------------------------
55-
.. autoclass:: femmt.Model.VirtualWindingWindow
55+
.. autoclass:: femmt.VirtualWindingWindow
5656
:members: set_winding, set_interleaved_winding
5757
:special-members: __init__
5858

@@ -76,13 +76,12 @@ The ``LogParser`` class
7676

7777
``Enumerations``
7878
---------------------------------
79-
.. automodule:: femmt.Enumerations
80-
:members:
81-
:undoc-members:
79+
.. currentmodule:: femmt
80+
.. autoclass:: femmt.enumerations
8281

8382
Helper functions
8483
---------------------------------
85-
.. automodule:: femmt.Functions
86-
:members: core_database, litz_database, wire_material_database
84+
.. automodule:: femmt.functions
85+
:members:
8786

8887
.. include:: developer_notes.rst

femmt/functions.py

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1232,13 +1232,13 @@ def find_result_log_file(result_log_folder: str, keyword_list: list, value_min_m
12321232
12331233
:param result_log_folder: filepath to result-log folder
12341234
:type result_log_folder: str
1235-
:param keyword_list: list with hirarchical keywords for dictionary structure, e.g. ["simulation_settings", "core",
1236-
"core_inner_diameter"]
1235+
:param keyword_list: list with hirarchical keywords for dictionary structure, e.g. ["simulation_settings", "core", "core_inner_diameter"]
12371236
:type keyword_list: list
12381237
:param value_min_max: value to check for
12391238
:type value_min_max: list
12401239
12411240
:Example:
1241+
12421242
Check for files with a core inner diameter smaller equal than 0.02 m.
12431243
>>> import femmt as fmt
12441244
>>> fmt.find_result_log_file("/home/filepath/fem_simulation_data", ["simulation_settings", "core",
@@ -1538,6 +1538,7 @@ def visualize_mean_mutual_inductances(inductance_matrix: np.array, silent: bool)
15381538
:type inductance_matrix: np.array
15391539
:param silent: True for no output
15401540
:type silent: bool
1541+
15411542
e.g. M_12 = M_21 = k_12 * (L_11 * L_22) ** 0.5
15421543
"""
15431544
string_to_print = ""
@@ -1563,6 +1564,7 @@ def visualize_mutual_inductances(self_inductances: List, coupling_factors: List,
15631564
:type coupling_factors: List
15641565
:param silent: True for no output
15651566
:type silent: bool
1567+
15661568
e.g. M_12 = L_11 * K_21 != M_21 = L_22 * K_12 (ideally, they are the same)
15671569
"""
15681570
string_to_print = ""
@@ -1624,7 +1626,6 @@ def calculate_quadrature_integral(timesteps: List[float], data: List[float]) ->
16241626
:type timesteps: List[float]
16251627
:param data: List of data corresponding to each timestep.
16261628
:type data: List[float]
1627-
Returns:
16281629
:return: The calculated integral.
16291630
:rtype: float
16301631
"""
@@ -1639,7 +1640,6 @@ def calculate_squared_quadrature_integral(timesteps: List[float], data: List[flo
16391640
:type timesteps: List[float]
16401641
:param data: List of data corresponding to each timestep.
16411642
:type data: List[float]
1642-
Returns:
16431643
:return: The calculated integral.
16441644
:rtype: float
16451645
"""

femmt/model.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -628,8 +628,8 @@ def add_winding_insulations(self, inner_winding_insulation: List[List[float]]):
628628
629629
Insulation between virtual winding windows is not always needed.
630630
:param inner_winding_insulation: List of floats which represent the insulations between turns of the same winding. This does not correspond to
631-
the order conductors are added to the winding! Instead, the winding number is important. The conductors are sorted by ascending winding number.
632-
The lowest winding number therefore is combined with index 0. The second lowest with index 1 and so on.
631+
the order conductors are added to the winding! Instead, the winding number is important. The conductors are sorted by ascending winding number.
632+
The lowest winding number therefore is combined with index 0. The second lowest with index 1 and so on.
633633
:type inner_winding_insulation: List[List[float]]
634634
"""
635635
if inner_winding_insulation is [[]]:

0 commit comments

Comments
 (0)