Retour au menu principal

## Mode : normal

#### Syntaxe

`atomsk <fichier-entrée> [options] <fichier-sortie>`

`atomsk <fichier-entrée> [options] <formats>`

`atomsk <fichier-entrée> [options] <préfixe> <formats>`

#### Description

Ceci est le mode par défaut. Dans ce mode, Atomsk lit un fichier d'entrée <fichier-entrée>, applique des options s'il y en a, et écrit le résultat final vers un ou plusieurs fichiers de sortie.

Si le fichier de sortie, <fichier-sortie>, a un nom ou une extension reconnaissable (par exemple "fichier.xyz", ou "systeme.cfg"), alors Atomsk écrira ce fichier dans le format approprié.

Si aucun nom de fichier de sortie n'est spécifié, mais que plusieurs formats de sortie sont donnés (parmi ceux supportés par Atomsk), alors Atomsk utilisera le nom du fichier d'entrée, et remplacera son extension par les formats de sortie.

Si un <préfixe> est donné (c'est-à-dire un nom de fichier sans extension), suivi d'un ou plusieurs formats de sortie, alors il sera utilisé comme base pour les noms de fichiers de sortie.

Atomsk vérifie l'existence des fichiers donnés dans la ligne de commande. Si seulement l'un des fichiers existe, alors Atomsk le considère comme fichier d'entrée, et le fichier inexistant comme fichier de sortie, peu importe l'ordre dans lequel les noms de fichiers apparaîssent dans la commande. Si les deux fichiers existent, alors Atomsk demandera lequel des deux utiliser comme entrée, et s'il faut écraser le fichier de sortie. Si vous souhaitez éviter ces questions, il est recommandé de supprimer le fichier de sortie avant d'appeler Atomsk, et/ou d'utiliser l'option `-ignore` ou l'option `-overwrite`.

Utiliser des options n'est pas obligatoire. Si la ligne de commandes contient une ou plusieurs options, alors elles sont appliquées séquentiellement, dans l'ordre où elles apparaissent dans la commande, après la lecture du fichier d'entrée, et avant l'écriture du fichier de sortie. Veuillez vous référer à la documentation sur les options.

Notez que dans ce mode, Atomsk n'accepte qu'un et un seul fichier d'entrée, et un seul fichier de sortie (et éventuellement, un ou plusieurs formats de fichiers). Si la commande contient plus de deux noms de fichiers, alors seuls les deux premiers sont utilisés, et les autres sont purement et simplement ignorés. Ainsi, vous ne devriez jamais utiliser un métacaractère (comme le symbole étoile *) pour donner des noms de fichiers, comme par exemple "atomsk *.xyz cfg". Si vous souhaitez convertir plusieurs fichiers d'entrée, veuillez utiliser le mode liste.

Notez que contrairement aux autres modes, vous n'avez pas à écrire "`--normal`" pour utiliser le mode normal, puisqu'il s'agit du mode par défaut.

#### Exemples

- `atomsk monsysteme.gin exemple.cfg`

  Ceci convertira le fichier `monsysteme.gin` vers `exemple.cfg`.

- `atomsk exemple.cfg monsysteme.gin`

  Identique à l'exemple précédent, en supposant que le fichier `monsysteme.gin` existe et pas le fichier `exemple.cfg`. Le programme reconnaît quel fichier existe et l'utilise comme fichier d'entrée. Si les deux fichiers existent, le programme demande à l'utilisateur quel fichier doit être utilisé en entrée.

- `atomsk monsysteme.gin cfg`

  Ceci convertira `monsysteme.gin` vers `monsysteme.cfg`.

- `atomsk monsysteme.gin nouveau_systeme cfg xsf`

  Cet exemple utilise un préfixe (`nouveau_systeme`) et plusieurs formats de sortie. Le fichier `monsysteme.gin` sera converti vers `nouveau_systeme.cfg` et `nouveau_systeme.xsf`.

- `atomsk xsf nouveau_systeme cfg monsysteme.gin`

  Identique à l'exemple précédent. Notez que les paramètres et noms de fichiers peuvent apparaître dans n'importe quel ordre dans la commande.

- `atomsk cellule.xyz -duplicate 2 2 6 -shift above 6.5 z 0.2 0.6 0.0 defaut_empilement.xsf`

  Cet exemple utilise plusieurs options. Le fichier `cellule.xyz` sera lu, ensuite le système sera dupliqué pour former une super-cellule de dimensions 2x2x6, puis une partie du système sera translatée, et le système final sera écrit dans le fichier `defaut_empilement.xsf`.

Retour au menu principal