space-mango 0.1.0__tar.gz

space_mango-0.1.0/.copier-answers.yml

@@ -0,0 +1,9 @@
+# Changes here will be overwritten by Copier. Do not edit manually.
+_commit: v0.2.25
+_src_path: gh:jlevy/simple-modern-uv
+package_author_email: changeme@example.com
+package_author_name: changeme
+package_description: changeme
+package_github_org: changeme
+package_module: changeme
+package_name: changeme

space_mango-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,63 @@
+# This workflow will install Python dependencies, run tests and lint with a single version of Python
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python
+
+name: CI
+
+on:
+  push:
+    # Use ["main", "master"] for CI only on the default branch.
+    # Use ["**"] for CI on all branches.
+    branches: ["main", "master"]
+  pull_request:
+    branches: ["main", "master"]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    strategy:
+      matrix:
+        # Update this as needed:
+        # Common platforms: ["ubuntu-latest", "macos-latest", "windows-latest"]
+        os: ["ubuntu-latest"]
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+
+    # Linux only by default. Use ${{ matrix.os }} for other OSes.
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      # Generally following uv docs:
+      # https://docs.astral.sh/uv/guides/integration/github/
+
+      - name: Checkout (official GitHub action)
+        uses: actions/checkout@v6
+        with:
+          # Important for versioning plugins:
+          fetch-depth: 0
+
+      - name: Install uv (official Astral action)
+        uses: astral-sh/setup-uv@v7
+        with:
+          # Update this as needed:
+          version: "0.10.2"
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+
+      - name: Set up Python (using uv)
+        run: uv python install
+
+      # Alternately can use the official Python action:
+      # - name: Set up Python (using actions/setup-python)
+      #   uses: actions/setup-python@v5
+      #   with:
+      #     python-version: ${{ matrix.python-version }}
+
+      - name: Install all dependencies
+        run: uv sync --all-extras
+
+      - name: Run linting
+        run: uv run python devtools/lint.py
+
+      - name: Run tests
+        run: uv run pytest

space_mango-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,45 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch: # Enable manual trigger.
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write # Mandatory for OIDC.
+      contents: read
+    steps:
+      - name: Checkout (official GitHub action)
+        uses: actions/checkout@v6
+        with:
+          # Important for versioning plugins:
+          fetch-depth: 0
+
+      - name: Install uv (official Astral action)
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.10.2"
+          enable-cache: true
+          python-version: "3.12"
+
+      - name: Set up Python (using uv)
+        run: uv python install
+
+      - name: Install all dependencies
+        run: uv sync --all-extras
+
+      - name: Run tests
+        run: uv run pytest
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        run: uv publish --trusted-publishing always
+        # Although uv is newer and faster, the "official" publishing option is the one from PyPA,
+        # which uses twine. If desired, replace `uv publish` with:
+        # uses: pypa/gh-action-pypi-publish@release/v1

space_mango-0.1.0/.gitignore

@@ -0,0 +1,179 @@
+# Additions to standard GitHub .gitignore:
+*.bak
+*.orig
+tmp/
+trash/
+attic/
+.kash/
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# PyPI configuration file
+.pypirc

space_mango-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 changeme
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

space_mango-0.1.0/Makefile

@@ -0,0 +1,32 @@
+# Makefile for easy development workflows.
+# See docs/development.md for docs.
+# Note GitHub Actions call uv directly, not this Makefile.
+
+.DEFAULT_GOAL := default
+
+.PHONY: default install lint test upgrade build clean
+
+default: install lint test 
+
+install:
+	uv sync --all-extras
+
+lint:
+	uv run python devtools/lint.py
+
+test:
+	uv run pytest
+
+upgrade:
+	uv sync --upgrade --all-extras --dev
+
+build:
+	uv build
+
+clean:
+	-rm -rf dist/
+	-rm -rf *.egg-info/
+	-rm -rf .pytest_cache/
+	-rm -rf .mypy_cache/
+	-rm -rf .venv/
+	-find . -type d -name "__pycache__" -exec rm -rf {} +

space_mango-0.1.0/PKG-INFO

@@ -0,0 +1,184 @@
+Metadata-Version: 2.4
+Name: space-mango
+Version: 0.1.0
+Summary: Python client and server for the MANGO magnetospheric dataset
+Project-URL: Repository, https://github.com/LaboratoryOfPlasmaPhysics/mango
+Author-email: Alexis Jeandet <alexis.jeandet@member.fsf.org>
+License-Expression: GPL-3.0-or-later
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Physics
+Classifier: Typing :: Typed
+Requires-Python: <4.0,>=3.11
+Requires-Dist: httpx>=0.28
+Requires-Dist: polars>=1.0
+Requires-Dist: pyarrow>=18.0
+Provides-Extra: server
+Requires-Dist: cyclopts>=4.10.1; extra == 'server'
+Requires-Dist: fastapi>=0.115; extra == 'server'
+Requires-Dist: gunicorn>=23.0; extra == 'server'
+Requires-Dist: uvicorn-worker>=0.3; extra == 'server'
+Requires-Dist: uvicorn[standard]>=0.34; extra == 'server'
+Description-Content-Type: text/markdown
+
+
+# MANGO: Magnetospheric Atlas of Normalized Geospace Observations
+
+<img width="300" height="300" alt="mangologo" src="https://github.com/user-attachments/assets/5a92150f-ce77-45a8-b15e-8f66ff7cf44b" />
+
+
+## Overview
+
+**MANGO** is a dataset and Python toolkit for the global analysis of Earth's magnetosphere.
+Unlike raw satellite observations, MANGO provides a **unified, classified, and spatially normalized** view of geospace,
+where each datapoint is contextualized by its magnetospheric region and upstream solar wind conditions and
+repositioned relative to dynamic boundaries like the magnetopause and bow shock.
+
+By accounting for the dynamic nature of magnetospheric boundaries,
+MANGO allows researchers to treat disparate satellite observations as part of a single, coherent atlas.
+
+## Key Features
+
+Every data point in the MANGO dataset is:
+* **Classified:** Labeled by its specific magnetospheric region (magnetosphere, magnetosheath, solar wind).
+* **Contextualized:** Associated with the causal upstream solar wind conditions retrieved from OMNI data.
+* **Normalized:** Repositioned spatially relative to dynamic boundaries (the bow shock and magnetopause).
+
+The Python package provides:
+* A **client** for querying the public MANGO server — returns [Polars](https://pola.rs) DataFrames via Arrow IPC.
+* A **server** (optional) for self-hosting the dataset with FastAPI.
+* **Data-driven filter catalog** — range filters on IMF, solar wind, spatial coordinates, and local plasma parameters.
+
+
+---
+
+## Installation
+
+```bash
+# Client only (query the public server)
+pip install space-mango
+
+# With server dependencies (self-hosting)
+pip install space-mango[server]
+```
+
+## Quick Start
+
+```python
+import space_mango as sm
+
+# List available regions
+sm.regions()
+# ['magnetosphere', 'magnetosheath', 'solar_wind']
+
+# Get magnetosheath data with southward IMF and high dynamic pressure
+df = sm.get_data("magnetosheath", bz_imf_max=-2, pd_sw_min=3)
+
+# Select specific columns and spacecraft
+df = sm.get_data(
+    "magnetosphere",
+    columns=["X_gsm", "Y_gsm", "Z_gsm", "Np", "Bz"],
+    spacecraft=["MMS1", "THA"],
+    time_min="2015-01-01",
+    time_max="2020-12-31",
+)
+
+# List available filters for a region
+sm.filters("magnetosheath")
+
+# List columns
+sm.columns("magnetosphere")
+```
+
+## Self-Hosting
+
+```bash
+# Start the server (requires mango[server])
+mango serve --data-dir /path/to/parquet/data
+
+# Docker
+./docker/build.sh
+docker run -d -p 8000:8000 -v /path/to/data:/data/mango:ro mango
+```
+
+The server supports deployment behind a reverse proxy via `MANGO_ROOT_PATH`:
+
+```bash
+docker run -d -p 8000:8000 \
+  -e MANGO_ROOT_PATH="/mango" \
+  -v /path/to/data:/data/mango:ro mango
+```
+
+
+
+## 📚 References
+
+List of publications using the MANGO dataset:
+
+---
+
+### 🚀 2026
+
+* **The MANGO dataset: Magnetospheric Atlas of Normalized Geospace Observations** **Michotte de Welle, B.**, Aunai, N., Ghisalberti, A., Lavraud, B., et al.  
+    *In prep. for Nature Scientific Data*
+
+---
+
+### 🚀 2025
+
+* **Statistical Estimate of the Magnetopause Reconnection Rate as a Function of the Interplanetary Magnetic Field Clock Angle** **Michotte de Welle, B.**, Aunai, N., Lavraud, B., et al.  
+    *ESS Open Archive*, Septembre 2025.  
+    [🔗 DOI: 10.22541/essoar.175745453.30048233/v1](https://doi.org/10.22541/essoar.175745453.30048233/v1)
+
+* **A New X-Line Model: Comparison to MHD Magnetic Separator** **Michotte de Welle, B.**, Connor, H., Sibeck, D., Glocer, A., Fuselier, S., Trattner, K., Petrinec, S., Brenner, A., Bagheri, F., & Lee, S.  
+    *Journal of Geophysical Research (Space Physics)*, 130(11).  
+    [🔗 DOI: 10.1029/2025JA034558](https://doi.org/10.1029/2025JA034558) | [🌌 ADS](https://ui.adsabs.harvard.edu/abs/2025JGRA..13034558M)
+
+* **The Speed of Interplanetary Shocks Through the Magnetosheath: A Toy Model** Moissard, C., Butcher, C., Ruler, E., Richardson, J., **Michotte de Welle, B.**, Steward, W., Pritchard, M., et al.  
+    *Geophysical Research Letters*, 52(7).  
+    [🔗 DOI: 10.1029/2024GL113488](https://doi.org/10.1029/2024GL113488) | [🌌 ADS](https://ui.adsabs.harvard.edu/abs/2025GeoRL..5213488M)
+
+---
+
+### 🛰️ 2024
+* **Advanced Methods for Analyzing in-Situ Observations of Magnetic Reconnection** Hasegawa, H., Argall, M. R., Aunai, N., ..., **Michotte de Welle, B.**, ..., & Zenitani, S.  
+    *Space Science Reviews*, 220(6).  
+    [🔗 DOI: 10.1007/s11214-024-01095-w](https://doi.org/10.1007/s11214-024-01095-w) | [🌌 ADS](https://ui.adsabs.harvard.edu/abs/2024SSRv..220...68H)
+
+* **Surface Charging of the Jupiter Icy Moons Explorer (JUICE) Spacecraft in the Solar Wind at 1 AU** Holmberg, M. K. G., Jackman, C. M., Taylor, M. G. G. T., Witasse, O., Wahlund, J.-E., Barabash, S., **Michotte de Welle, B.**, et al.  
+    *Journal of Geophysical Research (Space Physics)*, 129(9).  
+    [🔗 DOI: 10.1029/2023JA032137](https://doi.org/10.1029/2023JA032137) | [🌌 ADS](https://ui.adsabs.harvard.edu/abs/2024JGRA..12932137H)
+
+* **Global Environmental Constraints on Magnetic Reconnection at the Magnetopause From In Situ Measurements** **Michotte de Welle, B.**, Aunai, N., Lavraud, B., Génot, V., Nguyen, G., Ghisalberti, A., Smets, R., & Jeandet, A.  
+    *Journal of Geophysical Research (Space Physics)*, 129(8).  
+    [🔗 DOI: 10.1029/2023JA032098](https://doi.org/10.1029/2023JA032098) | [🌌 ADS](https://ui.adsabs.harvard.edu/abs/2024JGRA..12932098M)
+
+* **Spatial distribution of plasma density and magnetic field amplitude in the dayside magnetosheath as a function of the IMF orientation** **Michotte de Welle, B.**, Aunai, N., Lavraud, B., Génot, V., Jeandet, A., Nguyen, G., Ghisalberti, A., & Smets, R.  
+    *Frontiers in Astronomy and Space Sciences*, 11.  
+    [🔗 DOI: 10.3389/fspas.2024.1427791](https://doi.org/10.3389/fspas.2024.1427791) | [🌌 ADS](https://ui.adsabs.harvard.edu/abs/2024FrASS..1127791M)
+
+---
+
+### 🔍 2022
+
+#### Massive Multi-Mission Statistical Study and Analytical Modeling of the Earth's Magnetopause:
+
+1.  **Part 1: A Gradient Boosting Based Automatic Detection of Near-Earth Regions** Nguyen, G., Aunai, N., **Michotte de Welle, B.**, et al. [🔗 DOI: 10.1029/2021JA029773](https://doi.org/10.1029/2021JA029773)
+2.  **Part 2: Shape and Location** Nguyen, G., Aunai, N., **Michotte de Welle, B.**, et al. [🔗 DOI: 10.1029/2021JA029774](https://doi.org/10.1029/2021JA029774)
+3.  **Part 3: An Asymmetric Non Indented Magnetopause Analytical Model** Nguyen, G., Aunai, N., **Michotte de Welle, B.**, et al. [🔗 DOI: 10.1029/2021JA030112](https://doi.org/10.1029/2021JA030112)
+4.  **Part 4: On the Near-Cusp Magnetopause Indentation** Nguyen, G., Aunai, N., **Michotte de Welle, B.**, et al. [🔗 DOI: 10.1029/2021JA029776](https://doi.org/10.1029/2021JA029776)
+
+#### Others
+
+* **Global Three-Dimensional Draping of Magnetic Field Lines in Earth's Magnetosheath** **Michotte de Welle, B.**, Aunai, N., Nguyen, G., Lavraud, B., Génot, V., et al.  
+    *Journal of Geophysical Research (Space Physics)*, 127(12).  
+    [🔗 DOI: 10.1029/2022JA030996](https://doi.org/10.1029/2022JA030996) | [🌌 ADS](https://ui.adsabs.harvard.edu/abs/2022JGRA..12730996M)
+
+

space_mango-0.1.0/README.md

@@ -0,0 +1,154 @@
+
+# MANGO: Magnetospheric Atlas of Normalized Geospace Observations
+
+<img width="300" height="300" alt="mangologo" src="https://github.com/user-attachments/assets/5a92150f-ce77-45a8-b15e-8f66ff7cf44b" />
+
+
+## Overview
+
+**MANGO** is a dataset and Python toolkit for the global analysis of Earth's magnetosphere.
+Unlike raw satellite observations, MANGO provides a **unified, classified, and spatially normalized** view of geospace,
+where each datapoint is contextualized by its magnetospheric region and upstream solar wind conditions and
+repositioned relative to dynamic boundaries like the magnetopause and bow shock.
+
+By accounting for the dynamic nature of magnetospheric boundaries,
+MANGO allows researchers to treat disparate satellite observations as part of a single, coherent atlas.
+
+## Key Features
+
+Every data point in the MANGO dataset is:
+* **Classified:** Labeled by its specific magnetospheric region (magnetosphere, magnetosheath, solar wind).
+* **Contextualized:** Associated with the causal upstream solar wind conditions retrieved from OMNI data.
+* **Normalized:** Repositioned spatially relative to dynamic boundaries (the bow shock and magnetopause).
+
+The Python package provides:
+* A **client** for querying the public MANGO server — returns [Polars](https://pola.rs) DataFrames via Arrow IPC.
+* A **server** (optional) for self-hosting the dataset with FastAPI.
+* **Data-driven filter catalog** — range filters on IMF, solar wind, spatial coordinates, and local plasma parameters.
+
+
+---
+
+## Installation
+
+```bash
+# Client only (query the public server)
+pip install space-mango
+
+# With server dependencies (self-hosting)
+pip install space-mango[server]
+```
+
+## Quick Start
+
+```python
+import space_mango as sm
+
+# List available regions
+sm.regions()
+# ['magnetosphere', 'magnetosheath', 'solar_wind']
+
+# Get magnetosheath data with southward IMF and high dynamic pressure
+df = sm.get_data("magnetosheath", bz_imf_max=-2, pd_sw_min=3)
+
+# Select specific columns and spacecraft
+df = sm.get_data(
+    "magnetosphere",
+    columns=["X_gsm", "Y_gsm", "Z_gsm", "Np", "Bz"],
+    spacecraft=["MMS1", "THA"],
+    time_min="2015-01-01",
+    time_max="2020-12-31",
+)
+
+# List available filters for a region
+sm.filters("magnetosheath")
+
+# List columns
+sm.columns("magnetosphere")
+```
+
+## Self-Hosting
+
+```bash
+# Start the server (requires mango[server])
+mango serve --data-dir /path/to/parquet/data
+
+# Docker
+./docker/build.sh
+docker run -d -p 8000:8000 -v /path/to/data:/data/mango:ro mango
+```
+
+The server supports deployment behind a reverse proxy via `MANGO_ROOT_PATH`:
+
+```bash
+docker run -d -p 8000:8000 \
+  -e MANGO_ROOT_PATH="/mango" \
+  -v /path/to/data:/data/mango:ro mango
+```
+
+
+
+## 📚 References
+
+List of publications using the MANGO dataset:
+
+---
+
+### 🚀 2026
+
+* **The MANGO dataset: Magnetospheric Atlas of Normalized Geospace Observations** **Michotte de Welle, B.**, Aunai, N., Ghisalberti, A., Lavraud, B., et al.  
+    *In prep. for Nature Scientific Data*
+
+---
+
+### 🚀 2025
+
+* **Statistical Estimate of the Magnetopause Reconnection Rate as a Function of the Interplanetary Magnetic Field Clock Angle** **Michotte de Welle, B.**, Aunai, N., Lavraud, B., et al.  
+    *ESS Open Archive*, Septembre 2025.  
+    [🔗 DOI: 10.22541/essoar.175745453.30048233/v1](https://doi.org/10.22541/essoar.175745453.30048233/v1)
+
+* **A New X-Line Model: Comparison to MHD Magnetic Separator** **Michotte de Welle, B.**, Connor, H., Sibeck, D., Glocer, A., Fuselier, S., Trattner, K., Petrinec, S., Brenner, A., Bagheri, F., & Lee, S.  
+    *Journal of Geophysical Research (Space Physics)*, 130(11).  
+    [🔗 DOI: 10.1029/2025JA034558](https://doi.org/10.1029/2025JA034558) | [🌌 ADS](https://ui.adsabs.harvard.edu/abs/2025JGRA..13034558M)
+
+* **The Speed of Interplanetary Shocks Through the Magnetosheath: A Toy Model** Moissard, C., Butcher, C., Ruler, E., Richardson, J., **Michotte de Welle, B.**, Steward, W., Pritchard, M., et al.  
+    *Geophysical Research Letters*, 52(7).  
+    [🔗 DOI: 10.1029/2024GL113488](https://doi.org/10.1029/2024GL113488) | [🌌 ADS](https://ui.adsabs.harvard.edu/abs/2025GeoRL..5213488M)
+
+---
+
+### 🛰️ 2024
+* **Advanced Methods for Analyzing in-Situ Observations of Magnetic Reconnection** Hasegawa, H., Argall, M. R., Aunai, N., ..., **Michotte de Welle, B.**, ..., & Zenitani, S.  
+    *Space Science Reviews*, 220(6).  
+    [🔗 DOI: 10.1007/s11214-024-01095-w](https://doi.org/10.1007/s11214-024-01095-w) | [🌌 ADS](https://ui.adsabs.harvard.edu/abs/2024SSRv..220...68H)
+
+* **Surface Charging of the Jupiter Icy Moons Explorer (JUICE) Spacecraft in the Solar Wind at 1 AU** Holmberg, M. K. G., Jackman, C. M., Taylor, M. G. G. T., Witasse, O., Wahlund, J.-E., Barabash, S., **Michotte de Welle, B.**, et al.  
+    *Journal of Geophysical Research (Space Physics)*, 129(9).  
+    [🔗 DOI: 10.1029/2023JA032137](https://doi.org/10.1029/2023JA032137) | [🌌 ADS](https://ui.adsabs.harvard.edu/abs/2024JGRA..12932137H)
+
+* **Global Environmental Constraints on Magnetic Reconnection at the Magnetopause From In Situ Measurements** **Michotte de Welle, B.**, Aunai, N., Lavraud, B., Génot, V., Nguyen, G., Ghisalberti, A., Smets, R., & Jeandet, A.  
+    *Journal of Geophysical Research (Space Physics)*, 129(8).  
+    [🔗 DOI: 10.1029/2023JA032098](https://doi.org/10.1029/2023JA032098) | [🌌 ADS](https://ui.adsabs.harvard.edu/abs/2024JGRA..12932098M)
+
+* **Spatial distribution of plasma density and magnetic field amplitude in the dayside magnetosheath as a function of the IMF orientation** **Michotte de Welle, B.**, Aunai, N., Lavraud, B., Génot, V., Jeandet, A., Nguyen, G., Ghisalberti, A., & Smets, R.  
+    *Frontiers in Astronomy and Space Sciences*, 11.  
+    [🔗 DOI: 10.3389/fspas.2024.1427791](https://doi.org/10.3389/fspas.2024.1427791) | [🌌 ADS](https://ui.adsabs.harvard.edu/abs/2024FrASS..1127791M)
+
+---
+
+### 🔍 2022
+
+#### Massive Multi-Mission Statistical Study and Analytical Modeling of the Earth's Magnetopause:
+
+1.  **Part 1: A Gradient Boosting Based Automatic Detection of Near-Earth Regions** Nguyen, G., Aunai, N., **Michotte de Welle, B.**, et al. [🔗 DOI: 10.1029/2021JA029773](https://doi.org/10.1029/2021JA029773)
+2.  **Part 2: Shape and Location** Nguyen, G., Aunai, N., **Michotte de Welle, B.**, et al. [🔗 DOI: 10.1029/2021JA029774](https://doi.org/10.1029/2021JA029774)
+3.  **Part 3: An Asymmetric Non Indented Magnetopause Analytical Model** Nguyen, G., Aunai, N., **Michotte de Welle, B.**, et al. [🔗 DOI: 10.1029/2021JA030112](https://doi.org/10.1029/2021JA030112)
+4.  **Part 4: On the Near-Cusp Magnetopause Indentation** Nguyen, G., Aunai, N., **Michotte de Welle, B.**, et al. [🔗 DOI: 10.1029/2021JA029776](https://doi.org/10.1029/2021JA029776)
+
+#### Others
+
+* **Global Three-Dimensional Draping of Magnetic Field Lines in Earth's Magnetosheath** **Michotte de Welle, B.**, Aunai, N., Nguyen, G., Lavraud, B., Génot, V., et al.  
+    *Journal of Geophysical Research (Space Physics)*, 127(12).  
+    [🔗 DOI: 10.1029/2022JA030996](https://doi.org/10.1029/2022JA030996) | [🌌 ADS](https://ui.adsabs.harvard.edu/abs/2022JGRA..12730996M)
+
+