├── .gitignore
├── GO_BGC_Workshop_Python_tutorial.ipynb
└── README.md


/.gitignore:
--------------------------------------------------------------------------------
  1 | # Byte-compiled / optimized / DLL files
  2 | __pycache__/
  3 | *.py[cod]
  4 | *$py.class
  5 | 
  6 | # C extensions
  7 | *.so
  8 | 
  9 | # Distribution / packaging
 10 | .Python
 11 | build/
 12 | develop-eggs/
 13 | dist/
 14 | downloads/
 15 | eggs/
 16 | .eggs/
 17 | lib/
 18 | lib64/
 19 | parts/
 20 | sdist/
 21 | var/
 22 | wheels/
 23 | pip-wheel-metadata/
 24 | share/python-wheels/
 25 | *.egg-info/
 26 | .installed.cfg
 27 | *.egg
 28 | MANIFEST
 29 | 
 30 | # PyInstaller
 31 | #  Usually these files are written by a python script from a template
 32 | #  before PyInstaller builds the exe, so as to inject date/other infos into it.
 33 | *.manifest
 34 | *.spec
 35 | 
 36 | # Installer logs
 37 | pip-log.txt
 38 | pip-delete-this-directory.txt
 39 | 
 40 | # Unit test / coverage reports
 41 | htmlcov/
 42 | .tox/
 43 | .nox/
 44 | .coverage
 45 | .coverage.*
 46 | .cache
 47 | nosetests.xml
 48 | coverage.xml
 49 | *.cover
 50 | *.py,cover
 51 | .hypothesis/
 52 | .pytest_cache/
 53 | 
 54 | # Translations
 55 | *.mo
 56 | *.pot
 57 | 
 58 | # Django stuff:
 59 | *.log
 60 | local_settings.py
 61 | db.sqlite3
 62 | db.sqlite3-journal
 63 | 
 64 | # Flask stuff:
 65 | instance/
 66 | .webassets-cache
 67 | 
 68 | # Scrapy stuff:
 69 | .scrapy
 70 | 
 71 | # Sphinx documentation
 72 | docs/_build/
 73 | 
 74 | # PyBuilder
 75 | target/
 76 | 
 77 | # Jupyter Notebook
 78 | .ipynb_checkpoints
 79 | 
 80 | # IPython
 81 | profile_default/
 82 | ipython_config.py
 83 | 
 84 | # pyenv
 85 | .python-version
 86 | 
 87 | # pipenv
 88 | #   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
 89 | #   However, in case of collaboration, if having platform-specific dependencies or dependencies
 90 | #   having no cross-platform support, pipenv may install dependencies that don't work, or not
 91 | #   install all needed dependencies.
 92 | #Pipfile.lock
 93 | 
 94 | # PEP 582; used by e.g. github.com/David-OConnor/pyflow
 95 | __pypackages__/
 96 | 
 97 | # Celery stuff
 98 | celerybeat-schedule
 99 | celerybeat.pid
100 | 
101 | # SageMath parsed files
102 | *.sage.py
103 | 
104 | # Environments
105 | .env
106 | .venv
107 | env/
108 | venv/
109 | ENV/
110 | env.bak/
111 | venv.bak/
112 | 
113 | # Spyder project settings
114 | .spyderproject
115 | .spyproject
116 | 
117 | # Rope project settings
118 | .ropeproject
119 | 
120 | # mkdocs documentation
121 | /site
122 | 
123 | # mypy
124 | .mypy_cache/
125 | .dmypy.json
126 | dmypy.json
127 | 
128 | # Pyre type checker
129 | .pyre/
130 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # Tutorial for 2021 GO-BGC Science Workshop (Python version)
 2 | 
 3 | **To get started:**
 4 | 
 5 | 1. Navigate to the file [`GO_BGC_Workshop_Python_tutorial.ipynb`](https://github.com/go-bgc/workshop-python/blob/main/GO_BGC_Workshop_Python_tutorial.ipynb) in this repository.
 6 | 2. Click the "Open in Colab" button at the top of the file.
 7 | 3. If needed, sign into your Google account. A standard, free, personal Google account is recommended, as not all institutional Google accounts allow Colab access to Google Drive.
 8 | 4. In Google Colab, near the top menu bar, click on the button that says "Copy to Drive."
 9 | 5. Switch to the browser tab with the newly created "Copy of GO-BGC Workshop - Python tutorial.ipynb" file. This version is editable and is saved in your Google Drive in a folder called "Colab Notebooks." You are ready to go!
10 | 
11 | ——
12 | 
13 | **Notes:**
14 | 
15 | If you would just like to view the tutorial notebook, a partially-interactive rendered view is available here: https://nbviewer.jupyter.org/github/go-bgc/workshop-python/blob/main/GO_BGC_Workshop_Python_tutorial.ipynb.
16 | 
17 | If for some reason you do not have access to a Google account, you can download the .ipynb file linked above and run it from a local Jupyter installation. When running this notebook locally, the first code block that authenticates with Google Drive should be deleted and file paths in the following code block should be changed to match your local file structure.
18 | 
19 | **Tutorial Recordings:**
20 | <br>
21 | BGC Argo data overview: https://youtu.be/--3PubEoMT0 
22 | <br>
23 | Python tutorial session: https://youtu.be/5Gz-SsTuLdw
24 | 


--------------------------------------------------------------------------------