= '''S'''olid '''Ea'''rth '''T'''eaching and '''Re'''search '''E'''nvironment = [[PageOutline]] SEATREE is a modular and user-friendly software to facilitate using [http://geosys.usc.edu/projects/seatree/wiki/screenshots solid Earth research tools] in the classroom and for interdisciplinary, scientific collaboration. We use python wrappers and make use of modern software design concepts, while remaining compatible with traditional scientific coding. Our goals are to provide a fully contained, yet transparent package that lets users operate in an easy, graphically supported "black box" mode, while also allowing to look under the hood. In the long run, we envision SEATREE to contribute to new ways of sharing scientific research, and making (numerical) experiments truly reproducible again. ([http://geodynamics.usc.edu/~becker/preprints/mbbssw08.pdf Eos Article]) SEATREE is module based, and the current release includes tools for computing mantle flow, for inverting for Earth structure by means of surface wave tomography, and a two-dimensional synthetic tomography case. Models for 3-D tomography and earthquake location are in the works. The main software design consists of transparent python wrappers that drive the modules, including a GMT plotting tool, and a graphical user interface. SEATREE is freely available under the GNU license; a desktop installation is required to use SEATREE right now but we are planning on a web-based version as well. We encourage you to [wiki:download take the software for a test drive]. If you want to use SEATREE in a classroom setting, we might be able to offer you some installation support and always welcome [wiki:bugs your feedback]. [wiki:screenshots Screenshots] Illustrations of the softwares capabilities and design concepts. [wiki:download Download and installation] Instructions on how to obtain and install the whole package. [wiki:UserDocs User Documentation] User-level documentation of SEATREE and the modules. [wiki:DevDocs Developer Documentation] Start here if you want to extend SEATREE and/or add modules. [wiki:PythonSandbox Python Sandbox] Programming tricks (for internal use) == Modules == The [wiki:UserDocs SEATREE graphical user interface] and our python wrappers provide access to the following computational tools which are provided and shared by different groups of researchers. === Geodynamics === [wiki:hc_docu hc]:: A Hager & O'Connell (1981) mantle flow computation tool for spherical mantle circulation that allow computing flow velocities, tractions, and the geoid given different tomographic models. [wiki:conman conman]:: 2D thermal convection module based on [http://www.geodynamics.org/cig/software/packages/mc/conman/ ConMan] (under active development in SVN version) === Seismology === [wiki:larry_docu larry]:: a toolkit for performing 2-D, global, surface wave phase velocity tomography [wiki:syn2d_docu Syn2D]:: a synthetic 2-D seismic tomography tool Modules under development :: - [wiki:larry3d_docu larry3d]: a toolkit for performing 3-D, global compressional body wave tomography for the Earth's mantle (full command line functionality, but not merged in SEATREE GUI yet) - [wiki:nonlinloc nonlinloc]: non linear earthquake relocations using [http://alomax.free.fr/nlloc/ NonLinLoc] (initial stages) === Visualization === SEATREE provides access to different ways of visualization computational module output, some modules support more than one way of plotting results. [wiki:gmt_docu GMT]:: many modules use [http://gmt.soest.hawaii.edu GMT] for plotting geographic data (as for [wiki:hc_docu hc] and [wiki:larry_docu larry]), we wrote a simple python interface. [http://matplotlib.sourceforge.net/ MatplotLib]:: Matlab-like output, used for [wiki:syn2d_docu syn2d] and [wiki:conman ConMan] [http://mayavi.sourceforge.net/ MayaVi]:: Interactive 3-D output, in preparation == Contributors == SEATREE is being developed mainly by a [http://geodynamics.usc.edu USC Geodynamics] team since the Fall of 2007 thanks to [http://www.nsf.gov/ NSF] CAREER funding and the additional support of the [http://www.usc.edu/dept/earth/ Department of Earth Sciences] at the [http://www.usc.edu University of Southern California], Los Angeles. === SEATREE design and coding === * Kevin Milner, [http://geodynamics.usc.edu/~becker/ Thorsten Becker], Hannah Waterhouse, and Jared Sain * design advice by Danijel Schorlemmer === Module contributors === Please see the individual module documentation for full references and copyright notices. In particular, * [wiki:larry_docu Larry], larry3D, and [wiki:syn2d_docu Syn2D] source codes were generously contributed by [http://www.sg.geophys.ethz.ch/geodynamics/lapo/ Lapo Boschi]. * [wiki:hc_docu hc] is mainly based on ''advect'' by [http://www.geodynamics.no/STEINBERGER/ Bernhard Steinberger], which was rewritten in C by [http://geodynamics.usc.edu/~becker/ Thorsten Becker] and [http://www.es.mq.edu.au/GEMOC/Participants/AcademManag/CraigOneill/papers.html Craig O'Neill]. * [wiki:nonlinloc nonlinloc] uses [http://alomax.free.fr/nlloc/ Anthony Lomax's] freely available software packages including !NonLinLoc * [wiki:conman conman] uses [http://conman.geos.vt.edu/~sdk/ Scott King's] software !ConMan == Publications and presentations == * Milner, K., Becker, T. W., Boschi, L., Sain, J., Schorlemmer, D. and H. Waterhouse: The Solid Earth Research and Teaching Environment: a new software framework to share research tools in the classroom and across disciplines. Eos Trans. AGU, 90, 12, 2009. [http://geodynamics.usc.edu/~becker/preprints/mbbssw08.pdf PDF] * Waterhouse, H. D., K. Milner, T. W. Becker, J. Sain, and D. Schorlemmer: A Solid Earth Research and Teaching Environment, Opportunities and Challenges in Computational Geophysics workshop, Caltech, 2009. [http://www.geodynamics.org/cig/workinggroups/cs/workshops/future-of-cig09/posters/seatree_scec2008.pdf PDF] * H.D. Waterhouse, K. Milner, and T.W. Becker: SEATREE: An Interactive Visual Environment for Earthquake Science, 2008 SCEC Annual Meeting, 1-007, 2008. == [wiki:bugs Bug reports, feedback, and release history] == A version history can be found [wiki:bugs on the feedback page].