Skip to content

Conversation

@laurensvalk
Copy link
Contributor

@laurensvalk laurensvalk commented Aug 14, 2020

  • This changes

    Screenshot from 2020-08-14 14-05-35

    to:

    image

  • This changes:

    Screenshot from 2020-08-14 14-13-53

    to

    Screenshot from 2020-08-14 14-14-30

    Inverse has now been changed to ^{-1} as well.

  • This changes:

    Screenshot from 2020-08-14 14-09-21

    to:

    image

  • and a few other minor fixes.

This fixes the following errors, which made
the last two bullets display incorrectly.

python-control/doc/conventions.rst:229: WARNING: Bullet list ends without a blank line; unexpected unindent.
python-control/doc/conventions.rst:232: WARNING: Bullet list ends without a blank line; unexpected unindent.
This also fixes the following warnings:

python-control/control/statefbk.py:docstring of control.lqe:6: WARNING: Unexpected indentation.
python-control/control/statefbk.py:docstring of control.lqe:36: WARNING: Unexpected indentation.
@coveralls
Copy link

coveralls commented Aug 14, 2020

Coverage Status

Coverage increased (+0.01%) to 84.222% when pulling c70fbeb on pybricks:docwarnings into d3142ff on python-control:master.

@coveralls
Copy link

Coverage Status

Coverage remained the same at 84.212% when pulling 2aee9ed on pybricks:docwarnings into d3142ff on python-control:master.

Copy link
Contributor

@bnavigator bnavigator left a comment

Choose a reason for hiding this comment

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

LGTM, except the scipy reference

-----
For discrete time systems, the input/output response is computed using the
:scipy-signal:ref:`scipy.signal.dlsim` function.
scipy.signal.dlsim function.
Copy link
Contributor

@bnavigator bnavigator Aug 14, 2020

Choose a reason for hiding this comment

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

Just fix the broken intersphinx mapping:

Suggested change
scipy.signal.dlsim function.
:func:`scipy.signal.dlsim` function.

python-control/doc/conf.py

Lines 99 to 101 in ec8cbf0

intersphinx_mapping = \
{'scipy':('https://docs.scipy.org/doc/scipy/reference', None),
'numpy':('https://docs.scipy.org/doc/numpy', None)}

Edit: Turns out the intersphinx setup is broken because of defining the mapping twice:

python-control/doc/conf.py

Lines 198 to 199 in ec8cbf0

# Example configuration for intersphinx: refer to the Python standard library.
intersphinx_mapping = {'https://docs.python.org/': None}

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Thanks! I've updated the commits to fix it.

@bnavigator
Copy link
Contributor

  • This changes:
    Screenshot from 2020-08-14 14-09-21
    to:
    Screenshot from 2020-08-14 14-06-19

I think your "fixed" screenshot shows the wrong output portion.

The link to dlsim was broken, producing a warning. The links to lsim were missing.
This left-over example configuration caused the intended
intersphinx_mapping not to work, thus breaking links to
scipy and numpy. Now the links should work again.
@laurensvalk
Copy link
Contributor Author

Thanks for the review. I've adapted it based on your feedback and fixed the screenshot above.

@bnavigator
Copy link
Contributor

I submitted a PR into your branch to take this even further: pybricks#1

@laurensvalk
Copy link
Contributor Author

Sounds good - I just merged those into this PR.

@bnavigator bnavigator added this to the 0.8.4 milestone Aug 16, 2020
@bnavigator bnavigator merged commit b743fb8 into python-control:master Aug 18, 2020
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.

3 participants