You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+73-6Lines changed: 73 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,7 +12,9 @@ In this [Houston Data Science][1] meetup we will introduce our members to data s
12
12
13
13
14
14
## Agenda
15
-
* Create a Github Account, install Git locally and fork and clone this respository
15
+
* Create a Github Account
16
+
* Install Git locally
17
+
* Fork and clone this respository
16
18
* Install Python 3 with Anaconda
17
19
* Install Sublime Text 3 along with packages for enhancing development
18
20
* Install PyCharm EDU
@@ -26,16 +28,73 @@ In this [Houston Data Science][1] meetup we will introduce our members to data s
26
28
* seaborn
27
29
* connect to sqlite
28
30
29
-
#Install Git
30
-
Git is a popular version control system used to keep track of file changes during software development.
31
+
## Create Github Account
32
+
The page is currently being hosted on Github, a site that hosts remote Git repositories. Github is a popular place to share and collaborate on software projects. The most popular data science libraries are all hosted on Github. On Github, you can find the latest developments, track bugs and join the conversation with fellow developers.
31
33
32
-
> Downl
34
+
> 1. If you have not already done so, create a Github account now.
35
+
36
+
## Install Git Locally
37
+
Git is a popular version control system used to keep track of file changes during software development. Github is a private company independent from Git. Git is free software that tracks your file changes on your local machine.
38
+
39
+
Let's install Git on your local machine
40
+
> 1. Visit the [Git downloads page][3] and download Git for your operating system.
41
+
> 2. After installing Git you will need to run a couple commands to link it to your github profile.
42
+
> 3. Run the commands in the **Your Identity**[in this link][4]. The same commands are copied below.
Whenever you are in position to make changes to someone elses project on Github you will need to `fork` the repository and then `clone` it to your local machine. After making changes you will `commit` your work locally and then `push` those changes back to Github where you will finally make a `pull` request so that the new changes may be incorporated into the project.
51
+
52
+
![git tracking][7]
53
+
54
+
Let's go through this process now.
55
+
> 1. At the very top of this repository, you will see a `Fork` button. Click it and fork the repository. This makes an exact replica of the repository under your user profile.
56
+
> 1. Under your Github profile (not mine), again go the top of the page and look for the green `Clone or download` button. Click it and copy the url.
57
+
> 1. On your local machine, create a new folder somewhere in your file system. Title it something like `Github Repos`
58
+
> 1. Open up a terminal (Windows users open the program Git Bash)
59
+
> 1. Run the command `git clone https://github.com/tdpetrou/Intro-to-Data-Science-with-Python.git` but replace this URL with the one you copied from step 2.
60
+
> 1. You now have a replica of the repository on your local machine and are ready to make changes
61
+
> 1. Staying in the terminal run the command `cd Intro-to-Data-Science-with-Python`
62
+
> 1. Open up the README.md file in a text editor. That is this current file.
63
+
> 1. Make a single edit to the file and save it. Add your name or something personal on the very top line.
64
+
> 1. Go back to the terminal and run the command `git add README.md`. Git is now tracking this file and it is in the staging area.
65
+
> 1. Run the command `git commit -m "your message here"`. Replace 'your message here' with something personal. All commits must have a message about what has changed.
66
+
> 1. The last command just took a snapshot of your repository and you can revert back to it now at any point in the future.
67
+
> 1. Run the command `git push origin master`. This will align your remote repository with your local repository.
68
+
> 1. Go back to your github profile and verify the changes.
69
+
> 1. Towards the top of the page click the `New pull request` button.
70
+
> 1. Now I will get a notification that you are wanting to modify a file of mine. I can review the revisions and accept/reject your pull request.
33
71
34
72
35
73
# Installing Python 3 with Anaconda
36
74
Anaconda is by far the most popular distribution of the Python programming language for data scientists. Anaconda packages together all the popular data science libraries along with the package manager `conda`.
37
75
38
-
Anaconda is not a necessity. Python may be installed independently from source from [Python.org][2] along with its own package manager `pip`. But for begninners it is highly suggested to use Anaconda.
76
+
Anaconda is not a necessity. Python may be installed independently from source from [Python.org][2] along with its own package manager `pip`. But for begninners it is highly suggested to use Anaconda as the `conda`. You can read more about the differences [Anaconda with conda and pip here][5].
77
+
78
+
> Visit the [Anaconda downloads page][6] and install Anaconda with Python 3.6 for your operating system. Use the graphical installer. Anaconda comes packaged with a graphical user interface for beginning projects as well as the popular IDE Spyder.
79
+
80
+
# Installing Sublime Text 3
81
+
Now that we have Anaconda installed we can begin to use Python. There are many ways to run and write Python. Python can be written in any text editor, even the basic ones that come preinstalled with all operating systems. Sublime Text 3 is an enhanced text editor that is highly customizable to help make programming in Python easier.
82
+
83
+
> [Download and install Sublime Text 3][8] and open it.
84
+
85
+
Any programming language may be written in Sublime. To enhance the editing experience of sublime specifically for Python we first need to install the package control manager. There are 1000's of third party packages written for Sublime.
86
+
87
+
> 1. Visit the [Package Control website][9]. All Sublime packages can be found here.
88
+
> 1. Click the `install now` button and follow the instructions to install the package manager.
89
+
90
+
Now that you have the package manager you can begin to install packages. We will install the Anaconda Sublime package. This is completely independent of the Anaconda distribution, it just happens to have the same name. It adds code completion, linting, inline documentation and more. Visit the [Anacond Sublime package home page][10] for more info
91
+
92
+
> 1. To access the package manager, you must first open up the `command palette` with `cmd + shift + P`. It is also found under Tools -> Command Palette.
93
+
> 1. In the text box that pops up, begin typing in the word `install`. Click on `Package Control: Install Package`
94
+
> 1. A new text box will open up with a huge list of available packages
95
+
> 1. Type in 'Anaconda'. It should be the first option damnwidget.github.io/anaconda
96
+
97
+
[Watch this video][11] to get more in-depth tutorial on Sublime packages for Python.
39
98
40
99
41
100
pycharm
@@ -50,4 +109,12 @@ Typical workflows for data scientists
0 commit comments