1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
|
\documentclass[pdftex,12pt,a4paper,oneside]{book}
\usepackage[australian]{babel}
\usepackage{graphicx,color}
\usepackage{epsf,verbatim}
\textheight = 257 true mm
\textwidth = 160 true mm
\hoffset = -12 true mm
\voffset = -30 true mm
\usepackage[pdftex,colorlinks,plainpages=false]{hyperref}
%\usepackage[style=list,number=page]{glossary}
%\makeglossary
% \+ permits optional breaking of a word across lines without the
% hyphen.
\newcommand{\+}{\discretionary{}{}{}}
\newcommand{\link}{\htmladdnormallink}
\begin{document} % The beginning of the document.
%\bibliographystyle{amsplain}
\title{ESyS-Particle Tutorial and User's Guide \\ Version 2.3.1}
\author{D. Weatherley, W. Hancock \& V. Boros\\\small{The University of Queensland}
\\ S. Abe \\\small{Institute for Geothermal Resource Management}
}
\date{\today}
\maketitle
\section*{Preface}
This document provides an introduction to Discrete Element Method (DEM) modelling using the ESyS-Particle Simulation Software developed by the \link{Centre for Geoscience Computing}{http://earth.uq.edu.au/centre-geoscience-computing} at \link{The University of Queensland}{http://www.uq.edu.au}. The guide is intended for new users and is written as a step-by-step tutorial on the basic principles and usage of the ESyS-Particle software. Readers are encouraged to obtain \link{a copy of the software}{https://launchpad.net/esys-particle/} and try the examples presented here. Readers are assumed to have had some experience using \link{Python}{http://www.python.org} and to be familiar with the fundamental principles of the DEM. If you have never used Python before, the \link{Python Language Tutorial}{http://docs.python.org/tut/tut.html} is an excellent starting point.
\tableofcontents
\listoffigures
%EXAMPLE FOR MAKING GLOSSARY ENTRIES
%NOAA\glossary{name=NOAA,
%description=National Oceanographic and Atmospheric Administration,format=textbf}
%EXAMPLE FOR CITING PAPERS
%Impact of NTHMP on PTWC~\cite{McCreery2001}
\include{bodytext}
\include{gengeo}
\newpage
\section{Additional ESyS-Particle resources and documentation}
\appendix
\chapter{Code-listings for tutorial examples}\label{code}
\section{ESyS-Particle scripts}
\include{examples/bingle.py}
\include{examples/bingle_output.py}
\include{examples/bingle_chk.py}
\include{examples/bingle_vis.py}
\include{examples/POVsnaps.py}
\include{examples/bingle_Runnable.py}
\include{examples/gravity.py}
\include{examples/gravity_cube.py}
\include{examples/slope_fail.py}
\include{examples/slope_friction.py}
\include{examples/slope_friction_floor.py}
\include{examples/slope_friction_walls.py}
\include{examples/floorMesh.msh}
\include{examples/hopper_flow.py}
\include{examples/rot_compress.py}
\include{examples/WallLoader.py}
\include{examples/shearcell.py}
\include{examples/ServoWallLoader.py}
\section{\texttt{GenGeo} examples}\label{sec:geocode}
\include{examples/simple_box_compact.py}
\include{examples/smooth_box_compact.py}
\include{examples/cluster_box.py}
\chapter[Interaction Groups \& Fields]{Tables of ESyS-Particle Interaction Groups and Field Savers}
\label{tables}
\include{tables/interaction_groups}
\include{tables/field_names}
\chapter{File Formats}
\include{tables/file_formats}
\include{tables/file_format_description}
%\bibliography{paper}
%\printglossary
\end{document} % The end of the document.
|
