create_geocroissant_from_stac
Turn Earth observation STAC search results into validated GeoCroissant metadata. Use bounding box, date range, and collection filters to build the dataset.
Instructions
Searches live EO data and generates VALIDATED GeoCroissant metadata from it.
This is the flagship end-to-end pipeline of this server:
1. Runs a real STAC search (bbox + collections + datetime + cloud cover).
2. Derives GeoCroissant properties from the results: schema.org spatial/
temporal coverage, CRS (EPSG:4326), record endpoint, band
configuration and spectral band metadata from `eo:bands`
(micrometers converted to nanometers), distribution FileObjects for
direct asset URLs, and a RecordSet with one inline row per scene.
3. Validates the document through the official `mlcroissant` library
before returning it.
Usage: THE tool for turning discovered EO data into GeoCroissant.
After generation use `inspect_geocroissant`, `get_records_preview`
and `extract_distribution_urls` on the output.
Returns:
--------
Dictionary containing:
- valid/errors/warnings: mlcroissant validation outcome.
- json_ld: The generated GeoCroissant document.
- path: Output file path when output_filename was given.
- search_summary: What was searched and how many scenes matched.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bbox | Yes | Bounding box as [min_lon, min_lat, max_lon, max_lat]. | |
| name | Yes | Name for the generated dataset. | |
| limit | No | Number of scenes to include (1-50). | |
| license | No | License URL. | |
| creators | No | Creator names. | |
| modality | No | Modality used to pick default collections. | |
| collections | No | Explicit STAC collection ids. | |
| description | No | Description of the generated dataset. | |
| datetime_range | No | STAC datetime interval. | |
| max_cloud_cover | No | Max cloud cover percentage. | |
| output_filename | No | When provided, writes the validated JSON-LD into GEOCR_OUTPUT_DIR (or temp dir) and returns the path. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||