Si eres ingeniero o estudiante y deseas comenzar a realizar análisis estructurales avanzados con OpenSeesPy utilizando un cuaderno organizado de calculo en Jupyter Notebook, pero te preocupa la instalación y configuración del software, esta guía está diseñada para ti. 

En este tutorial, aprenderás a instalar OpenSeesPy de manera sencilla en una computadora con Windows, utilizando únicamente Visual Studio Code, sin necesidad de lidiar con complicadas configuraciones en CMD. Con un enfoque paso a paso y explicaciones claras, en pocos minutos tendrás listo tu entorno de trabajo para ejecutar simulaciones estructurales y usar Jupyter Notebook dentro de VS Code. ¡Vamos a comenzar!


Antes de empezar

Este tutorial te guiará paso a paso para instalar OpenSeesPy y Jupyter Notebook dentro de Visual Studio Code.

✅ No necesitas conocimientos avanzados en programación.

⏳ Tiempo estimado: 15-30 minutos.

⚙️ ¿Qué instalarás? Python, OpenSeesPy, Jupyter y extensiones de VS Code.

📌 Tabla de contenido


🔹 Paso 1: Instalar Visual Studio Code

¿Por qué? VS Code es un editor de código ligero y potente que facilita la escritura y depuración de Python.

Instrucciones:



  • Ejecuta el instalador y marca todas las opciones antes de instalar incluyendo:
    • ✅ "Add VS Code to PATH" o "Agregar a PATH"(para que sea accesible desde la terminal) 
Captura de la instalación de extensiones en VS Code.

Espera a que termine la instalación, reinicia tu pc y abre VS Code.


🔹 Paso 2: Instalar Python desde VS Code

¿Por qué? Python es el lenguaje que OpenSeesPy necesita para funcionar.

Instrucciones:

  • Abre VS Code.
  • Si aún no tienes Python instalado, VS Code mostrará un aviso para instalarlo.
  • Haz clic en "Install Python" y sigue las instrucciones.
  • Para verificar la instalación, abre la terminal en VS Code (Ctrl + ñ) y escribe:
python --version

Si ves algo como Python 3.X.X, ya está instalado.

🔹 ¿Qué hacer si VS Code no muestra el aviso para instalar Python?

Si Visual Studio Code no te muestra el aviso para instalar Python, puedes hacerlo manualmente siguiendo estos pasos:

✅ Instalar Python manualmente
  • Descarga Python desde la página oficial ES MUY IMPORTANTE que busques en la lista la versión 3.12.1, (a fecha de hoy la versión más reciente de Python no me funcionó para ejecutar Openseespy):
  • Instalar Python en Visual Studio Code

    Descargar Python



  • Una vez seleccionada la versión Busca la sección que dice "Files" y Haz Click en el nombre para descargar automáticamente el instalador según tu Windows tal como te muestro en la imagen:


  • Busca el archivo descargado en tu pc, ejecuta el instalador y marca la casilla "Add Python to PATH" antes de hacer clic en "Install Now".


  • Una vez instalado, cierra y vuelve a abrir VS Code.
  • Abre la terminal en VS Code (Ctrl + ñ) y escribe:
python --version

✔ Si aparece algo como Python 3.X.X, ¡ya está instalado correctamente! ✅



🔹 Paso 3: Instalar las extensiones necesarias en VS Code

¿Por qué? Las extensiones permiten ejecutar código Python y notebooks en VS Code.

  • Abre la pestaña de extensiones (Ctrl + Shift + X).
  • Busca e instala estas extensiones:
    • 🔹 Python (desarrollada por Microsoft). Las siguientes 2 extensiones deberían instalarse automáticamente con la primera.
    • 🔹 Python Debugger (desarrollada por Microsoft).
    • 🔹 Pylance (desarrollada por Microsoft).
    • 🔹 Jupyter (para ejecutar notebooks en VS Code).
  • Reinicia VS Code para aplicar los cambios.


Extensiones a Instalar para usar Openseespy en Visual Studio Code




🔹 Paso 4: Instalar OpenSeesPy y Jupyter Notebook

Si la cerraste abre de nuevo la terminal en VS Code (Ctrl + ñ) y escribe:

pip install openseespy jupyter matplotlib numpy pandas pyvista

📌 Este comando instalará:

  • openseespy → Para análisis estructural.
  • jupyter → Para ejecutar notebooks dentro de VS Code.
  • matplotlib → Para gráficos de resultados.
  • numpy, pandas → Para manejar datos estructurales.
  • pyvista → Para visualización 3D.

🎯 ¡Perfecto! Ahora OpenSeesPy y Jupyter Notebook están listos para usarse en VS Code. 🚀


🔹 Paso 5: Probar que OpenSeesPy funciona en VS Code

¿Por qué? Este paso te permitirá verificar que OpenSeesPy está instalado correctamente y listo para ser usado en tu computadora.

✅ Crear un archivo nuevo en VS Code

Para ejecutar OpenSeesPy, primero debes crear un archivo de Python en Visual Studio Code. Sigue estos pasos:

  • Abre Visual Studio Code.
  • Haz clic en "File" → "New File" o presiona Ctrl + N para crear un nuevo archivo.
  • Guárdalo presionando Ctrl + S.
  • En el cuadro de guardado, escribe el nombre test.py y selecciona una carpeta fácil de encontrar, como "Documentos" o el escritorio.

Cómo crear un archivo Jupyter Notebook en VS Code
Ejemplo de cómo crear y guardar un archivo de Python en Visual Studio Code.

✅ Escribir el código de prueba en test.py

Una vez que hayas creado y guardado el archivo, escribe este código dentro de test.py:

import openseespy.opensees as ops
ops.wipe()
print("¡OpenSeesPy funciona en VS Code!")

✅ Ejecutar el archivo en VS Code

Ahora que tienes el archivo creado, puedes ejecutarlo de dos formas:

📌 Método 1: Ejecutar con F5
  • Asegúrate de que el archivo test.py está abierto en VS Code.
  • Presiona F5 para ejecutar el código.
  • Si es la primera vez que usas F5, VS Code te pedirá seleccionar un "debugger". Elige Python.
  • Verás el resultado en la terminal integrada de VS Code.

📌 Método 2: Ejecutar desde la terminal
  • Abre la terminal en VS Code con Ctrl + ñ.
  • Si guardaste test.py en "Documentos", navega a la carpeta con:
cd C:\Users\TuUsuario\Documents
  • Ejecuta el archivo escribiendo:
python test.py

✅ Resultado esperado

Si todo está correctamente instalado, verás el siguiente mensaje en la terminal:

¡OpenSeesPy funciona en VS Code!

🎯 ¡Felicidades!Ahora tienes OpenSeesPy funcionando en Visual Studio Code. 🚀

🔹 Paso 6: Probar Jupyter Notebook dentro de VS Code

¿Por qué? En este paso verificaremos que Jupyter Notebook está correctamente instalado y puede ejecutar OpenSeesPy dentro de Visual Studio Code.

✅ Crear un nuevo archivo en Jupyter Notebook

Para probar Jupyter Notebook en VS Code, sigue estos pasos:

  • Abre Visual Studio Code.
  • En la barra lateral izquierda, haz clic en "Explorer" (Ícono de carpeta).
  • Haz clic en "New File" (Ícono de hoja con +).
  • Escribe el nombre del archivo: test.ipynb y presiona "Enter".
  • Se abrirá automáticamente en el entorno de Jupyter dentro de VS Code.
Cómo crear un archivo Jupyter Notebook en VS Code
Ejemplo de cómo crear y abrir un archivo Jupyter Notebook en Visual Studio Code.

✅ Escribir el código de prueba en Jupyter Notebook

Una vez que el archivo test.ipynb esté abierto, copia y pega el siguiente código en una celda de código:

import openseespy.opensees as ops
ops.wipe()
print("¡OpenSeesPy funciona en Jupyter dentro de VS Code!")

✅ Ejecutar la celda en Jupyter Notebook

  • Haz clic en la celda de código donde pegaste el código.
  • Presiona Shift + Enter para ejecutar la celda.

✅ Resultado esperado

Si todo está correctamente instalado, en la salida de la celda verás:

¡OpenSeesPy funciona en Jupyter dentro de VS Code!

🎯 ¡Listo! OpenSeesPy está funcionando dentro de Jupyter Notebook en VS Code. Ahora puedes comenzar a usarlo para análisis estructurales. 🚀

Prueba de Jupyter Notebook y Openseespy en archivo de Jupyter Nodebook en VS Code




🔧 Solución de problemas

❌ Error: "Python no se reconoce como un comando interno"

Esto ocurre si Python no está agregado al PATH. Para solucionarlo:

1️⃣ Reinstala Python y asegúrate de marcar la opción "Add Python to PATH" durante la instalación.

2️⃣ Reinicia tu computadora e intenta de nuevo ejecutando:

python --version

❌ Error: OpenSeesPy no funciona en Jupyter Notebook

Si OpenSeesPy no se encuentra en Jupyter, significa que el kernel no lo reconoce. Intenta reinstalarlo con:

python -m ipykernel install --user

Luego, cierra Jupyter Notebook y vuelve a abrirlo. Si el problema persiste, revisa que OpenSeesPy esté correctamente instalado con:

pip show openseespy

❌ Error: "ModuleNotFoundError: No module named 'openseespy'"

Esto ocurre si OpenSeesPy no está instalado en el mismo entorno que Jupyter. Solución:

1️⃣ Abre la terminal en VS Code (Ctrl + ~).

2️⃣ Instala OpenSeesPy nuevamente con:

pip install openseespy

3️⃣ Si el error persiste, intenta cambiar el kernel en Jupyter Notebook seleccionando la versión correcta de Python.

❌ Error: "Kernel not found" o "No kernel available"

Esto ocurre si VS Code no encuentra un intérprete de Python adecuado para Jupyter Notebook. Para solucionarlo:

  • Haz clic en la parte superior del notebook donde dice "Select Kernel".
  • Elige la versión de Python donde instalaste OpenSeesPy.

Si el problema persiste, instala el kernel de Jupyter ejecutando:

python -m ipykernel install --user

🎯 ¿Qué sigue después de instalar OpenSeesPy?

Ahora que has instalado OpenSeesPy, puedes probar un primer modelo estructural.