-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
major! feature/water module → dev (#31)
* fix(build): resolve page build issue - this issue was particularly affecting the page building action due to a typo left over from previous merge conflict. this commit resolves that issue. * fix(merge): remove merge headers - this commit removes the leftover merge headers (both incoming and current) from the files which resulted in faulty rendering. * refactor: drop naming prefixes Signed-off-by: Akshay Mestry <xa@mes3.dev>
- Loading branch information
Showing
21 changed files
with
2,162 additions
and
18 deletions.
There are no files selected for viewing
File renamed without changes.
670 changes: 670 additions & 0 deletions
670
docs/source/_documentation/_modules/_001-water/wsim-gldas.rst
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,95 @@ | ||
.. Author: Akshay Mestry <xa@mes3.dev> | ||
.. Created on: Monday, September 09 2024 | ||
.. Last updated on: Saturday, September 14 2024 | ||
=============================================================================== | ||
Overview | ||
=============================================================================== | ||
|
||
.. title-hero:: | ||
:icon: fa-solid fa-shapes | ||
:summary: | ||
Get an overview of the learning modules that form the backbone of the | ||
TOPST SCHOOL program, and see how each module contributes to open | ||
science. | ||
|
||
.. tags:: getting-started, modules, water-module, open-science-101 | ||
|
||
.. contributors:: | ||
:timestamp: September 14, 2024 | ||
:location: Chicago, IL | ||
|
||
- Akshay Mestry | ||
- xa@mes3.dev | ||
- https://github.com/xames3/ | ||
|
||
We're thrilled to welcome you to the modules of :term:`NASA`'s :term:`SCHOOL` | ||
program! This curriculum is part of NASA's :term:`TOPS` Training initiative, | ||
an effort designed to empower learners with practical skills in the **data | ||
science lifecycle** using real-world data from NASA's Earth Sciences division. | ||
By participating in this program, you'll join a community of passionate | ||
researchers and learners dedicated to advancing :term:`Open Science` through | ||
collaboration, transparency, and inclusivity. | ||
|
||
.. dropdown:: Exploring the Critical Role of Water in Society | ||
|
||
Water is one of the Earth's most essential resources, and understanding its | ||
behavior is key to predicting environmental changes and mitigating their | ||
impacts. It is the first SCHOOL module and we'll explore **Water** and its | ||
relationship with humans. How does the water cycle impact society? How are | ||
changes in water availability, quality, and patterns affecting communities | ||
worldwide? [#]_ This module aims to answer these vital questions. | ||
|
||
.. video:: https://svs.gsfc.nasa.gov/vis/a010000/a012900/a012950/ | ||
12876_GRACEFull_NewBrand_high.mp4 | ||
|
||
You'll delve into three carefully selected **use cases** that highlight | ||
critical water-related issues, such as usage, safety, and anomalies like | ||
droughts and floods. Each case presents a unique dataset that will guide | ||
you through the process of accessing, analyzing, and visualizing water | ||
data. We'll teach you how to clean and process this data, focus on areas | ||
of interest, and ultimately, create compelling visualizations that can be | ||
shared within your community. By the end of this module, you'll not only | ||
have a better understanding of water science but also be equipped to apply | ||
these skills to other **Open Science** challenges. | ||
|
||
Whether you're an **undergraduate student** or an **early-career | ||
researcher** with some exposure to coding, this module is designed to meet | ||
you where you are. You don't need to be an Earth scientist or a coding | ||
expert; all that's required is a willingness to learn. Throughout this | ||
journey, you'll become familiar with the **data science lifecycle**, | ||
learning how to acquire, process, and analyze data, particularly in the | ||
context of **Open Science**. | ||
|
||
The skills you'll acquire are adaptable and scalable, allowing you to | ||
integrate them into your own research or academic projects. This module won't | ||
just teach you about water science |html-dash| it will help you become a more | ||
effective data-driven researcher. | ||
|
||
.. dropdown:: Prerequisites & Glossary | ||
|
||
Before starting the hands-on lessons, you'll need to familiarize yourself | ||
with certain **prerequisites** and **technical terms**. These will help | ||
you navigate the dataset and analytical processes more effectively. We've | ||
put together a glossary of key terms that will be used throughout the | ||
module, ensuring you're never left in the dark. | ||
|
||
:doc:`Learn more here <../_resources/glossary>` |chevron-right| | ||
|
||
.. important:: | ||
|
||
This program doesn't aim to deliver a comprehensive Earth science | ||
curriculum or make you a coding guru. Instead, it is here to provide you | ||
with a solid foundation that you can build upon and apply to your own | ||
:term:`Open Science` projects. If you want to further explore Open Science | ||
concepts, be sure to check out NASA's TOPS Open Science 101 Curriculum. | ||
[#]_ | ||
|
||
.. rubric:: References | ||
:heading-level: 2 | ||
|
||
.. [#] Checkout NASA's `Open Science Curriculum | ||
<https://nasa.github.io/Transform-to-Open-Science/>`_. | ||
.. [#] NASA satellite `observations <https://svs.gsfc.nasa.gov/12950/ | ||
#media_group_325745>`_ combined with maps of human activities show where | ||
freshwater levels are changing and why. |
21 changes: 21 additions & 0 deletions
21
docs/source/_documentation/_resources/external-resources.rst
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,21 @@ | ||
.. Author: Akshay Mestry <xa@mes3.dev> | ||
.. Created on: Monday, September 09 2024 | ||
.. Last updated on: Thursday, September 12 2024 | ||
=============================================================================== | ||
External Resources | ||
=============================================================================== | ||
|
||
.. title-hero:: | ||
:icon: fa-solid fa-arrow-up-right-from-square fa-flip-horizontal | ||
:summary: | ||
Access a curated collection of external tools, guides, and | ||
repositories that support your journey in open science. | ||
|
||
.. tags:: open-science-101 | ||
|
||
.. contributors:: | ||
|
||
- Akshay Mestry | ||
- xa@mes3.dev | ||
- https://github.com/xames3/ |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,269 @@ | ||
.. Author: Akshay Mestry <xa@mes3.dev> | ||
.. Created on: Monday, September 09 2024 | ||
.. Last updated on: Thursday, September 12 2024 | ||
=============================================================================== | ||
Glossary | ||
=============================================================================== | ||
|
||
.. title-hero:: | ||
:icon: fa-solid fa-spell-check | ||
:summary: | ||
A quick reference to all the terms, phrases, and links you'll encounter | ||
on this site, your one-stop guide to navigating with ease. | ||
|
||
.. tags:: getting-started, open-science, github, preparing-workspace | ||
|
||
.. contributors:: | ||
|
||
- America Munoz | ||
- amunoz8@my.nl.edu | ||
- https://github.com/america-m | ||
|
||
- Dhruvil Prajapati | ||
- dprajapati@my.nl.edu | ||
- https://github.com/dhru-repository | ||
|
||
- Akshay Mestry | ||
- xa@mes3.dev | ||
- https://github.com/xames3/ | ||
|
||
------------------------------------------------------------------------------- | ||
Terms & Definitions |badge-beta| | ||
------------------------------------------------------------------------------- | ||
|
||
.. glossary:: | ||
:sorted: | ||
|
||
SCHOOL | ||
The Science Core Heuristics for Open Science Outcomes in Learning | ||
(`SCHOOL`_) is part of the |website-tops| Training initiative, | ||
designed to generate an inclusive culture of open science. | ||
|
||
NASA | ||
National Aeronautics and Space Administration. The United States | ||
government agency responsible for civilian space exploration, | ||
aeronautics research, and scientific discovery related to space. NASA | ||
leads missions to explore space, develop space technology, and enhance | ||
our understanding of Earth and the universe. | ||
|
||
TOPS | ||
|website-tops| initiative which provides the visibility, advocacy, and | ||
community resources to support and enable the shift to open science. | ||
|
||
FAIR | ||
An acronym that stands for **Findable, Accessible, Interoperable, and | ||
Reusable**. These principles guide data management to ensure that | ||
research outputs can be easily shared, discovered, and reused across | ||
different platforms and communities. Learn more `here <https://www. | ||
nature.com/articles/sdata201618>`_ |chevron-right| | ||
|
||
Open Science | ||
An approach to scientific research that promotes :term:`transparency`, | ||
accessibility, and collaboration by sharing data, methods, and results | ||
openly with the broader community. The goal is to make research more | ||
efficient, reproducible, and impactful. | ||
|
||
Open Data | ||
Data that is freely available for anyone to access, use, modify, and | ||
share without restrictions. Open data plays a crucial role in | ||
enhancing :term:`transparency` and collaboration in scientific | ||
research. | ||
|
||
Open Access | ||
A publishing model that makes research articles freely accessible to | ||
the public online, bypassing paywalls and subscription fees. Open | ||
access fosters the dissemination of knowledge and equal access to | ||
scientific findings. | ||
|
||
GitHub | ||
A web-based platform for version control using Git, enabling | ||
collaborative software development. It allows users to host, review, | ||
and manage code repositories, track changes, and collaborate across | ||
distributed teams. | ||
|
||
Version Control System (VCS) | ||
A system that records changes to files over time, allowing teams to | ||
collaborate and track the history of changes in code or documents. Git | ||
is one of the most widely used version control systems in open science. | ||
|
||
ORCID | ||
ORCID (Open Researcher and Contributor ID) is an essential tool for | ||
researchers and contributors in the Open Science community. It helps | ||
establish a unique digital identifier that distinguishes you from | ||
other researchers and ensures that your work is properly attributed. | ||
|
||
Preprint | ||
A version of a research paper that is shared publicly before it has | ||
been peer-reviewed. Preprints allow for faster dissemination of | ||
research and the opportunity for community feedback before formal | ||
publication. | ||
|
||
Reproducibility | ||
The ability to replicate or verify the results of a study using the | ||
same methods and data. Reproducibility is a key aspect of | ||
:term:`open science`, ensuring that research findings are credible and | ||
reliable. | ||
|
||
Data Management Plan (DMP) | ||
A formal document outlining how research data will be collected, | ||
managed, and shared throughout the project lifecycle. DMPs ensure that | ||
data is organized, maintained, and preserved in alignment with | ||
:term:`open science` principles. | ||
|
||
Creative Commons (CC) | ||
A nonprofit organization that provides free legal tools to enable the | ||
sharing and reuse of creative works. Creative Commons licenses are | ||
often used to publish :term:`open access` research, allowing others to | ||
build upon or share the work under specific conditions. | ||
|
||
Open Peer Review | ||
A review process in which the identities of both the authors and | ||
reviewers are made public, and the reviews themselves may be shared. | ||
Open peer review promotes :term:`transparency` and accountability in | ||
the scientific evaluation process. | ||
|
||
Citizen Science | ||
The involvement of non-professional scientists in the collection, | ||
analysis, and dissemination of data for scientific research. Citizen | ||
science engages the public in the scientific process and enhances open | ||
science through crowdsourcing and collaboration. | ||
|
||
Data Sharing | ||
The practice of making data available to others, typically through a | ||
:term:`data repository` or public platforms. Data sharing enhances | ||
collaboration, :term:`transparency`, and the potential for new | ||
discoveries by allowing others to access and use research data. | ||
|
||
Data Repository | ||
A centralized database or archive where datasets are stored and | ||
managed. Repositories ensure data is preserved, accessible, and | ||
discoverable. Examples include Zenodo, Dryad, and the OpenICPSR. | ||
|
||
Open Research | ||
A broad term encompassing practices and principles aimed at increasing | ||
:term:`transparency`, collaboration, and accessibility in research. | ||
Open research includes :term:`open data`, :term:`open access`, | ||
:term:`open methodologies`, and :term:`open peer review`. | ||
|
||
Transparency | ||
The principle of making all aspects of research methods, data, and | ||
findings openly available and understandable. Transparency fosters | ||
trust and :term:`reproducibility` in scientific research. | ||
|
||
Collaborative Research | ||
Research conducted by multiple researchers or teams working together, | ||
often across institutions or disciplines. Collaborative research is a | ||
key aspect of :term:`open science`, facilitating the sharing of | ||
expertise and resources. | ||
|
||
Open Methodologies | ||
The practice of sharing detailed descriptions of research methods and | ||
procedures to allow others to replicate or build upon the research. | ||
Open methodology ensures that research processes are transparent and | ||
reproducible. | ||
|
||
Licensing | ||
The legal framework that dictates how research outputs can be used, | ||
shared, and distributed. :term:`Open Science` often involves using open | ||
licenses, such as :term:`Creative Commons (CC)`, to facilitate the | ||
reuse and dissemination of research. | ||
|
||
Metadata | ||
Data that provides information about other data, such as descriptions, | ||
formats, and source information. Metadata enhances the discoverability | ||
and usability of datasets by providing context and details about the | ||
data's origin and structure. | ||
|
||
Public Access | ||
The principle of making research outputs available to the public | ||
without subscription or paywalls. Public access ensures that research | ||
findings are widely disseminated and accessible to a global audience. | ||
|
||
Open Notebook Science | ||
A practice where researchers make their lab notebooks, including raw | ||
data, experimental details, and ongoing research notes, openly | ||
available. This approach promotes :term:`transparency` and real-time | ||
collaboration. | ||
|
||
Impact Factor | ||
A metric used to measure the influence or importance of a scientific | ||
journal based on citation frequency of its articles. While impact | ||
factor is a common measure of journal quality, open science promotes | ||
alternative metrics and broader measures of impact. | ||
|
||
Altmetrics | ||
Alternative metrics used to measure the impact and reach of research | ||
outputs beyond traditional citation counts. Altmetrics include social | ||
media mentions, downloads, and media coverage, reflecting a broader | ||
range of impact. | ||
|
||
Open Educational Resources (OER) | ||
Teaching and learning materials that are freely accessible and openly | ||
licensed. OER supports open science by providing educational content | ||
that can be freely used, adapted, and shared. | ||
|
||
Ethos of Open Science | ||
The principles and guidelines that govern the responsible conduct of | ||
research, ensuring respect for human and animal subjects, data | ||
privacy, and the integrity of scientific work. Ethical considerations | ||
are central to :term:`open science` practices. | ||
|
||
Open Innovation | ||
A collaborative approach to innovation that involves sharing ideas, | ||
knowledge, and technologies across organizational and disciplinary | ||
boundaries. Open innovation accelerates research and development | ||
through collective problem-solving. | ||
|
||
Scientific Workflow | ||
The process and tools used to conduct and document scientific | ||
research, from data collection to analysis and publication. | ||
:term:`Open Science` encourages transparent and reproducible | ||
workflows, often facilitated by digital tools and platforms. | ||
|
||
Community-Driven Research | ||
Research initiatives led or heavily influenced by the needs and | ||
interests of a particular community or public group. This approach | ||
fosters collaboration between researchers and the public, enhancing | ||
the relevance and impact of research. | ||
|
||
Integrated Development Environment (IDE) | ||
An IDE is a software application that provides comprehensive | ||
facilities to computer programmers for software development. It | ||
typically includes a code editor, a debugger, a build automation tool, | ||
and other tools to facilitate coding and debugging. Examples of | ||
popular IDEs include | ||
`Visual Studio Code <https://code.visualstudio.com/>`_, | ||
`PyCharm <https://www.jetbrains.com/pycharm/>`_, and | ||
`RStudio <https://posit.co/download/rstudio-desktop/>`_. | ||
|
||
Data Processing Tools | ||
Data processing tools are software applications used to collect, | ||
transform, analyze, and visualize data. These tools help researchers | ||
and analysts handle large datasets, perform statistical analysis, and | ||
generate insights. Examples of popular data processing tools are | ||
`Pandas <https://pandas.pydata.org/>`_, | ||
`NumPy <https://numpy.org/>`_, | ||
`MATLAB <https://www.mathworks.com/products/matlab.html>`_, etc. | ||
|
||
Package Managers | ||
Package managers are tools that automate the process of installing, | ||
updating, configuring, and managing software packages and | ||
dependencies. They simplify the management of libraries and tools | ||
needed for development and data analysis. Examples include | ||
`pip <https://pypi.org/project/pip/>`_, | ||
`conda <https://anaconda.org/anaconda/conda>`_, | ||
`npm <https://www.npmjs.com/>`_, | ||
`yarn <https://yarnpkg.com/>`_, | ||
`apt <https://wiki.debian.org/AptCLI>`_, etc. | ||
|
||
Raster | ||
A raster dataset is a type of geographic data in digital image format | ||
with numerical information stored in each pixel. Rasters are often | ||
called grids because of their regularly-shaped matrix data structure. | ||
Rasters can store many types of information and can have dimensions | ||
that include latitude, longitude, and time. NetCDF is one format for | ||
raster data; others include Geotiff, ASCII, and many more. Several | ||
raster formats like NetCDF can store multiple raster layers, or a | ||
"raster stack," which can be useful for storing and analyzing a series | ||
of rasters. |
Oops, something went wrong.