ViewVC Help
View File | Revision Log | Show Annotations | View Changeset | Root Listing
root/REPOS_ERICCA/magic/app/magic_application/src/aide.h
Revision: 864
Committed: Fri Jan 6 16:55:57 2017 UTC (8 years, 4 months ago) by francois
Content type: text/plain
File size: 17748 byte(s)
Log Message:
Mise a jour documentation et aide

File Contents

# User Rev Content
1 francois 737 /*! \page Aide Aide MAGiC
2     Configuration de MAGiC
3    
4     - \subpage Configuration
5    
6    
7     Description du format du fichier script MAGiC\n
8     - \subpage Script
9 francois 864
10     Description de la procédure de reconstruction d'un nmodèle structurel après optimisation topologique\n
11     - \subpage Reconstruction
12 francois 737 */
13    
14     //-----------------------------------------------------------
15    
16    
17     /*! \page Script Description du contenu du fichier script
18     Un fichier script est composé de commandes exécutées en séquences depuis le début du fichier jusqu'à la fin.\n
19     Toute ligne commence par une variable suivie d'un espace suivi d'un signe egal suivi d'un espace et suivi de la commande et de ses arguments.\n
20     Si le premier caractère de la ligne est le caractère # alors la ligne est ignorée.\n\n
21     Les commandes disponibles dans le script MAGiC:
22 couturad 740 - \subpage ajoutass
23 francois 737 - \subpage creearbre
24 couturad 740 - \subpage creeassemblage
25 francois 737 - \subpage diff
26     - \subpage enregistrer
27     - \subpage evalarbre
28 couturad 740 - \subpage evalassemblage
29 francois 737 - \subpage export_mg_gmsh
30     - \subpage export_fem_gmsh
31     - \subpage fichier
32     - \subpage importstepocc
33     - \subpage inter
34     - \subpage p_cylindre
35     - \subpage p_cone
36     - \subpage p_boite
37     - \subpage p_sphere
38     - \subpage p_tore
39     - \subpage union
40     */
41    
42     //-----------------------------------------------------------
43    
44     /*! \page Configuration Configuration de MAGiC
45     Dans chaque compte utilisateur ou MAGiC est utilisé un fichier .magic dans le home directory permet de regler quelques parametres de l'application :\n\n
46     Affiche_Code_Aster = 0.000000 //0. Affichage redirigé vers le fichier aster.log 1 affichage dans un terminal\n
47     Convergence_mailleur3d_frontal = 200.000000 //Nombre de front restant à partir duquel la destruction est obligatoire\n
48     Echantillon_face = 20.000000 //Nombre d'échantillon pour le calcul de la boite englobante des faces\n
49     Verification_coin_face_mailleur2D = 0.000000 //0. Ne fais pas la vérification 1. Fait la vérification qu'un sommet de face partage au moins deux triangles\n
50     Optimisation_2D = 1 //Nombre de bits = nombre de passe d'optimisation. Pour chaque bit 1=bouge de noeud 2=inverse diagonale 3=bouge de noeud inserse diagonale simultane 4=inverse diagonale bouge de noeud simulatane\n
51     */
52    
53 francois 864
54 francois 737 //-----------------------------------------------------------
55 francois 864
56     /*! \page Reconstruction Description de la procédure de reconstruction d'un nmodèle structurel après optimisation topologique
57    
58     Description de la reconstruction
59    
60     - \subpage Description_reconstruction
61    
62     Commandes de la reconstruction
63    
64     - \subpage Commande_reconstruction
65    
66     */
67    
68     //-----------------------------------------------------------
69     /*! \page Description_reconstruction Description de la reconstruction
70     La squelettisation consiste à extraire le squelette d’un modèle. Le modèle est supposé structurel, c’est-à-dire contenant des éléments de type poutre. Pour utiliser l’algorithme de squelettisation, l’on a besoin de 2 fichiers .magic et 2 fichiers .txt. Il s’agit du fichier résultant de l’optimisation topologique, du fichier obtenu après lissage (partie de non_design exclue), et les 2 fichiers .txt provenant de MatLab et contenant les coordonnées des points du squelette et les connectivités entre les points de la courbe-squelette.
71     L’étape 5 ci-dessus résulte en 6 fichiers qui sont : 3 fichiers de squelette (en .magic) et 3 fichiers de solutions (en .sol) sur le calcul des sections.\n\n\n
72     <B>nomfichier_squelette1.magic</B> est le fichier contenant la courbe-squelette sous forme de ligne. Il est accompagné du fichier Carte_section1.sol qui est le fichier de solution pour la taille des sections en mètre (m).\n\n\n
73     <B>nomfichier_squelette2.magic</B> est le fichier contenant le squelette après transformation des segments de chaque branche de la courbe squelette en poutre droite. Il est lui aussi accompagné du fichier Carte_section2.sol qui est le fichier de solution pour la taille des sections des poutres droites en mètre (m). Ce squelette est connecté au non_design à l’aide des segments.\n\n\n
74     <B>nomfichier_squelette3.magic</B> le fichier final de travail. C’est ce fichier qui est utilisé dans la suite pour les calculs. Ce dernier fichier contient le squelette sous forme de poutres droites, est connecté directement au non_design à l’aide des mini-poutres et contient les conditions aux limites et de chargement. Il est accompagné du fichier Carte_section3.sol qui est le fichier de solution pour la taille des sections en mètre (m).
75     */
76    
77     //-----------------------------------------------------------
78     /*! \page Commande_reconstruction Commandes de la reconstruction
79    
80     <span style="text-decoration: underline;"><B>Etape 1 :</B> </span> Optimisation topologique\n <i>topo_optis.exe
81     -optimise -design nom_fichier.magic -nondesign nom_fichier_bloc.magic -out nom_fichier_resu.magic -param nom_fichier_param.txt -paramaster aster.txt</i>\n\n
82     Si on a déjà un résultat optimal on peut directement passer à l'étape 2.
83     <BR><BR>
84    
85     <span style="text-decoration: underline;"><B>Etape 2 :</B> </span> Lissage du résultat optimal (sans la partie de non_design) \n
86     <i>post_optis.exe -creepeau -in nom_fichier_resu.magic -out nom_fichier_lisse.magic -param paramliss.txt</i>\n\n
87     Dans le fichier paramliss, mettre à 1 le paramètre rmimpose_debut pour supprimer le non_design et donner un nom de fichier pour le résultat de la peau sans non_design avec le paramètre nomfichpeau.
88     <BR><BR>
89    
90    
91     <span style="text-decoration: underline;"><B>Etape 3</B> </span> : Transformation en .off \n
92     <i>mgoperation.exe -offout -in nom_fichier_lisse_peau.magic</i>\n\n
93     (Utiliser le fichier de la peau qui ne contient pas le non_design)
94     <BR><BR>
95    
96    
97     <span style="text-decoration: underline;"><B>Etape 4 </B> </span> : Squelettisation sous MatLab\n
98    
99     Partie 1 : génération du squelette\n
100     Mettre le fichier .off précédent dans le dossier « data » et aller dans le logiciel MatLab. Choisir le chemin vers le dossier « matlab » qui est dans le même répertoire que « data »\n
101     Ouvrir eg_skeleton_laplacian_rosa.m\n
102     Mettre le nom (sans son extension) du fichier .off obtenu à l’Étape 3 dans eg_skeleton_laplacian_rosa.m à la ligne 16.\n
103     executer eg_skeleton_laplacian_rosa.m\n
104     Des figures (en particulier la figure 4) sont générées.\n\n
105    
106     Partie 2 : extraction des données\n
107     Ouvrir maintenant Entxt.m qui est également dans le dossier « matlab »\n
108     Donner les noms de fichier désirés dans Entxt.m aux lignes 4, 5 et 33, 34.\n
109     executer Entxt.m \n
110     2 fichiers, contenant les coordonnées des points et les connectivités, sont générés dans le dossier « matlab » ; ce sont ces fichiers qui sont utilisés par la suite dans MAGiC.\n
111     <BR><BR>
112    
113    
114     <span style="text-decoration: underline;"><B>Etape 5 :</B> </span> Exportation du squelette dans MAGiC\n
115     <i>skeleton.exe -construire_squelette -in nom_fichier_resu.magic -out nom_fichier -inpoints nom_fichier_points.txt -incorres nom_fichier_corres.txt -infilelisse nom_fichier_lisse.magic –connecte 1 –param_lissage paramliss.txt</i>\n\n
116    
117    
118     Pour obtenir une liste des paramètres pour d’éventuelles modifications, faire simplement :\n
119     <i>skeleton.exe -construire_squelette </i>\n
120    
121     –connecte 1 : permet d’introduire des mini-poutres dans toute la zone (les triangles) de contact entre les tétraèdres optimisés et de non_design\n
122    
123     –connecte 0 : permet d’introduire des mini-poutres uniquement au nœud de jonction entre le squelette et le non_design\n\n
124    
125     Le résultat à utiliser pour la suite est le nom_fichier_squelette3.magic
126     <BR><BR>
127    
128     <span style="text-decoration: underline;"><B>Etape 6 :</B> </span> Lancer le calcul EF \n
129     <i>mgoperation.exe -calculaster -in nom_fichier_squelette3.magic -out nom_fichier_sortie -param aster.txt -elastique</i>\n
130     */
131    
132     //-----------------------------------------------------------
133 francois 737 /*! \page fichier fichier
134     var = fichier nom
135     @brief Mise en mémoire d'un gestionnaire MAGiC
136     @param nom une chaine de caractére.
137     @return var une variable representant le gestionnaire MAGiC
138     @details Si nom = nouveau il y a création d'un nouveau modèle MAGiC\n
139     @details Sinon ouverture du fichier MAGiC donné par nom\n
140     */
141    
142     //-----------------------------------------------------------
143    
144     /*! \page p_boite p_boite
145     var = p_boite arbre x1 y1 z1 x2 y2 z2
146     @brief Création d'une primitive solide de forme boite entre les points (x1,y1,z1) et (x2,y2,z2)
147     @param arbre une variable représentant un arbre caractéristique.
148     @param x1 un double.
149     @param y1 un double.
150     @param z1 un double.
151     @param x2 un double.
152     @param y2 un double.
153     @param z2 un double.
154     @return var une variable representant une primitive solide
155     */
156    
157     //-----------------------------------------------------------
158    
159     /*! \page p_sphere p_sphere
160     var = p_sphere arbre x1 y1 z1 r
161     @brief Création d'une primitive solide de forme spherique de centre (x1,y1,z1) et de rayon r
162     @param arbre une variable représentant un arbre caractéristique.
163     @param x1 un double.
164     @param y1 un double.
165     @param z1 un double.
166     @param r un double.
167     @return var une variable representant une primitive solide
168     */
169    
170     //-----------------------------------------------------------
171    
172     /*! \page p_cylindre p_cylindre
173     var = p_cylindre arbre x1 y1 z1 lat lon h r
174     @brief Création d'une primitive solide de forme cylindrique basée sur le cercle centré en (x1,y1,z1) orienté selon les angles lat et lon pour latitute et longitude de hauteur h et de rayon r
175     @param arbre une variable représentant un arbre caractéristique.
176     @param x1 un double.
177     @param y1 un double.
178     @param z1 un double.
179     @param lat un double.
180     @param lon un double.
181     @param h un double.
182     @param r un double.
183     @return var une variable representant une primitive solide
184     */
185    
186     //-----------------------------------------------------------
187    
188     /*! \page p_tore p_tore
189     var = p_tore arbre x1 y1 z1 lat lon R r
190     @brief Création d'une primitive solide de forme torique basée sur le cercle centré en (x1,y1,z1) orienté selon les angles lat et lon pour latitute et longitude de grand rayon R et de petit rayon r
191     @param arbre une variable représentant un arbre caractéristique.
192     @param x1 un double.
193     @param y1 un double.
194     @param z1 un double.
195     @param lat un double.
196     @param lon un double.
197     @param h un double.
198     @param r un double.
199     @return var une variable representant une primitive solide
200     */
201    
202     //-----------------------------------------------------------
203    
204     /*! \page p_cone p_cone
205     var = p_cone arbre x1 y1 z1 lat lon h r
206     @brief Création d'une primitive solide de forme conqiue basée sur le cercle centré en (x1,y1,z1) orienté selon les angles lat et lon pour latitute et longitude de hauteur h et de petit rayon r
207     @param arbre une variable représentant un arbre caractéristique.
208     @param x1 un double.
209     @param y1 un double.
210     @param z1 un double.
211     @param lat un double.
212     @param lon un double.
213     @param h un double.
214     @param r un double.
215     @return var une variable representant une primitive solide
216     */
217 couturad 740 //-----------------------------------------------------------
218 francois 737
219 couturad 740 /*! \page ajoutass ajoutass
220     var = ajoutass arbre prim
221     @brief Ajoute une primitive dans un arbre
222     @param arbre une variable représentant un arbre caractéristique.
223     @param prim une variable représentant une primitive
224     @return var une variable inutilisable
225     */
226 francois 737 //-----------------------------------------------------------
227     /*! \page union union
228     var = union arbre p1 p2 nom_semantique
229     @brief Création d'une opération booléene d'union entre deux primitives
230     @param arbre une variable représentant un arbre caractéristique.
231     @param p1 une primitive.
232     @param p2 une primitive.
233     @param nom_semantique OPTIONNEL nom pour donner un sens physique à l'opération. Les choix sont : chamfrein, conge, intersection, percage, soustraction, union, extrusion
234     @return var une variable representant une primitive
235     @details Si aucun nom de sémantique n'est donné le qualificatif SANS est attribué
236     */
237     //-----------------------------------------------------------
238     /*! \page diff diff
239     var = diff arbre p1 p2 nom_semantique
240     @brief Création d'une opération booléene de soustraction entre deux primitives
241     @param arbre une variable représentant un arbre caractéristique.
242     @param p1 une primitive.
243     @param p2 une primitive.
244     @param nom_semantique OPTIONNEL nom pour donner un sens physique à l'opération. Les choix sont : chamfrein, conge, intersection, percage, soustraction, union, extrusion
245     @return var une variable representant une primitive
246     @details Si aucun nom de sémantique n'est donné le qualificatif SANS est attribué
247     */
248     //-----------------------------------------------------------
249     /*! \page inter inter
250     var = union arbre p1 p2 nom_semantique
251     @brief Création d'une opération booléene d'intersection entre deux primitives
252     @param arbre une variable représentant un arbre caractéristique.
253     @param p1 une primitive.
254     @param p2 une primitive.
255     @param nom_semantique OPTIONNEL nom pour donner un sens physique à l'opération. Les choix sont : chamfrein, conge, intersection, percage, soustraction, union, extrusion
256     @return var une variable representant une primitive
257     @details Si aucun nom de sémantique n'est donné le qualificatif SANS est attribué
258     */
259     //-----------------------------------------------------------
260    
261     /*! \page creearbre creearbre
262     var = creearbre gest nom
263     @brief Création d'un arbre caractéristique
264     @param gest une variable représentant un modèle MAGiC
265     @param nom une chaine de caractère. Ce nom n'est pas utilisé par la suite
266     @return var une variable representant un arbre caractéristique
267     */
268    
269     //-----------------------------------------------------------
270 couturad 740
271     /*! \page creeassemblage creeassemblage
272     var = creeassemblage arbre nom
273     @brief Création d'un assemblage dans un arbre caractéristique
274     @param arbre une variable représentant un arbre caractéristique
275     @param nom une chaine de caractère. Ce nom n'est pas utilisé par la suite
276     @return var une variable representant un assemblage
277     */
278    
279     //-----------------------------------------------------------
280 francois 737 /*! \page evalarbre evalarbre
281     var = evalarbre arbre nom avecstep avecstl eps eps2
282 francois 741 @brief Evaluation du modèle BREP à partir de la derniere primitive d'un arbre caractéristique
283 francois 737 @param arbre une variable représentant un arbre caractéristique
284     @param nom une string représentant un nom de fichier pour enregistrer le fichier opencascade sur le disque (L'extension s'ajoute automatiquement au nom du fichier)
285     @param avecstep un boolean qui permet une version du fichier BREP en STEP
286     @param avecstl un boolean qui permet la création d'une triangulation associée aux entitées BREP crées
287     @param eps OPTIONNEL un double pour la précison de opencascade dans la fermeture des entitées BREP - Defaut = 1e-6.
288     @param eps2 OPTIONNEL un double pour la distance entre la triangulation et la géométrie - Defaut = 1.
289     @return var une variable representant une geometrie
290     */
291    
292     //-----------------------------------------------------------
293 couturad 740 /*! \page evalassemblage evalassemblage
294 francois 747 var = evalassemblage arbre assemb nom avecfusion avecstep avecstl eps eps2
295 couturad 740 @brief Evaluation du modèle BREP à partir d'un assemblage
296     @param arbre une variable représentant un arbre caractéristique
297     @param assemb une variable représentant un assemblage
298     @param nom une string représentant un nom de fichier pour enregistrer le fichier opencascade sur le disque (L'extension s'ajoute automatiquement au nom du fichier)
299 francois 747 @param avecfusion un boolean qui permet de fusionner les entites communes a deux volumes avec l'apparaition des cofaces
300 couturad 740 @param avecstep un boolean qui permet une version du fichier BREP en STEP
301     @param avecstl un boolean qui permet la création d'une triangulation associée aux entitées BREP crées
302     @param eps OPTIONNEL un double pour la précison de opencascade dans la fermeture des entitées BREP - Defaut = 1e-6.
303     @param eps2 OPTIONNEL un double pour la distance entre la triangulation et la géométrie - Defaut = 1.
304     @return var une variable representant une geometrie
305     */
306    
307     //-----------------------------------------------------------
308 francois 737 /*! \page enregistrer enregistrer
309     var = enregistrer gest nom
310     @brief Sauvegarde d'un fichier MAGiC
311     @param gest une variable représentant un gestionnaire MAGiC
312     @param nom une string représentant un nom de fichier (L'extension s'ajoute automatiquement au nom du fichier).
313     @return var une variable inutilisable
314     */
315    
316     //-----------------------------------------------------------
317     /*! \page export_mg_gmsh export_mg_gmsh
318     var = export_mg_gmsh gest nom num
319     @brief Exportation d'un MG_MAILLAGE MAGiC en format GMSH
320     @param gest une variable représentant un gestionnaire MAGiC
321     @param nom une string représentant un nom de fichier gmsh (L'extension s'ajoute automatiquement au nom du fichier).
322     @param num un integer qui représente un numero sequantielle de maillage (entre 1 et n)
323     @return var une variable inutilisable
324     */
325    
326     //-----------------------------------------------------------
327     /*! \page export_fem_gmsh export_fem_gmsh
328     var = export_fem_gmsh gest nom num
329     @brief Exportation d'un FEM_MAILLAGE MAGiC en format GMSH
330     @param gest une variable représentant un gestionnaire MAGiC
331     @param nom une string représentant un nom de fichier gmsh (L'extension s'ajoute automatiquement au nom du fichier).
332     @param num un integer qui représente un numero sequantielle de maillage (entre 1 et n)
333     @return var une variable inutilisable
334     */
335     //-----------------------------------------------------------
336     /*! \page importstepocc importstepocc
337     var = importstepocc gest nom eps
338     @brief importation d'un fichier STEP en MAGiC via opencascade
339     @param gest une variable représentant un gestionnaire MAGiC
340     @param nom une string représentant le nom de fichier STEP.
341     @param eps OPTIONNEL un double pour la précison de opencascade dans la fermeture des entitées BREP - Defaut = 1e-6.
342     @return var une variable de type geometrie
343     */