Salome HOME
Merge branch 'BR_PORTING_OCCT_7' into pre/V8_3_BR
[modules/hydro.git] / doc / salome / tutorial / english / english_installationLancementSalome.rst
1 ..
2    Copyright (C) 2015-2016 EDF
3
4    This file is part of SALOME HYDRO module.
5
6    SALOME HYDRO module is free software: you can redistribute it and/or modify
7    it under the terms of the GNU General Public License as published by
8    the Free Software Foundation, either version 3 of the License, or
9    (at your option) any later version.
10
11    SALOME HYDRO module is distributed in the hope that it will be useful,
12    but WITHOUT ANY WARRANTY; without even the implied warranty of
13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14    GNU General Public License for more details.
15
16    You should have received a copy of the GNU General Public License
17    along with SALOME HYDRO module.  If not, see <http://www.gnu.org/licenses/>.
18
19
20 ##########################################
21 SALOME installation and start-up procedure 
22 ##########################################
23
24 .. |fit_all| image:: /../_static/fitall.png
25    :align: middle
26
27 Installation
28 ============
29
30  * Open an account (e.g.: I88928)
31
32  * Open a web browser (blue button at the top right or Applications/Internet/Navigation Web Iceweasel) 
33
34  * Type the address: https://salome.der.edf.fr/ 
35
36  * Look for the latest version of SALOME_HYDRO in the folder:  Downloads (Téléchargements)
37
38  * Extract the *xxx*.run file
39
40  * Save (the file is automatically saved in /Downloads (Téléchargements)) 
41
42  * Open a terminal (at the top of the screen:  Accessories  (Accessoires)/Terminal) 
43
44  * Type cd Téléchargements (Downloads) 
45
46  * Type ls: you should see the *xxx*.run 
47
48  * (if necessary, make it executable: chmod +x *xxx*.run) 
49
50  * Start the installation by typing ./*xxx*.run 
51
52  * Answer the installation questions (directory: of your choice; **language: must be English**;
53    for all remaining questions:  yes by default) 
54
55 Salome-Hydro is now installed and appears as an icon on the desktop.
56 The icon can be dragged and dropped into an open editor (gedit or equivalent)
57 to replace the *Terminal=false* line by *Terminal=true*.
58 This provides an execution trace, facilitating the diagnosis of certain application problems.
59 It is not a compulsory step. 
60
61 The installation is in English because the translation into French is incomplete.
62
63 Starting SALOME
64 ===============
65  
66 Double-click the SALOME icon on the desktop, or, knowing the installation folder of SALOME ( *<appli_XXX>* ),
67 in a terminal ::
68
69   <appli_XXX>/salome
70
71 It is possible to get execution log in case of problem, in the terminal.  
72
73 * **Note** : the *salome* command accepts options.
74   For instance, -k option closes all previous SALOME instances and releases all associated resources.
75   To get help, use -h option ::
76
77   <appli_XXX>/salome -h
78
79 View handling in SALOME
80 =======================
81
82 For those users unfamiliar with SALOME, the following paragraphs describe the main 2D and 3D view-handling commands, as well as techniques to select and display objects in the study tree (Object Browser).
83  
84 Display data in the view window:
85 --------------------------------
86
87 By clicking the eye icon next to the object in the Object Browser window. 
88
89 By right clicking on the object in the tree on the left (in the Object Browser window),
90 which brings up a list of options::
91
92   /show/ show only / hide / hide only / hide all / 
93
94 Zoom
95 ----
96
97 Ctrl + left click 
98
99 The zoom is centred by default. Activation of zoom using the scroll (mouse) wheel: 
100 to enable use of the scroll wheel to control the zoom, this option must be activated:
101 file /preferences (select the SALOME module) /3D viewer /zooming style /relative to the cursor.
102 A zoom relative to the cursor pans in to the area around the cursor position
103 while a centred zoom pans out to takes account of the whole zone.
104  
105 To zoom in on a data item in the tree: 
106
107 Select the item from the tree. In the toolbar at the top of the window, 
108 select the Fit All button 
109
110 Rotation
111 --------
112
113 Ctrl + right click 
114
115 Translation (horizontal/vertical movements)
116 -------------------------------------------
117
118 Ctrl + mouse wheel
119
120 Viewers
121 -------
122
123 SALOME proposes several viewers:
124  
125 VTK for the 3D views (MESH module) and OCC for the 2D views (for the geometry).
126 These can be found via tabs that appear on the screen.
127
128 The different elements of the study are not all displayed equally well in all the viewers!
129