From e435f52a76acb47ce85d86503a6d6a7315644f49 Mon Sep 17 00:00:00 2001 From: bairdlangenbrunner Date: Sun, 15 Jul 2018 21:16:21 -0700 Subject: [PATCH] updates to about and website structure --- .../:name/index.html} | 5 +++-- _site/about/index.html | 22 +++++++++++++------ _site/conda/index.html | 2 +- .../index.html} | 7 +++--- _site/feed.xml | 2 +- _site/where-to-start/index.html | 12 ++++++---- .../_conda/setting-up-conda-environments.md | 4 +++- collections/_pages/_drafts/resources.md | 4 ++++ collections/_pages/about.md | 20 ++++++++++++----- collections/_pages/where-to-start.md | 13 +++++++---- 10 files changed, 62 insertions(+), 29 deletions(-) rename _site/{collections/_conda/setting-up-conda-environments.html => :collection/:name/index.html} (97%) rename _site/conda/{setting-up-conda-environments.html => setting-up-conda-environments/index.html} (97%) diff --git a/_site/collections/_conda/setting-up-conda-environments.html b/_site/:collection/:name/index.html similarity index 97% rename from _site/collections/_conda/setting-up-conda-environments.html rename to _site/:collection/:name/index.html index c882eba..69c9399 100644 --- a/_site/collections/_conda/setting-up-conda-environments.html +++ b/_site/:collection/:name/index.html @@ -13,7 +13,7 @@ - + @@ -126,7 +126,7 @@

Conda environments for NCO, NCL, and
-

Disclaimer: This assumes knowledge of a conda-based Python installation (e.g., Anaconda or Miniconda). I’ll add more info on what this is in another post.

+

Disclaimer: This assumes knowledge of a conda-based Python installation (e.g., Anaconda or Miniconda). Read through the documentation websites or the [where to start][where-to-start-page] page to learn more about this.

Environments in conda are incredibly useful. They allow you to install parallel versions of Python and its packages, or even other languages and software, that mind their own business and never affect one another.

@@ -243,6 +243,7 @@

Keeping environments up-to-date

Then choose y to approve of the udpates. Some packages will inevitably be downgraded, but I usually go for it anyway.

+

[where-to-start-page]:

diff --git a/_site/about/index.html b/_site/about/index.html index f7ce118..dbe4903 100644 --- a/_site/about/index.html +++ b/_site/about/index.html @@ -7,7 +7,7 @@ about - + @@ -121,16 +121,24 @@
-

Hi, and welcome to Python for climate scientists.

+

Hi, and welcome to Python for climate scientists!

-

I’ve set this up to document my experience using Python for data analysis and plotting. My intention here is not to reinvent the wheel, since there are many great resources out there doing something like this. Instead, I hope to organize the moving parts I’ve seen online and create a repository that gives a good cross section of what exists already, as well as fill in some holes I’ve noticed.

+

My name is Baird, and I’m currently a postdoc at UC Irvine.

-

This project is in its infancy, and I expect it to evolve in the coming months and years. Please let me know if you want to be part of it, or if you’d like to see something specific here.

+

I started using Python toward the end of college (circa 2008), and I’ve watched a great Earth science user base develop around it since then. In the past few years in particular, it seems like increasingly powerful packages are popping up and evolving for data analysis and plotting. It’s all very exciting and overwhelming at once.

- +

Despite the fantastic options now available to Python experts and beginners alike, it seems like a community-driven website that gives information about resources and practical advice is somewhat missing. With that in mind, my intention here is to organize these moving parts and create a platform that gives a good cross section of what resources exist already. I’d also like to fill in some holes I’ve noticed and talked about with peers, and provide a space for other Python folks to do the same.

+ +

This project is in its infancy, and I expect it to evolve in the coming months and years. And fair warning: Please expect reorganization as I settle things, and reach out if you want to be part of this or have advice on how to improve things. The code is available on GitHub, so if you feel particularly git-savvy (and don’t mind sorting through my mess), take a gander.

-

Thanks
-Baird

+

If you’re new to Python and found this hoping to get started on things, check out the inaugural papers here:

+
    +
  • Where to start (spoiler: use conda!)
    • +
  • A resources page to catalogue the cool stuff already out there
    • +
  • Some practical examples that improve quality of life while coding, data-wrangling, and plotting geospatial data
    • +
+ +
diff --git a/_site/conda/index.html b/_site/conda/index.html index faa99a8..2f74ca0 100644 --- a/_site/conda/index.html +++ b/_site/conda/index.html @@ -132,7 +132,7 @@

conda

- Conda environments for NCO, NCL, and CDO + Conda environments for NCO, NCL, and CDO

diff --git a/_site/conda/setting-up-conda-environments.html b/_site/conda/setting-up-conda-environments/index.html similarity index 97% rename from _site/conda/setting-up-conda-environments.html rename to _site/conda/setting-up-conda-environments/index.html index 2e84063..3b4f107 100644 --- a/_site/conda/setting-up-conda-environments.html +++ b/_site/conda/setting-up-conda-environments/index.html @@ -7,13 +7,13 @@ Conda environments for NCO, NCL, and CDO - + - + @@ -125,7 +125,7 @@

-

Disclaimer: This assumes knowledge of a conda-based Python installation (e.g., Anaconda or Miniconda). I’ll add more info on what this is in another post.

+

Disclaimer: This assumes knowledge of a conda-based Python installation (e.g., Anaconda or Miniconda). Read through the documentation websites or the [where to start][where-to-start-page] page to learn more about this.

Environments in conda are incredibly useful. They allow you to install parallel versions of Python and its packages, or even other languages and software, that mind their own business and never affect one another.

@@ -242,6 +242,7 @@

Keeping environments up-to-date

Then choose y to approve of the udpates. Some packages will inevitably be downgraded, but I usually go for it anyway.

+

[where-to-start-page]:

diff --git a/_site/feed.xml b/_site/feed.xml index 9dedac7..50d3fce 100644 --- a/_site/feed.xml +++ b/_site/feed.xml @@ -1 +1 @@ -Jekyll2018-07-15T19:01:04-07:00http://localhost:4000/Python for climate scientistsMaterials for Earth science data wranglingBaird \ No newline at end of file +Jekyll2018-07-15T21:16:00-07:00http://localhost:4000/Python for climate scientistsMaterials for Earth science data wranglingBaird \ No newline at end of file diff --git a/_site/where-to-start/index.html b/_site/where-to-start/index.html index 5ef968a..676da7f 100644 --- a/_site/where-to-start/index.html +++ b/_site/where-to-start/index.html @@ -138,12 +138,12 @@

where to start

doge

-

One note before I go further: Most of the tips here are based on my experience with Mac OS, but if you’re a Windows or LINUX user, use this resource with other documentation specific to your OS.

+

Note: Most of the tips here are based on experience with Mac OS. If you’re a Windows or LINUX user, use this resource with other documentation specific to your OS.

-

1. To get Python going, use Anaconda or Miniconda

+

1. To install Python, start with Anaconda or Miniconda

I recommend using either Anaconda or Miniconda to install and maintain Python on your machine(s).

@@ -164,10 +164,10 @@

Why conda?

  1. -

    This is getting a little ahead of myself, but with conda, you can install multiple parallel “environments” of Python (or whatever other languages you prefer). That means you can have a Python installation you use most of the time and an older one that works with some random chunk of code you inherited from a student in your lab who graduated years ago.

    +

    This is getting a little ahead of myself, but with conda, you can install multiple parallel “environments” of Python (or whatever other languages you prefer). That means you can have a Python installation you use most of the time and an older one that works with some random chunk of code you inherited from someone else who worked on an older version of Python.

  2. -

    Another powerful aspect of conda is that you can use it to install non-Python-related software. For example, you can set up a single or different environments for NCO (NetCDF Operators), CDO (Climate Data Operators), and the NCL (NCAR Command Language). This, in my opinion, is what makes it so valuable.

    +

    Another powerful aspect of conda is that you can use it to install non-Python-related software. For example, you can set up a single or different environments for NCO (NetCDF Operators), CDO (Climate Data Operators), and the NCL (NCAR Command Language). This, in my opinion, is what makes it so valuable; see my separate post on [setting up these environments][setting-up-conda-environments-post] for more information.

  3. Anaconda/Miniconda are free (their developer, Continuum, offers proprietary add-ons, but there’s no reason you’ll ever need those).

    @@ -295,6 +295,10 @@

    4. Go forth and code

  4. This Getting Started tutorial on Medium
    5. +

    5. Optional: Read about how to set up some useful conda environments

    + +

    Check out my approach on setting up NCO, CDO, and NCL using conda alone.

    + +Despite the fantastic options now available to Python experts and beginners alike, it seems like a community-driven website that gives information about resources and practical advice is somewhat missing. With that in mind, my intention here is to organize these moving parts and create a platform that gives a good cross section of what resources exist already. I'd also like to fill in some holes I've noticed and talked about with peers, and provide a space for other Python folks to do the same. + +This project is in its infancy, and I expect it to evolve in the coming months and years. And fair warning: Please expect reorganization as I settle things, and reach out if you want to be part of this or have advice on how to improve things. The code is available on GitHub, so if you feel particularly git-savvy (and don't mind sorting through my mess), [take a gander][github-site]. -Thanks -Baird +If you're new to Python and found this hoping to get started on things, check out the inaugural papers here: +* [Where to start][where-to-start-page] (spoiler: use conda!) +* A resources page to catalogue the cool stuff already out there +* Some practical examples that improve quality of life while coding, data-wrangling, and plotting geospatial data + +[github-site]: https://github.com/bairdlangenbrunner/python-for-climate-scientists/ +[where-to-start-page]: https://bairdlangenbrunner.github.io/python-for-climate-scientists/where-to-start/ + diff --git a/collections/_pages/where-to-start.md b/collections/_pages/where-to-start.md index 12408d8..fd44e41 100644 --- a/collections/_pages/where-to-start.md +++ b/collections/_pages/where-to-start.md @@ -15,11 +15,11 @@ Are you excited yet?! ![doge](https://media.giphy.com/media/9gn4lhW6wiQ6c/giphy.gif) -> *One note before I go further: Most of the tips here are based on my experience with Mac OS, but if you're a Windows or LINUX user, use this resource with other documentation specific to your OS.* +> *Note: Most of the tips here are based on experience with Mac OS. If you're a Windows or LINUX user, use this resource with other documentation specific to your OS.* --- -### 1. To get Python going, use Anaconda or Miniconda +### 1. To install Python, start with Anaconda or Miniconda I recommend using either **[Anaconda or Miniconda][conda.io]** to install and maintain Python on your machine(s). @@ -31,10 +31,10 @@ I recommend using either **[Anaconda or Miniconda][conda.io]** to install and ma If you're brand new to Python, Anaconda will probably be a safer bet. It's a little bulky and will take a little longer to install, but it will also give you the most options while learning the language. Miniconda is a stripped down version of Anaconda, so if you don't have much disk space, go with that. Personally, I like Miniconda, since it's more lightweight for laptops, shared computers, or login nodes where disk space is limited. #### Why conda? -> 1. This is getting a little ahead of myself, but with conda, you can install multiple parallel "environments" of Python (or whatever *other* languages you prefer). That means you can have a Python installation you use most of the time *and* an older one that works with some random chunk of code you inherited from a student in your lab who graduated years ago. +> 1. This is getting a little ahead of myself, but with conda, you can install multiple parallel "environments" of Python (or whatever *other* languages you prefer). That means you can have a Python installation you use most of the time *and* an older one that works with some random chunk of code you inherited from someone else who worked on an older version of Python. > > -> 2. Another powerful aspect of conda is that you can use it to install non-Python-related software. For example, you can set up a single or different environments for [NCO (NetCDF Operators)][nco-link], [CDO (Climate Data Operators)][cdo-link], and the [NCL (NCAR Command Language)][ncl-link]. This, in my opinion, is what makes it so valuable. +> 2. Another powerful aspect of conda is that you can use it to install non-Python-related software. For example, you can set up a single or different environments for [NCO (NetCDF Operators)][nco-link], [CDO (Climate Data Operators)][cdo-link], and the [NCL (NCAR Command Language)][ncl-link]. This, in my opinion, is what makes it so valuable; see my separate post on [setting up these environments][setting-up-conda-environments-post] for more information. > > > 3. Anaconda/Miniconda are free (their developer, Continuum, offers proprietary add-ons, but there's no reason you'll ever need those). @@ -108,6 +108,10 @@ I recommend skimming the [Jupyter Notebook documentation][jupyter-notebook-doc] * An unofficial (but seemingly legitimate) [Quick Start Guide](http://jupyter-notebook-beginner-guide.readthedocs.io/en/latest/) * This [Getting Started](https://medium.com/codingthesmartway-com-blog/getting-started-with-jupyter-notebook-for-python-4e7082bd5d46) tutorial on Medium +### 5. Optional: Read about how to set up some useful conda environments + +Check out my approach on [setting up NCO, CDO, and NCL][conda-environments-page] using conda alone. +