More v2 improvements

[graeme-a-stewart]

Update of various tutorial aspects:

DataFrames:

• Add explanation of row selector with a boolean mask
• Reduce the dataset size again, but removing all of the derived and Kaggle specific columns (keeping EventID, PRI*, Label)
• Add an explicit link to the Higgs dataset CSV
• Add some clarifications as to why certain things are done or points of note (better for the "standalone" version on the web).
• Reduce the size of the datatset used, by dropping derived data columns
• Note that column selectors are generally used with select
• Add example to select rows from a derived vector of bool
• Introduce also transform
• Give a table summary to understand the differences between select, transform, filter and combine
• Explain how missing values work: types + multiple dispatch

Operators and Variables:

• Explain === as object comparison (as opposed to in-memory object, as pointed out by Uwe and Anton)

Control and Conditional:

• Make more explicit use of ∈ and explain that = is disfavoured in for loops

General:

• Drop Julia Survival Syntax from the titles of some sections
• Many minor formatting fixes

Closes #33 Closes #30

[github-actions[bot]]

PR Preview Action v1.4.4 :---: :rocket: Deployed preview to https://JuliaHEP.github.io/JuliaHEP-2023/pr-preview/pr-36/ on branch gh-pages at 2023-11-10 10:03 UTC

[aoanla]

If we're fixing typos, then in dataframes intro, "manegable" -> "manageable".

(Thanks for spotting my "exponentation" in return!)

[graeme-a-stewart]

Thanks! For some reason my code spell checked doesn't run in markdown cells.

[graeme-a-stewart]

Yah, the point is that Jupyterbook moans as it compiles all the ipynb files and then the solutions notebook crashes as Zygote isn't there.

[Moelf]

Idk if we need Zygote related content. Zygote may phase into "not recommend" in a couple of years

[aoanla]

Idk if we need Zygote related content. Zygote may phase into "not recommend" in a couple of years

Well, it's just the "very advanced optional" bit of the exercise, as an excuse to flag the very advanced auto differentiation ecosystem in Julia. Do you have a suggested replacement out of the many alternatives? ReverseDiff/ForwardDiff? Enzyme? (which I would have used over Zygote, but my impression was that there's still issues with Enzyme?)

[Moelf]

Unless we have some specific HEP AD thing, I'd suggest not go too deep into something just for the sake of it

[aoanla]

To clarify, I mean "very advanced" as in "it's at a state of mature development", not "I think it's super complicated to understand". The exercise literally just touches on it at the end so people know that autodiff stuff exists (and where to find it) in Julia, and it only uses Zygote because it's both easy to use in this case, and I can guarantee it will work in 1.9.3 (unlike Enzyme!)

[Moelf]

What if we make clear Zygote is just an example and encourage readers to explore https://juliadiff.org/ for example?

[aoanla]

I would argue the text already does that! ("There are many automatic differentiation packages available for Julia - such as Zygote - listed at Julia Diff, which we could use to find f′ directly and efficiently.")

[Moelf]

I was just thinking not making Zygote sounds like the go-to flagship because to some people it's beyond salvation but I guess this is fine!

[aoanla]

Sure, I guess the problem is that it's hard to recommend the best replacement (since Diffractor and Enzyme both have their champions).