magic_application/src/aide.h

/*! \page Aide Aide MAGiC
Informations diverses

- \subpage infodiv

Configuration de MAGiC

- \subpage Configuration 


Description du format du fichier script MAGiC\n
- \subpage  Script

Description de la procédure de reconstruction d'un nmodèle structurel après optimisation topologique\n
- \subpage  Reconstruction
*/
//-----------------------------------------------------------


/*! \page infodiv Informations diverses sur le projet MAGiC
Le projet MAGiC est un projet des professeurs Jean-Christophe Cuillière et Vincent Francois de l'Équipe de Recherche en Intégration CAO-CAlcul du département de génie mécanique de l'UQTR.\n\n
Cette page résume les différents liens pour les outils disponibles : \n\n
<ul>
<li><a href="http://ericca.uqtr.ca/websvn"> WebSVN </a></li>
<li><a href="http://ericca.uqtr.ca/biblio"> Biblio ERICCA </a></li>
<li><a href="http://ericca.uqtr.ca/cas_test"> Cas test d'optimisation de topologie </a></li>
<li><a href="http://ericca.uqtr.ca/webmagic/index_text.html"> Tests journaliers du code </a></li>

<li>Documentation de Code ASTER</li>
<ul>
<li><a href="http://ericca.uqtr.ca/fr11.7"> 11.7 </a></li>
<li><a href="http://ericca.uqtr.ca/fr12.4"> 12.4 </a></li>
</ul>
<li>Script d'installation de l'environnement ERICCA : Downloader les deux fichiers suivants et faire ./instal_magic,bash Version_Aster [tout]. L'option installe les outils de développements. Il faut s'assurer que les scripts soient exécutables.</li>
<ul>
<li><a href="http://ericca.uqtr.ca/linux/instal_magic.bash"> Script d'installation de MAGiC </a></li>
<li><a href="http://ericca.uqtr.ca/linux/instal_aster.bash"> Script d'installation de code ASTER</a></li>

</ul>

</ul>


*/

//-----------------------------------------------------------
//-----------------------------------------------------------


/*! \page Script Description du contenu du fichier script
Un fichier script est composé de commandes exécutées en séquences depuis le début du fichier jusqu'à la fin.\n
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
Si le premier caractère de la ligne est le caractère # alors la ligne est ignorée.\n\n
Les commandes disponibles dans le script MAGiC:
- \subpage ajoutass
- \subpage creearbre
- \subpage creeassemblage
- \subpage diff 
- \subpage enregistrer
- \subpage evalarbre
- \subpage evalassemblage
- \subpage export_mg_gmsh
- \subpage export_fem_gmsh
- \subpage fichier
- \subpage importstepocc
- \subpage inter 
- \subpage p_cylindre 
- \subpage p_cone 
- \subpage p_boite 
- \subpage p_sphere 
- \subpage p_tore 
- \subpage union 
*/

//-----------------------------------------------------------

/*! \page Configuration Configuration de MAGiC
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
Affiche_Code_Aster = 0.000000       //0. Affichage redirigé vers le fichier aster.log 1 affichage dans un terminal\n
Convergence_mailleur3d_frontal = 200.000000       //Nombre de front restant à partir duquel la destruction est obligatoire\n
Echantillon_face = 20.000000       //Nombre d'échantillon pour le calcul de la boite englobante des faces\n
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
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
Quadratisation_jmin = 1.000000       //Garantir des tetras quadratiques avec  jaconien minimum positif : 1=oui 2=non
Quadratisation_pas = 100.       //Nombre de pas pour recaler les noeuds et obtenir un jmin positif
Quadratisation_dis = 0.100000       //Valeur de la distortion du jacobien minimale à atteindre
Separateur_decimale = ,       //Seprateur décimale pour l'exportation des fichiers excel
*/


//-----------------------------------------------------------

/*! \page Reconstruction Description de la procédure de reconstruction d'un nmodèle structurel après optimisation topologique

Description de la reconstruction

- \subpage Description_reconstruction

Commandes de la reconstruction

- \subpage Commande_reconstruction

*/

//-----------------------------------------------------------
/*! \page Description_reconstruction Description de la reconstruction
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.
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
<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
<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
<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).
*/

//-----------------------------------------------------------
/*! \page  Commande_reconstruction Commandes de la reconstruction

<span style="text-decoration: underline;"><B>Etape 1 :</B> </span> Optimisation topologique\n <i>topo_optis.exe
-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
Si on a déjà un résultat optimal on peut directement passer à l'étape 2.
<BR><BR>

<span style="text-decoration: underline;"><B>Etape 2 :</B> </span> Lissage du résultat optimal (sans la partie de non_design) \n
<i>post_optis.exe -creepeau -in nom_fichier_resu.magic -out nom_fichier_lisse.magic  -param paramliss.txt</i>\n\n
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.
<BR><BR>


<span style="text-decoration: underline;"><B>Etape 3</B> </span> : Transformation en .off \n
<i>mgoperation.exe -offout -in nom_fichier_lisse_peau.magic</i>\n\n
(Utiliser le fichier de la peau qui ne contient pas le non_design)
<BR><BR>


<span style="text-decoration: underline;"><B>Etape 4 </B> </span> : Squelettisation sous MatLab\n

Partie 1 : génération du squelette\n
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
Ouvrir eg_skeleton_laplacian_rosa.m\n
Mettre le nom (sans son extension) du fichier .off obtenu à l’Étape 3 dans eg_skeleton_laplacian_rosa.m à la ligne 16.\n
executer eg_skeleton_laplacian_rosa.m\n
Des figures (en particulier la figure 4) sont générées.\n\n

Partie 2 : extraction des données\n
Ouvrir maintenant Entxt.m qui est également dans le dossier « matlab »\n
Donner les noms de fichier désirés dans Entxt.m aux lignes 4, 5 et 33, 34.\n
executer Entxt.m \n
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
<BR><BR>


<span style="text-decoration: underline;"><B>Etape 5 :</B> </span> Exportation du squelette dans MAGiC\n 
<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


Pour obtenir une liste des paramètres pour d’éventuelles modifications, faire simplement :\n
<i>skeleton.exe -construire_squelette </i>\n

–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

–connecte 0 : permet d’introduire des mini-poutres uniquement au nœud de jonction entre le squelette et le non_design\n\n

Le résultat à utiliser pour la suite est le nom_fichier_squelette3.magic
<BR><BR>

<span style="text-decoration: underline;"><B>Etape 6 :</B> </span>  Lancer le calcul EF \n
<i>mgoperation.exe -calculaster -in nom_fichier_squelette3.magic -out nom_fichier_sortie -param aster.txt -elastique</i>\n
*/

//-----------------------------------------------------------
/*! \page fichier fichier
var = fichier nom 
@brief Mise en mémoire d'un gestionnaire MAGiC
@param nom une chaine de caractére.
@return var une variable representant le gestionnaire MAGiC
@details Si nom = nouveau il y a création d'un nouveau modèle MAGiC\n
@details Sinon ouverture du fichier MAGiC donné par nom\n
*/

//-----------------------------------------------------------

/*! \page p_boite p_boite
var = p_boite arbre x1 y1 z1 x2 y2 z2
@brief Création d'une primitive solide de forme boite entre les points (x1,y1,z1) et (x2,y2,z2)
@param arbre une variable représentant un arbre caractéristique.
@param x1 un double.
@param y1 un double.
@param z1 un double.
@param x2 un double.
@param y2 un double.
@param z2 un double.
@return var une variable representant une primitive solide
*/

//-----------------------------------------------------------

/*! \page p_sphere p_sphere
var = p_sphere arbre x1 y1 z1 r
@brief Création d'une primitive solide de forme spherique de centre (x1,y1,z1) et de rayon r
@param arbre une variable représentant un arbre caractéristique.
@param x1 un double.
@param y1 un double.
@param z1 un double.
@param r un double.
@return var une variable representant une primitive solide
*/

//-----------------------------------------------------------

/*! \page p_cylindre p_cylindre
var = p_cylindre arbre x1 y1 z1 lat lon h r  
@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
@param arbre une variable représentant un arbre caractéristique.
@param x1 un double.
@param y1 un double.
@param z1 un double.
@param lat un double.
@param lon un double.
@param h un double.
@param r un double.
@return var une variable representant une primitive solide
*/

//-----------------------------------------------------------

/*! \page p_tore p_tore
var = p_tore arbre x1 y1 z1 lat lon R r  
@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
@param arbre une variable représentant un arbre caractéristique.
@param x1 un double.
@param y1 un double.
@param z1 un double.
@param lat un double.
@param lon un double.
@param h un double.
@param r un double.
@return var une variable representant une primitive solide
*/

//-----------------------------------------------------------

/*! \page p_cone p_cone
var = p_cone arbre x1 y1 z1 lat lon h r  
@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
@param arbre une variable représentant un arbre caractéristique.
@param x1 un double.
@param y1 un double.
@param z1 un double.
@param lat un double.
@param lon un double.
@param h un double.
@param r un double.
@return var une variable representant une primitive solide
*/
//-----------------------------------------------------------

/*! \page ajoutass ajoutass
var = ajoutass arbre prim  
@brief Ajoute une primitive dans un arbre
@param arbre une variable représentant un arbre caractéristique.
@param prim une variable représentant une primitive
@return var une variable inutilisable
*/
//-----------------------------------------------------------
/*! \page union union
var = union arbre p1 p2 nom_semantique
@brief Création d'une opération booléene d'union entre deux primitives
@param arbre une variable représentant un arbre caractéristique.
@param p1 une primitive.
@param p2 une primitive.
@param nom_semantique OPTIONNEL nom pour donner un sens physique à l'opération. Les choix sont : chamfrein, conge, intersection, percage, soustraction, union, extrusion
@return var une variable representant une primitive
@details Si aucun nom de sémantique n'est donné le qualificatif SANS est attribué
*/
//-----------------------------------------------------------
/*! \page diff diff
var = diff arbre p1 p2 nom_semantique
@brief Création d'une opération booléene de soustraction entre deux primitives
@param arbre une variable représentant un arbre caractéristique.
@param p1 une primitive.
@param p2 une primitive.
@param nom_semantique OPTIONNEL nom pour donner un sens physique à l'opération. Les choix sont : chamfrein, conge, intersection, percage, soustraction, union, extrusion
@return var une variable representant une primitive
@details Si aucun nom de sémantique n'est donné le qualificatif SANS est attribué
*/
//-----------------------------------------------------------
/*! \page inter inter
var = union arbre p1 p2 nom_semantique
@brief Création d'une opération booléene d'intersection entre deux primitives
@param arbre une variable représentant un arbre caractéristique.
@param p1 une primitive.
@param p2 une primitive.
@param nom_semantique OPTIONNEL nom pour donner un sens physique à l'opération. Les choix sont : chamfrein, conge, intersection, percage, soustraction, union, extrusion
@return var une variable representant une primitive
@details Si aucun nom de sémantique n'est donné le qualificatif SANS est attribué
*/
//-----------------------------------------------------------

/*! \page creearbre creearbre
var = creearbre gest nom
@brief Création d'un arbre caractéristique
@param gest une variable représentant un modèle MAGiC
@param nom une chaine de caractère. Ce nom n'est pas utilisé par la suite
@return var une variable representant un arbre caractéristique
*/

//-----------------------------------------------------------

/*! \page creeassemblage creeassemblage
var = creeassemblage arbre nom
@brief Création d'un assemblage dans un arbre caractéristique
@param arbre une variable représentant un arbre caractéristique
@param nom une chaine de caractère. Ce nom n'est pas utilisé par la suite
@return var une variable representant un assemblage
*/

//-----------------------------------------------------------
/*! \page evalarbre evalarbre
var = evalarbre arbre nom avecstep avecstl eps eps2
@brief Evaluation du modèle BREP à partir de la derniere primitive d'un arbre caractéristique
@param arbre une variable représentant un arbre caractéristique
@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)
@param avecstep un boolean qui permet une version du fichier BREP en STEP
@param avecstl un boolean qui permet la création d'une triangulation associée aux entitées BREP crées
@param eps OPTIONNEL un double pour la précison de opencascade dans la fermeture des entitées BREP - Defaut = 1e-6.
@param eps2 OPTIONNEL un double pour la distance entre la triangulation et la géométrie  - Defaut = 1.
@return var une variable representant une geometrie
*/

//-----------------------------------------------------------
/*! \page evalassemblage evalassemblage
var = evalassemblage arbre assemb nom avecfusion avecstep avecstl eps eps2
@brief Evaluation du modèle BREP à partir d'un assemblage
@param arbre une variable représentant un arbre caractéristique
@param assemb une variable représentant un assemblage
@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)
@param avecfusion un boolean qui permet de fusionner les entites communes a deux volumes avec l'apparaition des cofaces
@param avecstep un boolean qui permet une version du fichier BREP en STEP
@param avecstl un boolean qui permet la création d'une triangulation associée aux entitées BREP crées
@param eps OPTIONNEL un double pour la précison de opencascade dans la fermeture des entitées BREP - Defaut = 1e-6.
@param eps2 OPTIONNEL un double pour la distance entre la triangulation et la géométrie  - Defaut = 1.
@return var une variable representant une geometrie
*/

//-----------------------------------------------------------
/*! \page enregistrer enregistrer
var = enregistrer gest nom
@brief Sauvegarde d'un fichier MAGiC
@param gest une variable représentant un gestionnaire MAGiC
@param nom une string représentant un nom de fichier (L'extension s'ajoute automatiquement au nom du fichier).
@return var une variable inutilisable
*/

//-----------------------------------------------------------
/*! \page export_mg_gmsh export_mg_gmsh
var = export_mg_gmsh gest nom num
@brief Exportation d'un MG_MAILLAGE MAGiC en format GMSH
@param gest une variable représentant un gestionnaire MAGiC
@param nom une string représentant un nom de fichier gmsh (L'extension s'ajoute automatiquement au nom du fichier).
@param num un integer qui représente un numero sequantielle de maillage (entre 1 et n)
@return var une variable inutilisable
*/

//-----------------------------------------------------------
/*! \page export_fem_gmsh export_fem_gmsh
var = export_fem_gmsh gest nom num
@brief Exportation d'un FEM_MAILLAGE MAGiC en format GMSH
@param gest une variable représentant un gestionnaire MAGiC
@param nom une string représentant un nom de fichier gmsh (L'extension s'ajoute automatiquement au nom du fichier).
@param num un integer qui représente un numero sequantielle de maillage (entre 1 et n)
@return var une variable inutilisable
*/
//-----------------------------------------------------------
/*! \page importstepocc importstepocc
var = importstepocc gest nom eps
@brief importation d'un fichier STEP en MAGiC via opencascade
@param gest une variable représentant un gestionnaire MAGiC
@param nom une string représentant le nom de fichier STEP.
@param eps OPTIONNEL un double pour la précison de opencascade dans la fermeture des entitées BREP - Defaut = 1e-6.
@return var une variable de type geometrie
*/
Revision:	883
Committed:	Thu Apr 20 13:38:18 2017 UTC (8 years ago) by francois
Content type:	text/plain
File size:	19632 byte(s)
Log Message:	Creation d'un mailleur FEM pour pouvoir avoir des stratégies paramétrées de maillage. L'ancienne méthode construit disparait et est remplacée par l'utilisation d'un MAILLEUR_FEM. Stratégie de quadratisation mise en place : déplacer les noeuds pour s'assurer que les tetras quadratiques présentent une distortion au dessu d'une borne inférieure. Mais ces noeuds quittent la géométrie. Les paramètres dans ~/.magic.