Skip to content

Windows Utilities#861

Merged
pgbrodrick merged 6 commits into
isofit:devfrom
jammont:windows/expanded
Apr 13, 2026
Merged

Windows Utilities#861
pgbrodrick merged 6 commits into
isofit:devfrom
jammont:windows/expanded

Conversation

@jammont

@jammont jammont commented Feb 12, 2026

Copy link
Copy Markdown
Collaborator

Recent troubles with Windows users:

  • gfortran is not installed
    • Required to compile 6S
    • Difficult to install
  • bash is not installed
    • Required for 6S simulation executions
    • Difficult to install via WSL

In an effort to ease these pain points, I've attempted the following:

  • There's already a precheck for gfortran in data/cli/sixs.py. Since isofit download sixs already supported a --mingw for Windows which is used for make to compile 6S, mingw also comes with gfortran. As such, I've set the precheck to prompt Windows users to install mingw via the CLI before 6S.
  • I broke out the mingw install to data/cli/windows.py to keep Windows utility installs together and separate from 6S. With this, I've added a isofit download windows --bash option to install the portable version of Git Bash.
  • The mingw and git-bash installs are tracked within the isofit.ini file and inserted into the $PATH at runtime, so they're always available
  • isofit download all will download these Windows utilities before anything else to ensure they're available for 6S
  • The Git Bash terminal can be spawned via isofit dev bash, which will allow Windows users to follow the same docs instructions as Mac/Linux, hopefully simplifying a lot of headaches
  • data/build_examples.py now generates .ps1 scripts for Windows PowerShell as an additional option for users
  • Asked AI to generate a document on executing the examples for the various pathways Windows users could experience ([PowerShell, Git Bash, WSL] + uv). I've touched this up so it's accurate, but always want team sign-off on something like this

Closes #847

@jammont jammont marked this pull request as ready for review February 18, 2026 21:58
@jammont jammont force-pushed the windows/expanded branch from 917fad2 to 9537145 Compare April 9, 2026 17:47
@pgbrodrick

Copy link
Copy Markdown
Collaborator

@evan-greenbrg - could you give this a review when you get a chance? James thinks its ready to go!

@github-actions

github-actions Bot commented Apr 9, 2026

Copy link
Copy Markdown
📊 Generated results:

URL: isofit/isofit-test-results#24
SHA: 52ce0fa

@evan-greenbrg evan-greenbrg self-requested a review April 9, 2026 21:11
Comment thread docs/examples.md
2. Setup a Python environment
3. Install ISOFIT and run examples as you would on Linux

???+ info

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the ???+ an mkdocs syntax? These show up when I render the .md via Gitub.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yep, it's what renders these blocks:
image

@evan-greenbrg

Copy link
Copy Markdown
Collaborator

@jammont This is great. My only question is posted above, but I'm guessing that this is mkdocs-specific formatting.

@pgbrodrick pgbrodrick merged commit 4a064cd into isofit:dev Apr 13, 2026
27 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Windows support

3 participants