tREADME.rst - sphere - GPU-based 3D discrete element method algorithm with optional fluid coupling
 (HTM) git clone git://src.adamsgaard.dk/sphere
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) LICENSE
       ---
       tREADME.rst (4955B)
       ---
            1 =============
            2 sphere readme
            3 =============
            4 ``sphere`` is a 3D discrete element method algorithm utilizing CUDA. ``sphere``
            5 allows for optional simulation of two-way coupled fluid flow using the
            6 Navier-Stokes or Darcy formulations.
            7 
            8 A powerful Nvidia GPU with proper support for double precision floating is
            9 highly recommended. ``sphere`` has been tested with Nvidia Tesla GPUs, and has 
           10 successfully been employed on the clusters `Grendel 
           11 <https://www.cscaa.dk/grendel/hardware/>`_ (Aarhus University), `ICME 
           12 <https://icme.stanford.edu/computer-resources/gpu-cluster>`_ (Stanford 
           13 University), `Comet <https://www.sdsc.edu/services/hpc/hpc_systems.html#comet>`_ 
           14 (San Diego Supercomputing Center),  `Bridges 
           15 <https://psc.edu/index.php/resources/computing/bridges>`_ (Portland 
           16 Supercomputing Center), and `Stampede <https://www.tacc.utexas.edu/stampede/>`_ 
           17 (Texas Advanced Supercomputing Center).
           18 
           19 License
           20 -------
           21 ``sphere`` is licensed under the ISC License, See `LICENSE.txt
           22 <LICENSE.txt>`_ for more information.
           23 
           24 Documentation
           25 -------------
           26 See the separate documentation for general reference and installation
           27 instructions. The documentation is by default available in
           28 the `html <doc/html/index.html>`_ and `pdf <doc/pdf/sphere.pdf>`_ formats.
           29 
           30 Publications
           31 ------------
           32 ``sphere`` has been used to produce results in the following scientific
           33 publications and presentations:
           34 
           35 - Damsgaard, A., L. Goren, and J. Suckale (2020), Water pressure fluctuations
           36   control variability in sediment flux and slip dynamic beneath glaciers and
           37   ice streams, Communications Earth & Environment
           38   `doi:10.1038/s43247-020-00074-4>`_.
           39   `<https://doi.org/10.1038/s43247-020-00074-4
           40 - Damsgaard, A., J. Suckale, J. A. Piotrowski, M. Houssais, M. R. Siegfried, H.
           41   A. Fricker (2017), Sediment behavior controls equilibrium width of subglacial
           42   channels, Journal of Glaciology, 
           43   `doi:10.1017/jog.2017.71 
           44   <https://doi.org/10.1017/jog.2017.71>`_.
           45 - Damsgaard, A., A. Cabrales-Vargas, J. Suckale, and L. Goren (2017), The 
           46   coupled dynamics of meltwater percolation and granular deformation in the 
           47   sediment layer underlying parts of the big ice sheets, Poromechanics VI, 
           48   `doi:10.1061/9780784480779.024 
           49   <https://doi.org/10.1061/9780784480779.024>`_.
           50 - Damsgaard, A., D.L. Egholm, L.H. Beem, S. Tulaczyk, N.K. Larsen, J.A.  
           51   Piotrowski, and M.R. Siegfried (2016), Ice flow dynamics forced by water 
           52   pressure variations in subglacial granular beds, Geophysical Research Letters, 
           53   43, `doi:10.1002/2016GL071579 <https://doi.org/10.1002/2016GL071579>`_.
           54 - Damsgaard, A., D.L. Egholm, J.A. Piotrowski, S. Tulaczyk, N.K. Larsen, and
           55   C.F. Brædstrup (2015), A new methodology to simulate subglacial deformation of
           56   water-saturated granular material, The Cryosphere, 9, 2183-2200,
           57   `doi:10.5194/tc-9-2183-2015 <https://doi.org/10.5194/tc-9-2183-2015>`_.
           58 - Damsgaard, A., D.L. Egholm, J.A. Piotrowski, S. Tulaczyk, N.K. Larsen, and
           59   C.F. Brædstrup (2014), Numerical modeling of particle-fluid mixtures in a
           60   subglacial setting. `Poster at Americal Geophysical Union Fall Meeting
           61   <https://cs.au.dk/~adc/files/AGU2014-Poster.pdf>`_.
           62 - Damsgaard, A., D.L. Egholm, J.A. Piotrowski, S. Tulaczyk, N.K. Larsen, and
           63   K. Tylmann (2013), Discrete element modeling of subglacial sediment
           64   deformation, J. Geophys. Res. Earth Surf., 118, 2230–2242,
           65   `doi:10.1002/2013JF002830 <https://doi.org/10.1002/2013JF002830>`_.
           66 - Damsgaard, A., D.L. Egholm, J.A. Piotrowski, S. Tulaczyk, and N.K. Larsen
           67   (2013), Discrete element modeling of subglacial sediment deformation.
           68   Talk at American Geophysical Fall Meeting 2013.
           69 - Damsgaard, A., D.L. Egholm, J.A. Piotrowski, S. Tulaczyk, and N.K. Larsen
           70   (2013), Numerical modelling of granular subglacial deformation using the
           71   discrete element method. `Poster at European Geosciences Union General
           72   Assembly 2013
           73   <https://cs.au.dk/~adc/files/EGU2013-Poster.pdf>`_.
           74 - Damsgaard, A., D.L. Egholm, J.A. Piotrowski, and S. Tulaczyk
           75   (2012), Discrete element modelling of subglacial sediment deformation.
           76   `Poster at European Geosciences Union General Assembly 2012
           77   <https://cs.au.dk/~adc/files/EGU2012-Poster.pdf>`_.
           78 - Damsgaard, A., D.L. Egholm, and J.A. Piotrowski
           79   (2011), Numerical modelling of sediment deformation by glacial stress.
           80   `Poster at International Union for Quaternary Research Congress 2011
           81   <https://cs.au.dk/~adc/files/INQUA2011-Poster.pdf>`_.
           82 - Damsgaard, A., D.L. Egholm, and J.A. Piotrowski
           83   (2011), Numerical modelling of subglacial sediment deformation.
           84   `Poster at European Geosciences Union General Assembly 2011
           85   <https://cs.au.dk/~adc/files/EGU2011-Poster.pdf>`_.
           86 
           87 If you use `sphere` for scientific publications, please get in touch to add your
           88 entry to the above list. It would be appreciated if the `sphere` development is
           89 acknowledged by citing one of the above *Damsgaard et al.* publications.
           90 
           91 Author
           92 ------
           93 Anders Damsgaard, anders@adamsgaard.dk https://adamsgaard.dk