swift

Modern astrophysics and cosmology particle-based code. Mirror of gitlab developments at https://gitlab.cosma.dur.ac.uk/swift/swiftsim

https://github.com/swiftsim/swift

Keywords

Keywords from Contributors

Repository

Modern astrophysics and cosmology particle-based code. Mirror of gitlab developments at https://gitlab.cosma.dur.ac.uk/swift/swiftsim

README

 Welcome to the cosmological hydrodynamical code
    ______       _________________
   / ___/ |     / /  _/ ___/_  __/
   \__ \| | /| / // // /_   / /
  ___/ /| |/ |/ // // __/  / /
 /____/ |__/|__/___/_/    /_/
 SPH With Inter-dependent Fine-grained Tasking

 Version : 2025.04
 Website: www.swiftsim.com
 Twitter: @SwiftSimulation

See INSTALL.swift for install instructions.

Usage: swift [options] [[--] param-file]
   or: swift [options] param-file
   or: swift_mpi [options] [[--] param-file]
   or: swift_mpi [options] param-file

Parameters:

    -h, --help                        show this help message and exit

  Simulation options:

    -b, --feedback                    Run with stars feedback.
    -c, --cosmology                   Run with cosmological time integration.
    --temperature                     Run with temperature calculation.
    -C, --cooling                     Run with cooling (also switches on --temperature).
    -D, --drift-all                   Always drift all particles even the ones
                                      far from active particles. This emulates
                                      Gadget-[23] and GIZMO's default behaviours.
    -F, --star-formation              Run with star formation.
    -g, --external-gravity            Run with an external gravitational potential.
    -G, --self-gravity                Run with self-gravity.
    -M, --multipole-reconstruction    Reconstruct the multipoles every time-step.
    -s, --hydro                       Run with hydrodynamics.
    -S, --stars                       Run with stars.
    -B, --black-holes                 Run with black holes.
    -k, --sinks                       Run with sink particles.
    -u, --fof                         Run Friends-of-Friends algorithm to
                                      perform black hole seeding.
    --lightcone                       Generate lightcone outputs.
    -x, --velociraptor                Run with structure finding.
    --line-of-sight                   Run with line-of-sight outputs.
    --limiter                         Run with time-step limiter.
    --sync                            Run with time-step synchronization
                                      of particles hit by feedback events.
    --csds                            Run with the Continuous Simulation Data
                                      Stream (CSDS).
    -R, --radiation                   Run with radiative transfer.
    --power                           Run with power spectrum outputs.

  Simulation meta-options:

    --quick-lyman-alpha               Run with all the options needed for the
                                      quick Lyman-alpha model. This is equivalent
                                      to --hydro --self-gravity --stars --star-formation
                                      --cooling.
    --eagle                           Run with all the options needed for the
                                      EAGLE model. This is equivalent to --hydro
                                      --limiter --sync --self-gravity --stars
                                      --star-formation --cooling --feedback
                                      --black-holes --fof.
    --gear                            Run with all the options needed for the
                                      GEAR model. This is equivalent to --hydro
                                      --limiter --sync --self-gravity --stars
                                      --star-formation --cooling --feedback.
    --agora                           Run with all the options needed for the
                                      AGORA model. This is equivalent to --hydro
                                      --limiter --sync --self-gravity --stars
                                      --star-formation --cooling --feedback.
                                      
  Control options:

    -a, --pin                         Pin runners using processor affinity.
    --nointerleave                    Do not interleave memory allocations across
                                      NUMA regions.
    -d, --dry-run                     Dry run. Read the parameter file, allocates
                                      memory but does not read the particles
                                      from ICs. Exits before the start of time
                                      integration. Checks the validity of
                                      parameters and IC files as well as memory
                                      limits.
    -e, --fpe                         Enable floating-point exceptions (debugging
                                      mode).
    -f, --cpu-frequency=         Overwrite the CPU frequency (Hz) to be
                                      used for time measurements.
    -n, --steps=                 Execute a fixed number of time steps.
                                      When unset use the time_end parameter
                                      to stop.
    -o, --output-params=         Generate a parameter file with the options
                                      for selecting the output fields.
    -P, --param=                 Set parameter value, overiding the value
                                      read from the parameter file. Can be used
                                      more than once {sec:par:value}.
    -r, --restart                     Continue using restart files.
    -t, --threads=               The number of task threads to use on each
                                      MPI rank. Defaults to 1 if not specified.
    --pool-threads=              The number of threads to use on each MPI
                                      rank for the threadpool operations.
                                      Defaults to the numbers of task threads
                                      if not specified.
    -T, --timers=                Print timers every time-step.
    -v, --verbose=               Run in verbose mode, in MPI mode 2 outputs
                                      from all ranks.
    -y, --task-dumps=            Time-step frequency at which task graphs
                                      are dumped.
    --cell-dumps=                Time-step frequency at which cell graphs
                                      are dumped.
    -Y, --threadpool-dumps=      Time-step frequency at which threadpool
                                      tasks are dumped.
    --dump-tasks-threshold=      Fraction of the total step's time spent
                                      in a task to trigger a dump of the task plot
                                      on this step

See the file examples/parameter_example.yml for an example of parameter file.

Owner

Citation (CITATION.cff)

cff-version: 1.2.0
title: >-
  SWIFT: SPH With Inter-dependent Fine-grained
  Tasking
message: 'If you use this software, please cite it as below'
type: software
authors:
  - given-names: Matthieu
    family-names: Schaller
    email: schaller@strw.leidenuniv.nl
    affiliation: Leiden University
    orcid: 'https://orcid.org/0000-0002-2395-4902'
  - given-names: Gonnet
    family-names: Pedro
  - given-names: Peter
    family-names: Draper
  - given-names: Aidan
    family-names: Chalk
  - given-names: Bert
    family-names: Vandenbroucke
  - given-names: James
    family-names: Willis
  - given-names: Richard
    family-names: Bower
  - given-names: Josh
    family-names: Borrow
  - given-names: Loic
    family-names: Hausammann
  - given-names: Yves
    family-names: Revaz
  - given-names: Jacob
    family-names: Kegerreis
  - given-names: Mladen
    family-names: Ivkovic
  - given-names: Stuart
    family-names: McAlpine
  - given-names: Folkert
    family-names: Nobels
  - given-names: John
    family-names: Helly
  - given-names: Yannick
    family-names: Bahé
  - given-names: Willem
    family-names: Elbers
  - given-names: Filip
    family-names: Husko

GitHub Events

Committers

Last synced: about 2 years ago

Issues and Pull Requests

Last synced: about 2 years ago