-
Notifications
You must be signed in to change notification settings - Fork 10
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
Second tutorial about time dependent data #564
Conversation
Check out this pull request on See visual diffs & provide feedback on Jupyter Notebooks. Powered by ReviewNB |
Notes
|
can you update the Or maybe we should allow both for now? |
I will create a separate PR pointing to the |
@marscher @CagtayFabry no clue why deepsource is complaining here. The function is in the file and I didn't touch it either. Any clue? If not I will ignore it for now. If it keeps showing up, I will add a flag for deepsource to ignore it, before we merge everything into master. |
Codecov Report
@@ Coverage Diff @@
## new_tutorials BAMWelDX/weldx#564 +/- ##
==============================================
Coverage 94.65% 94.65%
==============================================
Files 93 93
Lines 5936 5936
==============================================
Hits 5619 5619
Misses 317 317 Continue to review full report at Codecov.
|
Co-authored-by: Cagtay Fabry <43667554+CagtayFabry@users.noreply.github.com>
One bad thing about using RST: The link syntax collides with the markdown inline code syntax. See "Further readings" section here ... I'll try using HTML as an alternative |
I guess you meant this snippet?
I can see how that could be troublesome for the parser, but a normal link without inline code styling should also be fine here :) |
That works, yes. I tried this one now:
Works in the NBs and it should also work in the online version. We will know in a few minutes 😉 |
Works (good enough). |
"Depending on the Python environment you are using, there are some things to consider.\n", | ||
"Since the `plot` method uses `matplotlib` internally, you have to call the `matplotlib.pyplot.show` function manually after using `plot` when running a regular Python script file.\n", | ||
"Otherwise, the plot won't show up.\n", | ||
"\n", |
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 would prefer to leave this part out since we are in a notebook here, talking matplotlib or even other IDEs is confusing imo.
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.
If somebody reads our online doc, he is not using any environment at all. I know, I keep repeating myself, but I don't think it is wise to expect that every future WelDX user will also use Jupyter.
So IMO 3 sentences to avoid confusion beneath the Python userbase isn't too confusing for other people. Also, even if the tutorials are written in Jupyter, they are general WelDX tutorials and not "WelDX in Jupyter" tutorials.
As an alternative I can shorten it to a Hint like this:
HINT: In a Python script, you need to call
matplotlib.pyplot.show
function manually to actually see the plots
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.
As discussed, we will leave it in for now
{ | ||
"cell_type": "code", | ||
"execution_count": null, | ||
"metadata": {}, | ||
"outputs": [], | ||
"source": [ | ||
"# %matplotlib widget" | ||
] |
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.
can we uncomment this cell and hide+skip in the docs build?
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 think hiding it in the docs doesn't make much sense when the preceding sentence is:
To enable interactive matplotlib plots inside a jupyter notebook, uncomment and run the following magic command:
However, I can try uncommenting it and we will see what happens. Maybe it magically works.
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.
Didn't work. Solution postponed
Changes
Add the second tutorial about time-dependent data
Todo