Instructions to use claytonwang/MarsScope-v1 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- OpenCLIP
How to use claytonwang/MarsScope-v1 with OpenCLIP:
import open_clip model, preprocess_train, preprocess_val = open_clip.create_model_and_transforms('hf-hub:claytonwang/MarsScope-v1') tokenizer = open_clip.get_tokenizer('hf-hub:claytonwang/MarsScope-v1') - Notebooks
- Google Colab
- Kaggle
MarsScope-v1
MarsScope-v1 is a planetary vision-language model for semantic retrieval and global mapping of Martian landforms. It is based on ViT-L-14-quickgelu, initialized from CLIP-DFN2B, and fine-tuned at 512 x 512 resolution on more than 200,000 curated pairs of planetary surface images and geomorphological descriptions. The underlying framework is referred to as MarScope in the associated papers.
MarsScope-v1 aligns orbital imagery and scientific language in a shared embedding space, supporting text-to-image, image-to-image, and multimodal retrieval for label-free exploration of planetary surfaces.
Model Details
- Architecture:
ViT-L-14-quickgelu - Framework: OpenCLIP / PyTorch
- Initialization: CLIP-DFN2B
- Input resolution: 512 x 512
- Parameters: approximately 0.4B
- Training objective: contrastive image-text alignment
Applications
The MarScope framework was introduced in Natural Language-Driven Global Mapping of Martian Landforms for natural language-driven global mapping, process-oriented geomorphological retrieval, and visual search for rare or previously unmapped features.
It was subsequently evaluated in MarsRetrieval, which covers paired Martian image-text retrieval, fine-grained landform retrieval, and planetary-scale geo-localization.
Usage
pip install torch open_clip_torch pillow
import open_clip
import torch
from PIL import Image
model_id = "hf-hub:claytonwang/MarsScope-v1"
device = "cuda" if torch.cuda.is_available() else "cpu"
model, _, preprocess = open_clip.create_model_and_transforms(model_id)
tokenizer = open_clip.get_tokenizer(model_id)
model = model.to(device).eval()
image = preprocess(Image.open("mars_image.png").convert("RGB"))
image = image.unsqueeze(0).to(device)
text = tokenizer([
"a satellite image of a central peak crater on Mars",
"a satellite image of yardangs on Mars",
]).to(device)
with torch.inference_mode():
image_features = model.encode_image(image, normalize=True)
text_features = model.encode_text(text, normalize=True)
similarity = image_features @ text_features.T
print(similarity)
For large-scale retrieval, encode and normalize the image gallery and text queries separately, then rank images by cosine similarity.
Examples
To illustrate the effect of planetary-domain fine-tuning, we compare the image-text cosine similarities produced by the general-purpose CLIP-DFN2B base model and MarsScope-v1:
CLIP-DFN2B
tensor([[0.3569, 0.2822],
[0.2729, 0.2723]])
MarsScope-v1
tensor([[0.4516, 0.0585],
[0.0963, 0.3537]])
Compared with the general-purpose CLIP-DFN2B base model, MarsScope-v1 shows stronger alignment between Martian landform images and their matching descriptions while more clearly separating mismatched pairs. For comprehensive evaluation, refer to MarsRetrieval.
Limitations
MarsScope-v1 is intended for planetary-science research. Retrieval results may be affected by image resolution, illumination, spatial scale, geographic coverage, and the terminology used in a query. Model outputs should be validated by domain experts before scientific interpretation.
Citation
@article{wang2026natural,
title = {Natural Language-Driven Global Mapping of Martian Landforms},
author = {Wang, Yiran and Wang, Shuoyuan and Wei, Zhaoran and Zhao, Jiannan
and Yao, Zhonghua and Xie, Zejian and Zhang, Songxin and Huang, Jun
and Jing, Bingyi and Wei, Hongxin},
journal = {arXiv preprint arXiv:2601.15949},
year = {2026}
}
@article{wang2026marsretrieval,
title = {MarsRetrieval: Benchmarking Vision-Language Models for
Planetary-Scale Geospatial Retrieval on Mars},
author = {Wang, Shuoyuan and Wang, Yiran and Wei, Hongxin},
journal = {arXiv preprint arXiv:2602.13961},
year = {2026}
}
- Downloads last month
- -
Model tree for claytonwang/MarsScope-v1
Base model
apple/DFN2B-CLIP-ViT-L-14
