# MSWIM2D — Solar wind in the ecliptic plane, 1–75 AU (University of Michigan)

Two-dimensional multifluid MHD model (BATSRUS) of the solar wind in the
heliospheric equatorial plane, 1–75 AU, driven by in-situ observations
(the MIDL L1 product, STEREO-A, STEREO-B, and Solar Orbiter) ballistically
propagated to 1 AU. Output spans 1998–present in HGI coordinates, refreshes
automatically each month, and includes a prediction extension whose useful
horizon grows with heliocentric distance.

## Data access

- Model output page: https://csem.engin.umich.edu/MSWIM2D/interpolate.html
  (JavaScript-rendered; the routes below serve the same data directly)
- Python client (preferred):

      pip install mswim2d

      import mswim2d
      mswim2d.list_bodies()
      # ['Cassini', 'Earth', 'Galileo', 'Juno', 'Jupiter', ... 'Voyager2']
      data = mswim2d.get_trajectory("Earth", "2015-01-01", "2015-02-01")
      # returns an xarray Dataset (rho, ux/uy/uz, bx/by/bz, p, neutrals);
      # caches locally
      mswim2d.get_orbit("Voyager1", "2010-01-01", "2012-01-01")
      mswim2d.list_inputs()   # ['l1', 'stereoA', 'stereoB', 'solo']
      mswim2d.get_input("l1", "2015-01-01", "2015-02-01")

- Static data manifests (base https://csem.engin.umich.edu/MSWIM2D/;
  each manifest lists chunked data files relative to that base):

      precomputed_trajectories/chunks/manifest.json         (model output per body)
      MSWIM2D_Data_New/Satellite_Data/chunks/manifest.json  (driving observations)
      MSWIM2D_Data_New/snapshots_coarse/manifest.json       (2-D field snapshots)

## Documentation

- Output format — variables, units, HGI frame:
  https://csem.engin.umich.edu/MSWIM2D/format.html
- Model description: https://csem.engin.umich.edu/MSWIM2D/model.html
- Prediction skill vs. distance: https://csem.engin.umich.edu/MSWIM2D/prediction.html

## Code

- Model & pipeline source: https://github.com/connordimarco/MSWIM2D
- Python client source: https://github.com/connordimarco/CSEM-MSWIM2D
- PyPI: https://pypi.org/project/mswim2d/

## Citation & contact

- Keebler et al. (2022), ApJS 260, 43 — doi:10.3847/1538-4365/ac67eb
- Citation details and contact: https://csem.engin.umich.edu/MSWIM2D/resources.html

## Related

- MIDL — the merged L1 solar-wind product that drives this model:
  https://csem.engin.umich.edu/MIDL/llms.txt