Merge pull request #45 from PatriLoto/main

update participants requirements + initial configuration file in spanish and english
ScienceCore · May 20, 2024 · 4d4e58e · 4d4e58e
2 parents 74dab44 + 33b7f24
commit 4d4e58e
Show file tree

Hide file tree

Showing 9 changed files with 126 additions and 20 deletions.
diff --git a/assets/2i2c_login.png b/assets/2i2c_login.png
diff --git a/assets/earthdata_login.png b/assets/earthdata_login.png
diff --git a/assets/earthdata_profile2.png b/assets/earthdata_profile2.png
diff --git a/assets/earthdata_profile_old.png b/assets/earthdata_profile_old.png
diff --git a/assets/start_server.png b/assets/start_server.png
diff --git a/assets/work_environment_jupyter_lab.png b/assets/work_environment_jupyter_lab.png
diff --git a/book/1_ES_Primeros_pasos.md → book/0_Configuracion_inicial.md b/book/1_ES_Primeros_pasos.md → book/0_Configuracion_inicial.md
@@ -1,25 +1,64 @@
-# Primeros pasos
+# Configuración Inicial
 
-## ¿Cómo utilizar el hub de 2i2c?
+## 1-¿Cómo utilizar el hub de 2i2c?
 
 Para acceder al 2i2c Hub seguí estos sencillos pasos:
 * Accede al [Hub de 2i2c](https://showcase.2i2c.cloud/hub/login)
-* Introduce tus credenciales: Ingresa tu nombre de usuario y contraseña del 2i2c Hub
+  
 
-## ¿Cómo acceder a los datos disponibles en el sitio Earthdata de la NASA?
+
+![2i2c_login](../assets/2i2c_login.png)
+
+
+
+* Introducí tus credenciales: Ingresa tu nombre de usuario y contraseña (Nota: Para esto deberías haber enviado tu correo asociado a tu cuenta de Github para que se te habilite el acceso con dicha cuenta). 
+
+* Si el acceso es correcto, verás la pantalla que se muestra a continuación. Por último elegí la opción Start para ingresar al ambiente de Jupyter lab en la nube.
+
+
+![start_server](../assets/start_server.png)
+
+
+
+* Listo, ya estás listo para empezar a trabajar. 
+
+
+
+
+![ambiente_trabajo_jupyter_lab](../assets/work_environment_jupyter_lab.png) 
+
+
+
+## 2- ¿Cómo utilizar el Earthdata de la NASA?
+
+
+#### Breve introducción
 
 El programa **Earth Science Data Systems (ESDS)**, **Programa de Sistemas de Datos de Ciencias de la Tierra** de la NASA, supervisa el ciclo de vida de los datos científicos de la Tierra de todas sus misiones de observación de la Tierra, desde su adquisición hasta su procesamiento y distribución.
 
 A los efectos de esta guía, el sitio web Earthdata de la NASA es el punto de entrada que permite acceder de manera completa, gratuita y abierta a las colecciones de datos de ciencias de la Tierra de la NASA, con el fin de acelerar el avance científico en beneficio de la sociedad. Para acceder a los datos a través de este portal, los usuarios deben definir primero sus credenciales de acceso.
 
- Para crear una cuenta en EarthData, seguí este sencillo [tutorial], el cual te guíara paso a paso. Como sugerencia, elige un *nombre de usuario* y *contraseña* que recuerdes bien, ya que los necesitarás más adelante.
-Ahora viene la parte técnica: para acceder a los datos desde programas de Python y Jupyter notebooks, es necesario guardar las credenciales (de EarthData) en un archivo especial.  En este repositorio encontrarás un archivo llamado `.netrc` con un ejemplo (puedes pensar en él como una plantilla). Abre ese archivo y edita la siguiente línea:
+ Para crear una cuenta en EarthData, seguí los pasos que se indica:
+
+ * Ingresa al sitio de Earth Nasa: https://www.earthdata.nasa.gov/. Luego selecciona la opción "Use Data" y a continuación "Register". Por último, ingresa a https://urs.earthdata.nasa.gov/.
+
 
-`machine urs.earthdata.nasa.gov login {tu_nombre_de_usuario} password {tu_contraseña}`
+![earthdata_login](../assets/earthdata_login.png) 
 
-Luego, reemplaza `{tu_nombre_de_usuario`} y `{tu_contraseña}` con los datos de tu cuenta. Guarda el archivo y ¡listo!  Ya tienes todo lo necesario para acceder a los datos de observación de la Tierra a través del portal de EarthData. ️
-Para asegurarte de que todo funciona correctamente, abre la notebook titulada 1`_primeros_pasos.ipynb `y sigue las indicaciones.  ¡Con esto ya podrás explorar el mundo de los datos de la NASA!
 
+ * Selecciona la opción "Register for a profile", allí elige un *nombre de usuario* y *contraseña*.  Como sugerencia, elige aquellos que recuerdes bien, ya que los necesitarás más adelante. También deberás cargar tu perfil para compeltar el registro, en el mismo se te pedirán datos como correo, país, afiliación, entre otros. Al final, elige "Register for Earthdata Login".
+
+
+![earthdata_profile](../assets/earthdata_profile2.png) 
 
+
+
+
+## 3- Configuración de datos para acceder desde Jupyter notebooks
+
+Ahora viene la parte técnica: para acceder a los datos desde programas de Python y Jupyter notebooks, es necesario guardar las credenciales (de EarthData) en un archivo especial.  En este repositorio encontrarás un archivo llamado `.netrc` con un ejemplo (puedes pensar en él como una plantilla). Abre ese archivo y edita la siguiente línea:
 
+`machine urs.earthdata.nasa.gov login {tu_nombre_de_usuario} password {tu_contraseña}`
 
+Luego, reemplaza `{tu_nombre_de_usuario`} y `{tu_contraseña}` con los datos de tu cuenta. Guarda el archivo y ¡listo!  Ya tienes todo lo necesario para acceder a los datos de observación de la Tierra a través del portal de EarthData. ️
+Para asegurarte de que todo funciona correctamente, abre la notebook titulada 1`_primeros_pasos.ipynb `y sigue las indicaciones.  ¡Con esto ya podrás explorar el mundo de los datos de la NASA!
diff --git a/book/0_Initial_Setup.md b/book/0_Initial_Setup.md
@@ -0,0 +1,61 @@
+# Initial Setup 
+
+## 1- How to use the 2i2c Hub
+
+To access the 2i2c Hub, follow these simple steps:
+
+* Access the 2i2c Hub: Go to https://2i2c.org/platform/}
+
+# Initial Configuration Steps for 2i2c Hub and EarthData NASA Access
+
+## 1. Accessing the 2i2c Hub
+
+To access the 2i2c Hub, follow these simple steps:
+
+* Go to the 2i2c Hub.
+
+![2i2c_login](../assets/2i2c_login.png)
+
+* Enter your credentials: username and password (Note: You must have previously sent your Github account username to be enabled for access with that account).
+
+* If the login is successful, you will see the following screen. Choose the Start option to enter the JupyterLab environment in the cloud.
+
+
+![2i2c_login](../assets/start_server.png)
+
+* Finally, if you see the following JupyterLab screen, you are ready to start working.
+
+![ambiente_trabajo_jupyter_lab](../assets/work_environment_jupyter_lab.png) 
+
+## 2. Using NASA's Earthdata
+
+### Brief Introduction
+
+The NASA Earth Science Data Systems (ESDS) program oversees the lifecycle of Earth science data from all its Earth observation missions, from acquisition to processing and distribution.
+
+For the purposes of this guide, the NASA Earthdata website is the entry point that allows full, free and open access to NASA's Earth science data collections, in order to accelerate scientific progress for the benefit of society. To access the data through this portal, users must first define their access credentials. To create an EarthData account, follow these steps:
+
+Go to the Earth Nasa website: https://www.earthdata.nasa.gov/. Then, select the option "Use Data" and then "Register". Finally, go to https://urs.earthdata.nasa.gov/.
+
+![earthdata_login](../assets/earthdata_login.png) 
+
+Select the "Register for a profile" option, there choose a username and password. As a suggestion, choose ones that you remember well, as you will need them later. You will also need to complete your profile to complete the registration, where you will be asked for information such as email, country, affiliation, among others. Finally, choose "Register for Earthdata Login".
+
+![earthdata_profile](../assets/earthdata_profile2.png) 
+
+## 3. Data Configuration for Access from Jupyter Notebooks
+
+
+Now comes the technical part: to access data from Python programs and Jupyter notebooks, it is necessary to save the credentials (from EarthData) in a special file. In this repository you will find a file called .netrc with an example (you can think of it as a template). Open that file and edit the following line:
+```
+
+machine urs.earthdata.nasa.gov login {your_username} password {your_password}
+```
+
+Then, replace `{your_username}` and `{your_password} `with your account details. Save the file and you're done! You now have everything you need to access Earth observation data through the EarthData portal. ️
+
+To make sure everything is working properly, open the notebook titled `1_getting_started.ipynb` and follow the instructions. With this, you will be able to explore the world of NASA data!
+
+
+
+
diff --git a/book/about_the_tutorial/Requirements.md b/book/about_the_tutorial/Requirements.md
@@ -4,27 +4,33 @@
 The following are the requirements needed for the course:
 
 
-### Desirable:
+### Required:
 
-- Have completed the NASA Open Science 101 course.
+- **A free NASA EarthData user account.**
 
-- Have basic programming knowledge.
+  - To access the data used in this course, you will need a free NASA EarthData user account. You can create an account on the NASA EarthData website ([https://urs.earthdata.nasa.gov/ ](https://urs.earthdata.nasa.gov/)).
 
+* **A free user account on GitHub.**
 
-### Required:
+     - To download the course source code, you will need a free user account on GitHub. You can create an account on the GitHub website (<https://github.com/>).
 
-- A free NASA EarthData user account:
+- **A 2i2c hub user account.**
 
-  - To access the data used in this course, you will need a free NASA EarthData user account. You can create an account on the NASA EarthData website ([https://urs.earthdata.nasa.gov/ ](https://urs.earthdata.nasa.gov/)).
+  - To run the course notebooks, you will need a free 2i2c hub account. You can create an account on the 2i2c website (Link).
 
-* A free user account on GitHub:
+* **Fundamentals of Spatial Data.** 
+This course assumes a basic understanding of how geographic information is represented digitally. This includes concepts like points, lines, and areas used to represent locations on Earth.  You also should have knowledge about geospatial concepts such as coordinate systems and geographic data formats.
 
-  - To download the course source code, you will need a free user account on GitHub. You can create an account on the GitHub website (<https://github.com/>).
+* **Basic Python programming knowledge with focus in data analysis.**
+Since the course involves data manipulation and the use of code for spatial analysis, some experience with Python programming is required, particularly for data analysis. The course utilizes specialized Python libraries for working with spatial data. While not mandatory, familiarity with libraries like pandas (data analysis), geopandas (geographic data), or rasterio (reading/writing raster data) can be helpful.
 
-- A 2i2c hub user account:
 
-  - To run the course notebooks, you will need a free 2i2c hub account. You can create an account on the 2i2c website (Link).
+### Desirable:
+
+- Taking the NASA Open Science 101 course.
+
+### Additional Considerations for the Course.
 
-* Fundamentals of spatial data.
+While not required, completing NASA Open Science 101 can give you a strong foundation in open science principles and practices that will help you in this course.