Skip to content

Documentation update #476

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
Dec 24, 2020
Merged

Documentation update #476

merged 7 commits into from
Dec 24, 2020

Conversation

murrayrm
Copy link
Member

This PR has a number of small documentation updates the I collected over time. All minor.

@coveralls
Copy link

coveralls commented Dec 22, 2020

Coverage Status

Coverage remained the same at 86.355% when pulling 6ff59f0 on murrayrm:doc_update into e525ff6 on python-control:master.

@coveralls
Copy link

Coverage Status

Coverage decreased (-0.1%) to 86.222% when pulling 3e6347f on murrayrm:doc_update into e525ff6 on python-control:master.

@@ -373,9 +374,9 @@ def lqr(*args, **keywords):

Returns
-------
K: 2D array
K: 2D array (or matrix)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

numpydoc:

Suggested change
K: 2D array (or matrix)
K : 2D array (or matrix)

Same for all the other functions in this file, which are a mix of numpydoc and non-numpydoc right now.

Comment on lines 393 to 398
Notes
-----
The return type for `K` and `S` depends on the default class set for
state space operations. By default, this is the Numpy `matrix`
class in this release, but this can be reconfigured using the
:func:`~control.use_numpy_matrix` function.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is also true for most of the other functions in this file. Maybe a general note referenced here and in those functions would be preferable. Cf. #439

@bnavigator bnavigator linked an issue Dec 22, 2020 that may be closed by this pull request
@murrayrm murrayrm merged commit 120a926 into python-control:master Dec 24, 2020
@murrayrm murrayrm deleted the doc_update branch December 28, 2020 22:43
@murrayrm murrayrm added this to the 0.9.0 milestone Mar 20, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

doc inconsistency about return type of lqr - matrix vs array
3 participants