Retour au menu principal

## Option : cell

#### Syntaxe

`-cell <add|rm|set> <d> <H1|H2|H3|x|y|z|xy|xz|yx|yz|zx|zy|xyz>`

#### Description

Cette option permet de modifier les vecteurs de boîte.

Il est possible d'ajouter ("add"), d'enlever ("rm"), ou de donner ("set") une longueur <d> à la composante donnée d'un vecteur de boîte.

Les mots-clés H1, H2, H3, font référence aux vecteurs de boîte. Ajouter une distance <d> à un vecteur signifie qu'il conservera la même direction, mais sa norme sera plus longue d'une quantité <d>. La même logique s'applique lorsqu'une distance est réduite (rm) ou définie (set).

Les mots-clés x, y, z, font référence aux composantes cartésiennes des vecteurs de boîte. Ajouter une distance <d> à la composante x, signifie que le vecteur avec la plus grande composante suivant X sera redimensionné de sorte que les "bornes de boîte" (la différence entre les coordonnées maximum et minimum suivant X) soit plus longue de <d>. Les vecteurs de boîte conservent leurs directions respectives et leurs angles relatifs. Notez que si les vecteurs de boîte sont inclinés par rapport aux axes cartésiens, alors leur longueur n'est pas modifiée de <d> mais d'une autre quantité. La composante "xyz" signifie que la même distance <d> sera ajoutée (ou enlevée) à toutes les composantes cartésiennes. Les composantes xy, xz, yx, yz, zx, zy, sont les éléments non-diagonaux de la matrice des vecteurs de boîte.

Notez que si les vecteurs de boîte sont alignés avec les axes cartésiens, tels que H1//x, H2//y, et H3//z, alors utiliser le mot-clé "H1" est strictement équivalent à "x", puisque le vecteur H1 a une composante non nulle uniquement suivant X. La même chose est vraie pour H2 et y, et pour H3 et z.

La distance <d> doit être donnée en (Å), et il est recommandé qu'elle soit positive pour éviter toute confusion. Utiliser "add" avec une valeur négative de <d> va en réalité raccourcir le vecteur de boîte. De la même façon, utiliser "rm" avec une valeur négative de <d> va en fait allonger le vecteur de boîte.

Les positions cartésiennes des atomes ne sont pas modifiées par cette option. Ainsi, allonger un vecteur de boîte (avec "add" ou "set") introduira une épaisseur de vide suivant la direction donnée. Inversement, si un vecteur est raccourci (avec "rm" ou "set"), alors certains atomes peuvent se retrouver en dehors de la boîte. Si des conditions aux limites périodiques sont utilisées, cela peut provoquer un chevauchement de certains atomes.

Si vous souhaitez donner toutes les composantes des vecteurs de boîte, il est possible de les écrire dans un fichier et d'utiliser l'option `-property`. Pour forcer Atomsk à construire automatiquement une nouvelle boîte, il est possible d'utiliser l'option `-rebox`.

#### Défaut

Par défaut Atomsk utilise toujours les vecteurs de boîte lus depuis le fichier d'entrée. Cependant si aucun vecteur de boîte n'est trouvé dans le fichier d'entrée, l'option `-rebox` est automatiquement appelée juste après la lecture du fichier, et avant l'application de toute autre option. C'est le cas par exemple du format XYZ par défaut, qui ne contient pas de vecteur de boîte.

#### Exemples

- `atomsk initial.cfg -cell add 10 H2 final.cfg`

  Avec cette commande, Atomsk va lire le fichier `initial.cfg`, puis ajouter 10 Å au second vecteur de boîte (H2). Autrement dit, le second vecteur de boîte va garder sa direction, mais il sera allongé de 10 Å. Les positions des atomes resteront identiques, donc cette option va ajouter du vide le long de cette direction. Le résultat sera enregistré dans le fichier `final.cfg`.

- `atomsk initial.cfg -cell add 20 y final.cfg`

  Ceci va lire le fichier `initial.cfg`, puis ajouter 20 Å aux dimensions de la boîte suivant l'axe cartésien Y. Dans la pratique cela ajoutera du vide suivant la direction Y. Le résultat sera enregistré dans `final.cfg`.

- `atomsk initial.cfg -cell set 87.4 H1 final.cfg`

  Ceci va changer la longueur du premier vecteur de boîte à 87.4 Å.

- `atomsk initial.cfg -cell rm 0.5 H3 final.cfg`

  Ceci va réduire la longueur du troisième vecteur de boîte (H3) de 0.5 Å.

Retour au menu principal