- Notifications
You must be signed in to change notification settings - Fork445
Version 0.10.2 release notes#1140
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 ourterms of service andprivacy statement. We’ll occasionally send you account related emails.
Already on GitHub?Sign in to your account
Uh oh!
There was an error while loading.Please reload this page.
Conversation
coveralls commentedMar 8, 2025 • edited
Loading Uh oh!
There was an error while loading.Please reload this page.
edited
Uh oh!
There was an error while loading.Please reload this page.
roryyorke left a comment• edited
Loading Uh oh!
There was an error while loading.Please reload this page.
edited
Uh oh!
There was an error while loading.Please reload this page.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
3types typos, one tentative wording suggestion.
Uh oh!
There was an error while loading.Please reload this page.
Uh oh!
There was an error while loading.Please reload this page.
Uh oh!
There was an error while loading.Please reload this page.
Uh oh!
There was an error while loading.Please reload this page.
67c1e66 to7548738Compare
bnavigator left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
LGTM
slivingston left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
Excellent!
Not related to this PR but relevant in terms of the docs:pinning docutils at 0.16 is not necessary now because thecurrent sphinx_rtd_theme release is compatible with later versions. I removed the pin from requirements.txt and locally the result looks good to me, though I did not carefully compare it side-by-side with the current case (of docutils pinned at 0.16). If you think this is too risky to do now, OK to wait and make the change after releasing version 0.10.2.
If you have access to the ReadTheDocs admin panel, it is worth checking why a warning banner is not appearing on older versions,as I commented in a recent issue.
While reviewing, I noticed a misprint in the docs: "indexed indexed" appears twice in timeresp.py:
python-control/control/timeresp.py
Line 554 in394e1c2
Time evolution of the state vector, indexed indexed by either the python-control/control/timeresp.py
Line 619 in394e1c2
Time evolution of the state vector, indexed indexed by either the
Uh oh!
There was an error while loading.Please reload this page.
Uh oh!
There was an error while loading.Please reload this page.
Uh oh!
There was an error while loading.Please reload this page.
Uh oh!
There was an error while loading.Please reload this page.
doc/releases/0.10.2-notes.rst Outdated
| * `FrequencyResponseData`: use `~FrequencyResponseData.complex` to | ||
| access the (squeeze processed) complex frequency response (instead | ||
| of the legacy `response` property) and | ||
| `~FrequencyResponseData.frdata` to access the 3D frequency response |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
This does not render as a link tofrdata for me when I build locally. This is expected becausefrdata is an attribute,whereascomplex is a property. Attributes defined by assignment toself do not have documentation besides the class docstring, whereas the property definitions are functions and thus can have their own docstrings.
You might already be aware of the above, but I wanted to write it out to share my understanding while reviewing this PR.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
Consider changing this to
`FrequencyResponseData.frdata <FrequencyResponseData>`as it is written in the "Deprecations" section below.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
I've made the proposed change, but for future we might consider documenting attributes. This can be done by defining the attribute in the class and using the#: syntax in Sphinx. So something like this:
class FrequencyReponseData(): ... #: Frequency response data array. #: #: The frequency response at each frequency point. If 1D, ... frdata = NoneUh oh!
There was an error while loading.Please reload this page.
Uh oh!
There was an error while loading.Please reload this page.
murrayrm commentedMar 15, 2025
I looked into this and the settings are such that we should see warning banners. But we don't. I've added@slivingston as a maintainer in case you have time to look and want to debug. |
slivingston commentedMar 15, 2025
Thanks. It turns out that ReadTheDocs follows the Semantic Version specification, which states that versions less than 1.0.0 are for "initial development" and not stable. ReadTheDocs allows us to manually declare which version is stable by pushing a branch named |
murrayrm commentedMar 15, 2025
Thanks for the ReadTheDocs fix,@slivingston. What do we need to do when we make a new release? Copy that release into stable? |
slivingston commentedMar 15, 2025
Yes. Basically, the branch should point to the same commit as the tag used for the release: |
cd03df9 tob3d8ce9Compare03ae372 intopython-control:mainUh oh!
There was an error while loading.Please reload this page.
This PR contains release notes for version 0.10.2 of the python-control toolbox. This should be the last PR merged before release v0.10.2 (with addition commits if any new functionality is added via other PRs).