Intro to Python Chaper by howardbaik · Pull Request #10 · datatrail-jhu/python

howardbaik · 2024-02-12T22:15:50Z

Purpose/implementation Section

What changes are being implemented in this Pull Request?

First draft of the "Intro to Python" chapter.

What was your approach?

I start with an introduction to Python, then touch on the main differences between R and Python, then talk about the major differences in Python for R users, which are mainly drawn from Primer on Python for R Users. Importantly, I briefly talk about OOP and classes, giving a small code snippet of a class in Python.

What GitHub issue does your pull request address?

This PR addresses #2

Tell potential reviewers what kind of feedback you are soliciting.

Open to any feedback or comments!

New Content Checklist

New content/chapter is in an Rmd file with this kind of format and headers.
New content/chapter contains Learning Objectives and are in the correct format.
Bookdown successfully re-renders and any new content files have been added to the _bookdown.yml.
Spell check runs successfully in Github actions style-n-check).
Any newly necessary packages that are needed have been added to the Dockerfile and image.
Images are in the correct format for rendering.
Every new image has alt text and is in a Google Slide.
Each slide is described in the notes of the slide so learners relying on a screen reader can access the content. See https://lastcallmedia.com/blog/accessible-comics for more guidance on this.
The color palette choices of the slide are contrasted in a way that is friendly to those with color vision deficiencies.
You can check this using Color Oracle.

github-actions · 2024-02-12T22:17:14Z

No broken urls! 🎉
Comment updated at 2024-02-15 with changes from 276e4fb

github-actions · 2024-02-12T22:17:16Z

No spelling errors! 🎉
Comment updated at 2024-07-09-18:11:36 with changes from 0d537dc

tillahoffmann

This looks great! I've left a few specific comments inline. A few additional questions:

I couldn't see the two png files being referenced in the markdown. Should they be removed?
Maybe we can expand on the reason for using Python or when to stick with R?

tillahoffmann · 2024-02-13T16:19:47Z

+```
+
+
+### Classes and Object Oriented Programming (OOP)


Should we add something here about why OOP is useful or interesting, e.g., "co-locating" data and methods? Inheritance we should maybe save for a later chapter?

I don't know if talking about OOP topics like inheritance or encapsulation is too advanced for the students. I'll leave this up to @cansavvy

I think it would be good to introduce the students to this concept, but I'm not sure if we want to do it so soon. This should probably be its own chapter.
OOP is something a bit foreign for R users and something R can't do very well. So I would add that to the start comparison part at the beginning of this chapter in very general terms (i'll put a suggestion for how to do that) but then we can dive into the details later

tillahoffmann · 2024-02-13T16:22:48Z

@@ -0,0 +1,18 @@
+Version: 1.0


Should this workspace file be committed or listed in .gitignore?

Since we have the Markdown Notebook infrastructure set up, we can delete this file. I mainly created this file to work in RStudio.

howardbaik · 2024-02-13T18:52:00Z

This looks great! I've left a few specific comments inline. A few additional questions:
I couldn't see the two png files being referenced in the markdown. Should they be removed?
Maybe we can expand on the reason for using Python or when to stick with R?

I was using VSCode for the writing part, but since have switched to RStudio as my IDE and created a .Rproj file to facilitate my workflow. I'll look into those two png files and see if they are necessary!
100%. I can incorporate the knowledge from this video into this chapter.

Co-authored-by: Till Hoffmann <tillahoffmann@gmail.com>

…-jhu/python into howardbaek/r-vs-python

howardbaik · 2024-02-13T19:29:42Z

NOTE to myself

To convert .Rmd to .md:

Get rid of the curly brackets around the python.
Delete the R from .Rmd to make it a .md file
Delete all knitr code chunks
Replace the ottrpal image part with Till's syntax for including images.

To render locally: make "name_of_document" .ipynb.html

cansavvy

This is a great start @howardbaek !

cansavvy · 2024-02-15T14:36:57Z

+```
+
+
+### Classes and Object Oriented Programming (OOP)


I think it would be good to introduce the students to this concept, but I'm not sure if we want to do it so soon. This should probably be its own chapter.
OOP is something a bit foreign for R users and something R can't do very well. So I would add that to the start comparison part at the beginning of this chapter in very general terms (i'll put a suggestion for how to do that) but then we can dive into the details later

cansavvy · 2024-02-15T14:48:40Z

+
+### Classes and Object Oriented Programming (OOP)
+
+In R, the most widely used unit of composition for code is functions, and in Python, it is classes. Classes are how you organize and find methods in Python. This approach to code composition is called object oriented programming (OOP). Let's dive in the details of OOP.


I would put OOP in its own chapter. @howardbaek Can you make a new branch and put OOP in its own chapter and we can dive into this more on that branch/PR?

cansavvy · 2024-02-15T14:49:01Z

+
+An object is any entity that you want to store and process data about. Each object is an instance of a class in the computer's memory. A class is a template for creating objects. Creating an object from a class is called instantiation. It has properties and methods (functions for the class). 
+
+For example, we could have a class called Person. The properties of this class are what describe this Person class:


I like these kinds of toy examples! Excellent!

Co-authored-by: Candace Savonen <cansav09@gmail.com>

howardbaik · 2024-04-15T19:03:14Z

@tillahoffmann I've made more changes to 03-intro-to-python.md and committed that file. However, I'm not sure where these files came from:

.ipynb_checkpoints/03-intro-to-python-checkpoint.md
docs/03-intro-to-python.md
02-chapter_of_course_files/figure-html/unnamed-chunk-2-1.png
02-chapter_of_course_files/figure-html/unnamed-chunk-3-1.png

Is it safe to delete these files?

tillahoffmann · 2024-04-15T20:46:12Z

Let's delete the .ipynb_checkpoints directory and add it to the .gitignore.
Let's delete the python.Rproj and add *.Rproj to the .gitignore.
Regarding the docs/03-intro-to-python.md, I'm not sure how that was created. Maybe @cansavvy has an idea?
Regarding the _bookdown_files, I'll also defer to @cansavvy.

cansavvy · 2024-04-17T13:34:06Z

Let's delete the .ipynb_checkpoints directory and add it to the .gitignore.
Let's delete the python.Rproj and add *.Rproj to the .gitignore.
Regarding the docs/03-intro-to-python.md, I'm not sure how that was created. Maybe @cansavvy has an idea?
Regarding the _bookdown_files, I'll also defer to @cansavvy.

Totally agree on getting rid of the .ipynb_checkpoints files and adding to the gitignore.
The .Rproj file is not something automatically generated (I don't think) so should just be able to delete and that will be it.
docs and _bookdown_files are what are ultimately published from for the website.

github-actions · 2024-04-17T21:02:12Z

No broken url errors! 🎉
Comment updated at 2024-07-09-18:10:33 with changes from bab84da

howardbaik · 2024-04-17T21:06:08Z

Following changes have been made:

Delete .ipynb_checkpoints/ and add it to the .gitignore
Delete python.Rproj and add to .gitignore

github-actions · 2024-07-09T18:04:40Z

Re-rendered previews from the latest commit:

See preview of Bookdown here
See preview of Coursera/Leanpub version here
Download the preview of .docx file

Updated at 2024-07-09 with changes from 0d537dc

howardbaik added 4 commits January 9, 2024 12:15

Initial commit
b1532df

Start writing the Intro and Python syntax
34dae96

Initial draft
916e1ae

Use RStudio Projects
94b7c64

howardbaik requested a review from cansavvy February 12, 2024 22:15

howardbaik linked an issue Feb 12, 2024 that may be closed by this pull request
R vs Python Chapter #2
Closed

tillahoffmann reviewed Feb 13, 2024
View reviewed changes

howardbaikand others added 4 commits February 13, 2024 10:52

Update 03-intro-to-python.Rmd
801f01f
Co-authored-by: Till Hoffmann <tillahoffmann@gmail.com>

Update 03-intro-to-python.Rmd
169acef
Co-authored-by: Till Hoffmann <tillahoffmann@gmail.com>

Incorporate Till's feedback
33b1580

Merge branch 'howardbaek/r-vs-python' ofhttps://github.com/datatrail…
a942930
…-jhu/python into howardbaek/r-vs-python

cansavvy mentioned this pull request Feb 13, 2024
Note: Putting Images in this course -- different than other OTTR courses #11
Closed

cansavvy reviewed Feb 15, 2024
View reviewed changes

Apply suggestions from code review
460155f
Co-authored-by: Candace Savonen <cansav09@gmail.com>

howardbaik mentioned this pull request Apr 15, 2024
OOP #16
Open

howardbaik added 5 commits April 15, 2024 11:48

Convert Rmd to md
c9484ca

Oops
8f29873

Add the md file
61e8d00

Delete 03-intro-to-python.Rmd
894532f

Update .gitignore
1527ea3

Merge branch 'main' into howardbaek/r-vs-python
9287d34

Gitignore .ipynb_checkpoints/
2644c9d

howardbaik added 2 commits April 17, 2024 14:03

Delete python.Rproj
cc4dd2c

Delete .ipynb_checkpoints/03-intro-to-python-checkpoint.md
6921d06

cansavvy added 4 commits July 9, 2024 13:42

Merge branch 'main' into howardbaek/r-vs-python
ed0f2e6

Rmd -> md in _bookdown.yml
ae1e93d

Change to mds
0fb4414

index.Rmd
9c4791e

cansavvy added 2 commits July 9, 2024 14:09

Add to dictionary
12bc8f4

Add exclude files
0767ee5

cansavvy merged commit e3e4cd2 into mainJul 9, 2024

cansavvy deleted the howardbaek/r-vs-python branch July 9, 2024 18:14


		### Classes and Object Oriented Programming (OOP)

		In R, the most widely used unit of composition for code is functions, and in Python, it is classes. Classes are how you organize and find methods in Python. This approach to code composition is called object oriented programming (OOP). Let's dive in the details of OOP.


		An object is any entity that you want to store and process data about. Each object is an instance of a class in the computer's memory. A class is a template for creating objects. Creating an object from a class is called instantiation. It has properties and methods (functions for the class).

		For example, we could have a class called Person. The properties of this class are what describe this Person class:

Uh oh!

Conversation

howardbaik commented Feb 12, 2024• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Purpose/implementation Section

What changes are being implemented in this Pull Request?

What was your approach?

What GitHub issue does your pull request address?

Tell potential reviewers what kind of feedback you are soliciting.

New Content Checklist

Uh oh!

github-actionsBot commented Feb 12, 2024• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actionsBot commented Feb 12, 2024• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

tillahoffmann left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

howardbaik commented Feb 13, 2024

Uh oh!

howardbaik commented Feb 13, 2024• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cansavvy left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

howardbaik commented Apr 15, 2024

Uh oh!

tillahoffmann commented Apr 15, 2024

Uh oh!

cansavvy commented Apr 17, 2024

Uh oh!

github-actionsBot commented Apr 17, 2024• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

howardbaik commented Apr 17, 2024

Uh oh!

github-actionsBot commented Jul 9, 2024• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

howardbaik commented Feb 12, 2024•
edited
Loading

github-actionsBot commented Feb 12, 2024•
edited
Loading

github-actionsBot commented Feb 12, 2024•
edited
Loading

howardbaik commented Feb 13, 2024•
edited
Loading

github-actionsBot commented Apr 17, 2024•
edited
Loading

github-actionsBot commented Jul 9, 2024•
edited
Loading