Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Proposal: add a Python GUI pre/post-processing tool for VPSC8

Abierto
  • ¿Algo no está bien?
#3 0 comentarios 1 reacción 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
35/100
Tipo de issue
Nueva funcionalidad
Claridad
Necesita aclaración
Estado de actividad
Tranquilo
Stack tecnológico
python
Área
desktop, documentation

Línea de trabajo

Comienza revisando la estructura propuesta de tools/vpsc_gui/ y la documentación existente del repositorio para determinar si la GUI debe integrarse o solo referenciarse. Comprueba el alcance del README, los ejemplos y requirements.txt propuestos; se considera completado cuando el repositorio tiene un enfoque acordado de integración o documentación para VPSC-GUI.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Summary

We have developed VPSC-GUI, an open-source, Python/Tkinter-based graphical user interface for VPSC8. It is designed to streamline the pre-processing, execution, and post-processing workflow without modifying the original Fortran solver.

This tool has recently been documented and peer-reviewed in SoftwareX:

VPSC-GUI: A Python graphical pre- and post-processing environment for the Visco-Plastic Self-Consistent code
SoftwareX, 2026. (DOI/Version v1.0.1)

We would like to propose integrating/linking this graphical tool into the main repository (e.g., under tools/vpsc_gui/ or referencing it in the documentation) to help new users and students lower the operational barrier to VPSC modeling.

Key Features
  • Structured Pre-Processing:
    • Interactive preview and editing for VPSC8.IN, single-crystal .sx files (FCC, BCC, HCP; Voce hardening and raw text fallback), and process/loading files.
    • Multi-phase aware handling (support for multi-phase .sx, texture files, and phase-resolved output parsing).
  • Boundary Condition Visualizer:
    • Real-time 2D grid/deformation visualization for imposed velocity gradient tensor L and Cauchy stress constraints to catch input errors before launching.
  • Isolated Execution & Traceability:
    • Automated generation of a clean, isolated Fortran-compatible run directory without altering any core Fortran source code.
  • Integrated Post-Processing & Visualization:
    • Direct plotting and high-resolution export for standard VPSC output files, including:
      • STR_STR.OUT (Stress-strain response)
      • ACT_PH*.OUT (Slip/twinning activity)
      • TEX_PH*.OUT (Pole figures and Inverse pole figures using Lambert equal-area projection)
      • LANKFORD.OUT (Lankford coefficients / R-value anisotropy and directional Young's moduli)
      • PCYS.OUT (Polycrystal yield loci)
Proposed Repository Structure

We can contribute this package as a standalone module placed under:

tools/vpsc_gui/
├── vpsc_gui/         # Core Python GUI source code
├── examples/         # Benchmark cases (FCC rolling, HCP compression, BCC/FCC tension)
├── README.md         # Quick start guide and user documentation
└── requirements.txt  # Lightweight dependencies (tkinter, numpy, matplotlib)
Lenguaje dominante
TeX
Estrellas
62
Forks
19
Sin PR fusionados en 30 d

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de lanl/VPSC_code

Todos los issues de lanl/VPSC_code

Issues similares

Más issues de Desktop Dev

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.