Skip to content

Commit

Permalink
Updating docstrings to latest flake8 version (#90)
Browse files Browse the repository at this point in the history
* flake8 fixes

* full stoppp

* fix doc build + add noqa for mdolab theme imports
  • Loading branch information
marcomangano authored Jul 24, 2023
1 parent 1281ec4 commit fc237f3
Show file tree
Hide file tree
Showing 4 changed files with 15 additions and 8 deletions.
3 changes: 3 additions & 0 deletions baseclasses/problems/FluidProperties.py
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,9 @@

class FluidProperties:
"""
This class is the parent of pyAero_problem and defines the basic flow properties to be passed to the solver.
It also has a method to update the dynamic viscosity through the Sutherland's law based on flow temperature and other optional user inputs.
Parameters
----------
Expand Down
8 changes: 6 additions & 2 deletions baseclasses/problems/pyFieldPerformance_problem.py
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,8 @@ class FieldPerformanceProblem:
span : float
Total wingspan
** Note ** Thrust and weight should be specified in terms of force.
\*\* Note \*\* Thrust and weight should be specified in terms of force.
T_VA : float
Idle thrust during approach. <force>
T_VF : float
Expand All @@ -75,7 +76,8 @@ class FieldPerformanceProblem:
TOW : float
Takeoff gross weight. <force>
** Note ** TSFC should be specified in terms of mass / time / force.
\*\* Note \*\* TSFC should be specified in terms of mass / time / force.
TSFC_VA : float
Thrust-specific fuel consumption with engine in idle during approach.
TSFC_VF : float
Expand All @@ -92,11 +94,13 @@ class FieldPerformanceProblem:
Examples
--------
FP = FieldPerformance('gulfstream')
fpp = FieldPerformanceProblem(name='fpp1',TOW=W,span=b,CLmax=CLmax,
WingHeight=5.6,runwayFrictionCoef=0.04,Area=S,
CD0=0.015,CD0_LG=0.0177,CD0_HL=0,
T_VG=T_VG,T_VT=T_VT,TSFC_VG=TSFC,TSFC_VT=TSFC,
altitude=0,units='english')
fpp.addDV('TOW')
funcs = {}
funcsSens = {}
Expand Down
8 changes: 4 additions & 4 deletions baseclasses/testing/pyRegTest.py
Original file line number Diff line number Diff line change
Expand Up @@ -191,7 +191,7 @@ def root_add_dict(self, name, d, **kwargs):
The name of the dictionary
d : dict
The dictionary to add
**kwargs
\*\*kwargs
See :meth:`getTol <baseclasses.BaseRegTest.getTol>` on how to specif tolerances.
"""
with multi_proc_exception_check(self.comm):
Expand All @@ -209,7 +209,7 @@ def par_add_val(self, name, values, **kwargs):
The name of the value
values : ndarray
The array to be added. This must be a numpy array distributed over self.comm
**kwargs
\*\*kwargs
See :meth:`getTol <baseclasses.BaseRegTest.getTol>` on how to specif tolerances.
"""
if self.comm is None:
Expand All @@ -229,7 +229,7 @@ def par_add_sum(self, name, values, **kwargs):
The name of the value
values : ndarray
The array to be added. This must be a numpy array distributed over self.comm
**kwargs
\*\*kwargs
See :meth:`getTol <baseclasses.BaseRegTest.getTol>` on how to specif tolerances.
"""
if self.comm is None:
Expand All @@ -249,7 +249,7 @@ def par_add_norm(self, name, values, **kwargs):
The name of the value
values : ndarray
The array to be added. This must be a numpy array distributed over self.comm
**kwargs
\*\*kwargs
See :meth:`getTol <baseclasses.BaseRegTest.getTol>` on how to specif tolerances.
"""
if self.comm is None:
Expand Down
4 changes: 2 additions & 2 deletions doc/conf.py
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
from sphinx_mdolab_theme.config import *
from sphinx_mdolab_theme.config import * # noqa F403

# -- Path setup --------------------------------------------------------------
# If extensions (or modules to document with autodoc) are in another directory,
Expand All @@ -17,7 +17,7 @@
# Built-in Sphinx extensions are already contained in the imported variable
# here we add external extensions, which must also be added to requirements.txt
# so that RTD can import and use them
extensions.extend(["numpydoc"])
extensions.extend(["numpydoc"]) # noqa F405

# mock import for autodoc
autodoc_mock_imports = ["numpy", "pygeo", "mpi4py"]

0 comments on commit fc237f3

Please sign in to comment.