Solafune-Tools: Open library for Solafune developers and hackers where you can share tools for geospatial data

This library package is an integrated open-source tool for Solafune developers, Solafune hackers, scientists, engineers, students, and anyone interested in geospatial data analysis. The solafune-tools contain many tools to help you develop your analysis like downloading STAC catalogs and Sentinel-2 imagery (from Planetary Computer) and then assembling it into a cloudless mosaic, competition_tools, community_tools, and other tools in geospatial data analysis. Other tools also will be added in the future.

July 2025: Added 5x Super-Resolution from the competition!

Quickstart

Install the package using pip or uv pip, recommend using python >= 3.10:

uv pip install solafune_tools

You can also install the add-on requirements, like our 5x Super Resolution model from the competition.

uv pip install solafune_tools[super_resolution]

Or to install all the add-ons, you can also do this

uv pip install solafune_tools[full]

All public-facing functions have detailed docstrings explaining their expected inputs and outputs. You can check any of them through print(solafune_tools.function_name.__doc__) (if you don't use print it shows as an unstructured string) or ??solafune_tools.function_name in the Jupyter notebooks. Before using the library, you can set the directory where you want to store data by calling.

solafune_tools.set_data_directory(dir_path="your_data_dir_here")

The above command sets the environment variable solafune_tools_data_dir from where all sub-modules draw their file paths. It is not set persistently (i.e., not written to .bashrc or similar), so you will need to put it each time you ssh into your machine or on reboot. If you do not explicitly set this, it will default to creating/using a data folder within your current working directory.

Documentation

Refer to this link for further information on each tool contained in this repository.

Contributions

Thank you for your interest in contributing to solafune-tools! This project is dedicated to building powerful, open-source tools for geospatial data analysis, aiming to facilitate tasks like data processing, visualization, and spatial analysis. Contributions from the community are invaluable for improving and expanding this project, and we welcome your input!

Credits

For those who have contributed to this OSS, We are grateful for your contribution to this development of geospatial tools. In this section, we will add a table to show users who have contributed and the users' contributed functions, stay tuned!