Instal·lar Fortran i Gnuplot per Windows + Visual Studio Code

PART 1: Instal·lació de Software

1) Instal·lar Fortran i Gnuplot

2) Provar de compilar des d’un bloc de notes

1. Assegura’t que pots veure les extensions dels fitxers (En l’explorador d’arxius cliques “Visualització”, “Mostra”, “Extensions del nom del fitxer”)

2. Crea-hi un arxiu anomenat “prova.f90”, per a fer-ho fas:
{botó dret} → Nuevo → Documento de texto (arxiu .txt) → li poses de nom “prova.f90"
→ al haver canviat l’extensió de .txt a f.90 et dirà Seguro? li dius Sí
→ entres al arxiu (Abrir con → Más aplicaciones → Libreta o Bloc de notas (de moment))
→ copies i enganxes el codi que tens aquí sota → Guardes l’arxiu

program helloWorld
implicit none

print *, 'Hello World!'

end program

3. Obres la Terminal o cmd o Símbolo de Sistema o PowerShell (buscant pel nom a baix al buscador de Windows o per exemple fent Win+R i escrivint ‘cmd’).

4. Et mous mitjançant els comandaments “cd [carpeta]”, “cd..” i “dir” fins a la carpeta on tens el teu programa.

5. Compiles des de la terminal fent:

gfortran prova.f90 -o prova.exe

6. S’hauria d’haver creat un fitxer “prova.exe”, executa’l fent:

.\prova.exe

Alternativament ves a la carpeta i executa’l manualment (clicant-lo dos cops).

7. Si llegeixes un Hello World! a la terminal felicitats, has instal·lat bé el fortran i ja saps compilar i executar des de la terminal.

3) Provar de generar un gràfic (plot) amb gnuplot

1. Crea un fitxer i anomena’l “dades.dat” i enganxa-hi les següents dades:

1 1
2 4
3 9
4 16
5 25
6 36
7 49
8 64
9 81

2. Crea un fitxer anomena’t “fig1.gnu” i enganxa-hi el següent codi:

file = 'dades.dat'
set term png
set out 'fig1.png'
plot file

3. Des de la terminal, genera el gràfic fent:

gnuplot fig1.gnu

4. A la carpeta se’t hauria d’haver generat un fitxer “fig1.png”, obre la imatge i mira si és similar a aquesta:

5. Si se’t ha generat la imatge i és com aquesta, ja està, felicitats! Tot et funciona correctament, ja pots procedir a tancar la terminal, els fitxer oberts i descansar una estoneta.
Si no se’t ha generat, comprova que no et surti un missatge de Seguretat de Windows (o del teu antivirus) bloquejant l’accés, si és així hauràs d’afegir una excepció:
Seguretat de Windows —> Historial de Protecció —> Clicar una notificació de “l’accés a les carpetes protegides s’ha bloquejat” —> Segur? Sí —> Configuració d’accés a carpetes controlat —> Permet una aplicació amb l’accés controlat a les carpetes —> Segur? Sí —> Afegeix una aplicació permesa —> Aplicacions bloquejades recentment —> Seleccionar “gnuplot.exe” —> ja pots tancar-ho tot i tornar a provar.

PART 2: Fer-ho més fancy i còmode

Aquesta part és opcional.

1) Instal·lar Visual Studio Code

2) Instal·lar extensions Modern Fortran, gnuplpot, Material Icon Theme, vscode-pdf i Task Runner

1. De la barra lateral esquerra de l’editor clicar el símbol d’Extensions (o sinó fer Ctrl+Shift+x), buscar “Modern Fortran” i instal·lar-la.
Podeu comprovar que funciona el highlighting (colorets) creant un arxiu .f90 i escrivint el codi bàsic que hem vist abans (prova.f90).

2. Buscar l’extensió “gnuplot” feta per “mammothb” i instal·lar-la, comprovar en un arxiu .gnu (per exemple fig1.gnu) que et fa el highlighting.

3. Afegir ara l’extensió “Material Icon Theme” feta per “Philipp Kief”, després clicar el botó blau de l’extensió que posa ‘Set Material Icon Theme’ i comprovar que els arixus fortran i d’altres adquireixen un icona particular.
Nota: segons com potser us agrada més el look de l’extensió “vscode-icons” feta per “VSCode Icon Team”, és una qüestió de gustos.

4. Afegir l’extensió “vscode-pdf” by tomoki1207 per tal de previsualitzar pdfs des del propi VScode (útil per tenir allà mateix els els guions de les prepras i pràctiques d’anys anteriors).

5. Afegir l’extensió “Task Runner” by Sana Ajani. (Ens servirà per l’apartat 4).

3) Primer exemple

gfortran programa.f90 -o exes/programa.exe

.\exes\programa.exe

file = 'data/dades.dat'
set term png
set out 'out/grafic.png'
plot file

4) Automatització (executar el codi clicant un botó)

1. Aconseguir trobar/generar el fitxer tasks.json
1. Clicar al buscador a dalt al centre (o Ctrl+Shift+P) i escriure >Tasks.
2. Clicar del desplegable l’opció “Tasks: Configure Default Build Task”.
3. Seleccionar “Create tasks.json file from template”.
4. Seleccionar “Other” —> Se’t hauria d’obrir un fitxer tasks.json.
5. A l’esquerra de l’editor, hi ha d’haver una carpeta “.vscode” i a dins el fitxer “tasks.json”. Borra tot el que contingui.
Alternativament simplement crea tu manualment una carpeta anomenada “.vscode” i a dins un fitxer anomenat “tasks.json”.

2. Enganxa-hi el següent codi:

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Build & Run Fortran",
            "type": "shell",
            "command": "${fileDirname}\\exes\\${fileBasenameNoExtension}.exe",
            "options": {
                "cwd": "${fileDirname}"
            },
            "dependsOn": [
                "Build Fortran"
            ]
        },{
            "label": "Build Fortran",
            "type": "shell",
            "command": "gfortran",
            "options": {
                "cwd": "${fileDirname}"
            },
            "args": [
                "${fileDirname}\\${fileBasename}",
                "-o",
                "${fileDirname}\\exes\\${fileBasenameNoExtension}.exe"
            ]
        },{
            "label": "Run Gnuplot",
            "type": "shell",
            "command": "gnuplot",
            "options": {
                "cwd": "${fileDirname}"
            },
            "args": [
                "${fileDirname}\\${fileBasename}"
            ]
        },
        {
            "label": "Create Folders",
            "type": "shell",
            "command": "if(!(Test-Path ${fileDirname}\\exes)) {md 'exes', 'data', 'out'}",
            "options": {
                "cwd": "${fileDirname}"
            },
            "group": "build"
        }
    ]
}

Això serien 4 tasques, una et compila i prou, l’altre et compila i executa, l’altre et genera un gràfic i l’altre et genera les 3 carpetes “exes”, “data” i “out”.

3. Guarda el fitxer (Ctrl+S) i tanca i torna a obrir el VS Code.

5) Opcional: Afegir dreceres de teclat

1. File>Preferences>Keyboard Shortcuts.

2. Clica el següent a dalt a la dreta:

3. S’hauria de mostrar un fitxer JSON (keybindings.json), borra el que hi hagi i enganxa-hi el següent codi:

[ // Si vols també pots modificar aquestes dreceres canviant la 'key'.
  {
    "key": "F5",
    "command": "workbench.action.tasks.runTask",
    "when": "resourceExtname == .f90 || resourceExtname == .f || resourceExtname == .f95",
    "args": "Build & Run Fortran"
  },
  {
    "key": "F5",
    "command": "workbench.action.tasks.runTask",
    "when": "resourceExtname == .gnu",
    "args": "Run Gnuplot"
  },
  {
    "key": "Ctrl+F5",
    "command": "workbench.action.tasks.runTask",
    "when": "resourceExtname == .f90 || resourceExtname == .f || resourceExtname == .f95 || resourceExtname == .gnu",
    "args": "Create Folders"
  },
]

Això el que fa és sobreescriure les dreceres de teclat, permetent executar o generar plot amb F5 i crear carpetes amb Ctrl + F5
Nota: si voleu podeu canviar les dreceres de teclat editant l’argument “key” (per exemple també podeu utilitzar Ctrl+Shift+B i Ctrl+Alt+B).
La part bona és que només s’executarà si es troba en un fitxer fortran o .gnu (a diferència dels botons del ‘Task Runner’), i que si les carpetes ja les has creat no les intentarà crear de nou.
Nota: en alguns teclats haureu de fer Fn+F5 i Ctrl+Fn+F5 per activar la drecera, en d’altres simplement F5 i Ctrl+F5.

4. Guarda el fitxer (Ctrl+S) i ja estaria.

6) Extra: canviar els colors d’icones i carpetes

Aquest últim apartat és totalment opcional.

1. Anem a l’extensió i obrim la seva configuració (Settings).

2. Ens fixem en l’opció ‘Custom Clones’ i cliquem ‘Edit in settings.json’. Se’ns obrira un fitxer json que conté els ajustaments de l’usuari (la personalització gràfica del nostre vscode).



Nota: En aquest fitxer hi ha la personalització del VS Code de cada usuari. A continuació esborrarem el codi que sigui que hi hagi, però si per exemple ja hi tinguéssiu personalitzacions d’altres coses que heu fet servir abans no les esborreu, intenteu entendre com funciona un fitxer JSON i afegiu-les al final d’aquest.

3. Borra el codi que hi hagi i enganxa-hi el següent

{
    "workbench.iconTheme": "material-icon-theme",
    "material-icon-theme.folders.customClones": [
    {
        "name": "dades-carpeta",
        "base": "folder-content", // opció alternativa: "folder-database"
        "color": "#009688", // Blau per 'data'
        "folderNames": ["data"]
    },
    {
        "name": "exes-carpeta",
        "base": "folder-config", // opció alternativa: "folder-command"
        "color": "#360900", // Vermell fosc per 'exes'
        "folderNames": ["exes"]
    },
    {
        "name": "out-carpeta",
        "base": "folder-environment", // opció alternativa: "folder-images"
        "color": "#2bb302", // Verd per 'out'
        "folderNames": ["out"]
    }
    ],
    "material-icon-theme.files.customClones": [
    {
        "name": "imatge-png",
        "base": "image",
        "color": "#42ab22", // Verd per les imatges
        "fileExtensions": ["png","jpg","jpeg","plt","gif","ico"]
    }
    // ,{ // JA S'HA AFEGIT L'ICONA DE GNUPLOT :)
    //     "name": "fitxer-gnuplot",
    //     "base": "gleam", // Altres opcions: 'fastlane', 'deepsource', 'sas', 'graphql',
    //     // 'cmake', 'matlab', 'svg', 'julia', 'nuxt', 'gleam', 'prisma', 'proto'
    //     "color": "#b00cc2", // Rosa-púrpura
    //     "fileExtensions": ["gnu"]
    // }
    ],
    "material-icon-theme.folders.color": "#e0c810" // Groc (Color carpeta normal)
}

4. Guarda el fitxer (Ctrl+S) i ja estaria, hauries de veure els canvis d’icona.

7) Ja podem programar eficientment

• Ctrl+F5 o ‘Create Folders’ i immediatament ja tens les 3 carpetes creades.

• Estàs escrivint el codi fortran i vols provar si funciona, prems F5 o ‘Run & Build Fortran’ i immediatament s’executa el codi.

• El mateix amb gnuplot, prems F5 o ‘Run Gnuplot’ i immediatament set genera el gràfic (a partir de les dades) dins la carpeta ‘out’.

program escriureEnUnFitxer
    implicit none
    integer :: x
    real :: x_radians
    open(unit=10, file="data/dades.dat") ! Recordem no deixar-nos el 'data/'
    do x = -360, 360
        x_radians = (x*2*3.14159)/360
        write(10,*) x, sin(x_radians)
    end do
    close(unit=10)
end program

{
    "fortran.fortls.disabled": true,
    "extensions.ignoreRecommendations": true
}

Si teniu algun dubte o no us funciona alguna part, deixeu un comentari a la part on us heu encallat i si puc us intento ajudar (Martí).

Relacionat

Compilar Fortran i gnuplot amb GitHub Codespaces