From a80a4c1176a7c245c399a4749d59627c62bda939 Mon Sep 17 00:00:00 2001 From: Alexander Hess Date: Mon, 24 May 2021 15:16:29 +0200 Subject: [PATCH] Update the overall project info --- README.md | 84 +++++++++++++++++++++++----------------- pyproject.toml | 4 ++ static/link/README.md | 2 + static/link/to_gh.png | Bin 0 -> 1236 bytes static/link/to_py.png | Bin 0 -> 1308 bytes static/link/to_wiki.png | Bin 0 -> 503 bytes 6 files changed, 55 insertions(+), 35 deletions(-) create mode 100644 static/link/README.md create mode 100644 static/link/to_gh.png create mode 100644 static/link/to_py.png create mode 100644 static/link/to_wiki.png diff --git a/README.md b/README.md index 1264a22..80d8dae 100644 --- a/README.md +++ b/README.md @@ -1,50 +1,64 @@ -# Workshop: Machine Learning for Beginners +# An Introduction to Data Science -This repository contains the code for the workshop "Machine Learning for -Beginners" as presented in various occasions at -[WHU - Otto Beisheim School of Management](https://www.whu.edu), such as the -[Campus for Supply Chain Management](https://www.campus-for-supply-chain-management-cscm.de/), -[IdeaLab](https://www.idealab.io)'s [IdeaHack](http://www.ideahack.io), or -within many [executive education](https://ee.whu.edu/) programs. +This project is an introductory workshop + in **[Data Science ](https://en.wikipedia.org/wiki/Data_science)** + in the programming language **[Python ](https://www.python.org/)**. +To learn about Python and programming in detail, + this [introductory course ](https://github.com/webartifex/intro-to-python) is recommended. -## Prerequisites +### Table of Contents -To be suitable for *total beginners*, there are *no* prerequisites. -If you are interested to learn more after this workshop, check out the -full-semester course **[Introduction to Python & Programming](https://github.com/webartifex/intro-to-python)**. +- *Chapter 0*: Python in a Nutshell +- *Chapter 1*: Python's Scientific Stack +- *Chapter 2*: A first Example: Classifying Flowers +- *Chapter 3*: [Case Study: House Prices in Ames, Iowa ](https://github.com/webartifex/ames-housing) -## Installation +### Objective -To follow this workshop on your own computer, a working installation of -**Python 3.7** or higher is required. +The **main goal** is to **show** students + how **Python** can be used to solve typical **data science** tasks. -A popular and beginner friendly way is to install the [Anaconda Distribution](https://www.anaconda.com/distribution/) -that not only ships Python but comes pre-packaged with a lot of third-party -libraries from the so-called "scientific stack". -Just go to the [download](https://www.anaconda.com/distribution/#download-section) -section and install the latest version (i.e., *2020-02* with Python 3.7 at the -time of this writing) for your operating system. -Then, among others, you will find an entry "Jupyter Notebook" in your start -menu. -Click on it and a new tab in your web browser will open where you can switch -between folders as you could in your computer's default file browser. +### Prerequisites -To download the course's materials as a ZIP file, click on the green "Clone or -download" button on the top right on this website. -Then, unpack the ZIP file into a folder of your choosing (ideally somewhere -within your personal user folder so that the files show up right away). +To be suitable for *beginners*, there are *no* formal prerequisites. +It is only expected that the student has: +- a *solid* understanding of the **English** language and +- knowledge of **basic mathematics** from high school. + + +### Getting started & Installation + +To follow this workshop, an installation of **Python 3.8** or higher is expected. + +A popular and beginner friendly way is + to install the [Anaconda Distribution](https://www.anaconda.com/products/individual) + that not only ships Python itself + but also comes pre-packaged with a lot of third-party libraries + including [Python's scientific stack](https://scipy.org/about.html). + +Detailed instructions can be found [here ](https://github.com/webartifex/intro-to-python#installation). + + +## Contributing + +Feedback **is highly encouraged** and will be incorporated. +Open an issue in the [issues tracker ](https://github.com/webartifex/intro-to-data-science/issues) + or initiate a [pull request ](https://help.github.com/en/articles/about-pull-requests) + if you are familiar with the concept. +Simple issues that *anyone* can **help fix** are, for example, + **spelling mistakes** or **broken links**. +If you feel that some topic is missing entirely, you may also mention that. +The materials here are considered a **permanent work-in-progress**. ## About the Author -Alexander Hess is a PhD student at the Chair of Logistics Management at the -[WHU - Otto Beisheim School of Management](https://www.whu.edu) where he -conducts research on urban delivery platforms and teaches an introductory -course on Python (cf., [Fall Term 2019](https://vlv.whu.edu/campus/all/event.asp?objgguid=0xE57C2715B01B441AAFD3E79AA05CACCF&from=vvz&gguid=0x6A2B0ED5B2B949E69957A2099E7DE2F1&mode=own&tguid=0x3980A9BBC3BF4A638E977F2DC163F44B&lang=en), -[Spring Term 2020](https://vlv.whu.edu/campus/all/event.asp?objgguid=0x3354F4C108FF4E959CDD692A325D9AFE&from=vvz&gguid=0x262E29795DD742CFBDE72B12B69CEFD6&mode=own&lang=en&tguid=0x2E4A7D1FF3C34AD08FF07685461781C9)). - -Connect him on [LinkedIn](https://www.linkedin.com/in/webartifex). +Alexander Hess is a PhD student + at the Chair of Logistics Management at [WHU - Otto Beisheim School of Management](https://www.whu.edu) + where he conducts research on urban delivery platforms + and teaches coding courses based on Python in the BSc and MBA programs. +Connect with him on [LinkedIn](https://www.linkedin.com/in/webartifex). diff --git a/pyproject.toml b/pyproject.toml index 756eb4a..74ac3d9 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -21,6 +21,10 @@ keywords = [ ] license = "MIT" +readme = "README.md" +homepage = "https://github.com/webartifex/intro-to-data-science" +repository = "https://github.com/webartifex/intro-to-data-science" + [tool.poetry.dependencies] python = "^3.8" diff --git a/static/link/README.md b/static/link/README.md new file mode 100644 index 0000000..f5c9136 --- /dev/null +++ b/static/link/README.md @@ -0,0 +1,2 @@ +This folder contains small images +that are used to enhance the links in the notebooks and markdown files. diff --git a/static/link/to_gh.png b/static/link/to_gh.png new file mode 100644 index 0000000000000000000000000000000000000000..01f1a8a25c1065be403c7573aab98981cfc0147f GIT binary patch literal 1236 zcmZWp3v5$W7(Tu2?Y6G%ef2U@g3iQl8pn3mJs{N(hikU!*340YK_R!c-2{e1DbeX7 zL^MJ)(LH$9sGAJLO~?`+naq(Q10{wC1m^?ec*wS{9SE4P(cSsoUNe*V=k%Qa{eS=0 zrrWALWfqg&L7Z0Egxnk#16%;aC=#$U!$uK{?O!@XrWLI1xgLnqb2!>W=ET zq*KL^RQ}x><6uH&DapMM(g;!E!IQj!1UOZSOeQdZwm2$rJa4sFDV@$p)B2^^5uwQ;IT`=%*H4jQxHqabLN0Id<`Z6L(sRH+|85c$2gB&WSaX!z+xGo?10B zc~bc)(=n)=j4P)s=5LkwgmV12G7&vLfByNgZ>H|2axJs ze5R~a&zUQ4!$=8LRJl{G8+42=??_kUVYtRCN=v+{gML|V`>3sDNAvdP9W8BgK$crt zmsfjhRvqg2a$j!VnNy#&AL#t*^RE33@=JmGjsp>SP3_CR)xmZCwRJa#MgnJtVppT5 zW8;yb(SfV+YhynQ4L`_!ca~7~C6R~P&AuyKb4*@b<_%TmJoQ2om900dcVsyV_STnI zT{CWIyiibF>kI^kuiyBK>TQ~!-*pd|9i72H#qG-ymx_*T3`gh9wTJgSzv8!FX_sqZ z!)SEeHxeKFRC?t?AoA$aW1jG0f7X^CyMNhm<6JnePrh>0{r=9alC(8<<14Ba#1H&(%P{RubhEf9thF1v;3|2E37{m+a>Ks7*M-?-hnaGtt%7KH0J;izBV5udL8 z9?&jqa@XI_uyt&Ww;P12`0Ma6Gl9ddGu*O@KO zXExfrKJEDLrv3j*T7OO}_}X#0)UCHJobR2SdE;pG|JT|7&nbRCD(z~{?pV3Pu5^h> z#?;1Yr~hwq{-2R~uu0rVgViLVO*gDU!YXoVhxM;pJ|EB7eLiFI`MB1XBl2GkOFi8t zUK-2I!^H^kGLSs9&h76F$KRJsf1lI(b4GsqB$13@u4s1-L0*KKFW3G4-Sho_%jy4h z^M&>7aJ@jrm#c2yuQ>d=Wd7%Z&Yv@izt0*y-l>!1i=w77L%u9UCL>%d+?_ALfy>j1 z)mVd>kDCc%j%&jPU})E@Jh$@5ExXE9_GL@Wv!`3+%m9Ww5Se97^=jMU*09m3YL#8- zVypZ)=2_E#f&c%Wmw)d;@AjSUO`Du+)&Qdt7}r2uK=uD`Ie2&O21c<c&+o`r>AM_!0K!=Yh)BxpU{Ndinob z^sA>;b6)?u6|(5>t>O=V7dYvpWad0QaOlvHV=JSzn0Q2kzdnEQy4Bx7Lx_RN{_p?) z70QBK%wo-Vzy5r&B1oErfq_}VDj+h#U7MdVoY4@J@fef5-CdXkd3-(rIqW5#zOL*~ zSeO_UEU%u9egqWy>FMGa!f`!0At50p`S}dn_Q~C|+ov0+LnnmZ#%c?sdm`9sJ(9C{`G4c6%X(F zDs7f`YftLxi5oj#ni&_jy|pfjiinE5edE?m>o-LuNd@=bK6>@+-NTnp-)=sB{rr5z zg#3hnf)o4xvh&GV$w-Nv6A+XXl`VeqV&h|VzjDIM-7jIs@d-?Wtd&U## zb1gDIO<8$)+4&ik-HnV4OkttBmhQ-$3k(F+64!{5l*E!$tK_0oAjM#0U}T_cV4`ba z6k=d#Wo&F^V5)6kWMyDrsj3xM7|8!A0uYZf|F~9NnhzAky_>?>fuV zpWbcli70-j`}=z7lnEYlPbgm$5N`H?)FK#IZ0z{o(?z(m);D8#_f%Glh>#8BJ7$jZRL=Y+a9iiX_$l+3hB+!}1B z&i@Y7APKS|I6tkVJh3R1p}f3YFEcN@I61K(RWH9NefB#WDWD<-Pgg&ebxsLQ04%4l A7XSbN literal 0 HcmV?d00001