Skip to content

Commit 4d4e58e

Browse files
authored
Merge pull request #45 from PatriLoto/main
update participants requirements + initial configuration file in spanish and english
2 parents 74dab44 + 33b7f24 commit 4d4e58e

9 files changed

+126
-20
lines changed

assets/2i2c_login.png

35.9 KB
Loading

assets/earthdata_login.png

63.7 KB
Loading

assets/earthdata_profile2.png

83.6 KB
Loading

assets/earthdata_profile_old.png

36.2 KB
Loading

assets/start_server.png

11.4 KB
Loading
34.6 KB
Loading
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,64 @@
1-
# Primeros pasos
1+
# Configuración Inicial
22

3-
## ¿Cómo utilizar el hub de 2i2c?
3+
## 1-¿Cómo utilizar el hub de 2i2c?
44

55
Para acceder al 2i2c Hub seguí estos sencillos pasos:
66
* Accede al [Hub de 2i2c](https://showcase.2i2c.cloud/hub/#)
7-
* Introduce tus credenciales: Ingresa tu nombre de usuario y contraseña del 2i2c Hub
7+
88

9-
## ¿Cómo acceder a los datos disponibles en el sitio Earthdata de la NASA?
9+
10+
![2i2c_login](../assets/2i2c_login.png)
11+
12+
13+
14+
* 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).
15+
16+
* 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.
17+
18+
19+
![start_server](../assets/start_server.png)
20+
21+
22+
23+
* Listo, ya estás listo para empezar a trabajar.
24+
25+
26+
27+
28+
![ambiente_trabajo_jupyter_lab](../assets/work_environment_jupyter_lab.png)
29+
30+
31+
32+
## 2- ¿Cómo utilizar el Earthdata de la NASA?
33+
34+
35+
#### Breve introducción
1036

1137
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.
1238

1339
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.
1440

15-
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.
16-
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:
41+
Para crear una cuenta en EarthData, seguí los pasos que se indica:
42+
43+
* 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/.
44+
1745

18-
`machine urs.earthdata.nasa.gov login {tu_nombre_de_usuario} password {tu_contraseña}`
46+
![earthdata_login](../assets/earthdata_login.png)
1947

20-
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. ️
21-
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!
2248

49+
* 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".
50+
51+
52+
![earthdata_profile](../assets/earthdata_profile2.png)
2353

54+
55+
56+
57+
## 3- Configuración de datos para acceder desde Jupyter notebooks
58+
59+
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:
2460

61+
`machine urs.earthdata.nasa.gov login {tu_nombre_de_usuario} password {tu_contraseña}`
2562

63+
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. ️
64+
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!

book/0_Initial_Setup.md

+61
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
# Initial Setup
2+
3+
## 1- How to use the 2i2c Hub
4+
5+
To access the 2i2c Hub, follow these simple steps:
6+
7+
* Access the 2i2c Hub: Go to https://2i2c.org/platform/}
8+
9+
# Initial Configuration Steps for 2i2c Hub and EarthData NASA Access
10+
11+
## 1. Accessing the 2i2c Hub
12+
13+
To access the 2i2c Hub, follow these simple steps:
14+
15+
* Go to the 2i2c Hub.
16+
17+
![2i2c_login](../assets/2i2c_login.png)
18+
19+
* Enter your credentials: username and password (Note: You must have previously sent your Github account username to be enabled for access with that account).
20+
21+
* If the login is successful, you will see the following screen. Choose the Start option to enter the JupyterLab environment in the cloud.
22+
23+
24+
![2i2c_login](../assets/start_server.png)
25+
26+
* Finally, if you see the following JupyterLab screen, you are ready to start working.
27+
28+
![ambiente_trabajo_jupyter_lab](../assets/work_environment_jupyter_lab.png)
29+
30+
## 2. Using NASA's Earthdata
31+
32+
### Brief Introduction
33+
34+
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.
35+
36+
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:
37+
38+
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/.
39+
40+
![earthdata_login](../assets/earthdata_login.png)
41+
42+
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".
43+
44+
![earthdata_profile](../assets/earthdata_profile2.png)
45+
46+
## 3. Data Configuration for Access from Jupyter Notebooks
47+
48+
49+
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:
50+
```
51+
52+
machine urs.earthdata.nasa.gov login {your_username} password {your_password}
53+
```
54+
55+
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. ️
56+
57+
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!
58+
59+
60+
61+

book/about_the_tutorial/Requirements.md

+17-11
Original file line numberDiff line numberDiff line change
@@ -4,27 +4,33 @@
44
The following are the requirements needed for the course:
55

66

7-
### Desirable:
7+
### Required:
88

9-
- Have completed the NASA Open Science 101 course.
9+
- **A free NASA EarthData user account.**
1010

11-
- Have basic programming knowledge.
11+
- 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/)).
1212

13+
* **A free user account on GitHub.**
1314

14-
### Required:
15+
- 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/>).
1516

16-
- A free NASA EarthData user account:
17+
- **A 2i2c hub user account.**
1718

18-
- 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/)).
19+
- To run the course notebooks, you will need a free 2i2c hub account. You can create an account on the 2i2c website (Link).
1920

20-
* A free user account on GitHub:
21+
* **Fundamentals of Spatial Data.**
22+
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.
2123

22-
- 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/>).
24+
* **Basic Python programming knowledge with focus in data analysis.**
25+
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.
2326

24-
- A 2i2c hub user account:
2527

26-
- To run the course notebooks, you will need a free 2i2c hub account. You can create an account on the 2i2c website (Link).
28+
### Desirable:
29+
30+
- Taking the NASA Open Science 101 course.
31+
32+
### Additional Considerations for the Course.
2733

28-
* Fundamentals of spatial data.
34+
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.
2935

3036

0 commit comments

Comments
 (0)