Simplebim Commandes API - Méthode 1

L’API de ligne de commande Simplebim® peut être utilisée pour importer IFC, appliquer un modèle et exporter IFC.

L’API de ligne de commande Simplebim® peut être utilisée pour importer IFC, appliquer un modèle et exporter IFC. Le nombre et l’ordre des paramètres de ligne de commande sont significatifs. Si les noms de dossiers ou de fichiers contiennent des espaces, le nom doit être placé entre guillemets.

Description de la méthode

Pour cette méthode, nous aurons besoin de 2 fichiers :

• un fichier *.BAT qui permettra d’exécuter le process

• un fichier *.SBS contenant le script avec les commandes à appliquer.

Le fichier *.bat

Ce fichier contient plusieurs choses, voici un exemple :

"C:\Program Files\Datacubist\Simplebim 9\Simplebim9.exe" "Sample-Script.sbs"
pause

1. tout d’abord, entre guillemets, l’adresse vers le fichier EXE de Simplebim qui sera utilisé, ici Simplebim9

2. sur la même ligne, séparé d’un espace, entre guillemets, le nom du fichier Script au format SBS Ce fichier sera enregistrer à côté du fichier BAT

3. Second et dernière ligne, “pause” qui permettra d’interrompt le traitement du programme

le fichier *.sbs

L’extension de fichier du fichier de script est .sbs (Simplebim script). Le fichier est un simple fichier ASCII avec une commande sur chaque ligne. Les commandes sont traitées dans l’ordre dans lequel elles apparaissent dans le fichier. Pour s’exécuter en mode silencieux, le fichier de script doit se terminer par une commande Fermer. Le caractère # au début d’une ligne indique un commentaire.

Exemple de fichier *.sbs

Import=%SCRIPT_PATH%\GettingStarted.ifc
Run=Calculate Basic Quantities|SHADOW_AREAS=OFF
Apply=%SCRIPT_PATH%\Sample-Template.xlsx
Export=%SCRIPT_PATH%\GettingStarted (Ground Floor only).ifc
Close

1. La notion de %SCRIPT_PATH% permet de récupérer l’adresse de l’emplacement du script idéalement on place les fichiers BAT et SBS à côté des IFC à traiter, ou dans un dossier “supérieur” a celui des IFC

2. Import ⇒ désigne l’ IFC à ouvrir

3. Run ⇒ lance l’outil “Calculate Basic Quantites” avec l’option “SHADOW_AREAS” sur Off

4. Apply ⇒ permet d’appliquer un Template simplebim

5. Export, génèrera un nouvelle export après le traitement ci-dessus.

6. Close ⇒ finira la procédure

Commandes disponibles

Variable=	Vous pouvez définir n’importe quel nombre de variables constituées d’un nom et d’une valeur de variable. Lorsque le script est analysé et que le nom de la variable au format %NAME% se trouve n’importe où dans le script, il est remplacé par la valeur que vous avez définie. Les noms de variables sont sensibles à la casse. L’utilisation de variables facilite l’adaptation de votre script à de nouvelles situations, par exemple un nouveau projet. Variable=NAME=valeur La variable %SCRIPT_PATH% est toujours définie automatiquement et a le chemin d’accès complet du fichier de script que vous exécutez comme valeur.
Setting=	Vous pouvez définir les paramètres prédéfinis suivants TempFolder= Redirigez les fichiers temporaires vers un autre dossier que le dossier temporaire par défaut. Cela peut être utile avec les grands modèles si la taille du dossier temporaire par défaut est limitée. Exemple : Setting=TempFolder=C:\Temp
Import=	Le fichier IFC (avec chemin d’accès complet) à importer
Open=	Le fichier Cube (avec le chemin d’accès complet) à ouvrir
Apply=	Le template Simplebim (avec chemin d’accès complet) à appliquer au modèle IFC importé Remarque : Vous pouvez appliquer plusieurs templates dans l’ordre au même modèle Vous pouvez définir des variables qui sont transmises au template que vous appliquez en utilisant la même syntaxe que lorsque vous exécutez des outils. Dans le template, utilisez la syntaxe %NAME% n’importe où et le nom du paramètre est remplacé par la valeur du paramètre. Cela réduit le nombre de fichiers de modèle que vous devez créer car vous pouvez créer un modèle générique que vous configurez avec des paramètres.
Run=	GUID ou nom de l’outil à exécuter. L’outil peut éventuellement être configuré à l’aide de la syntaxe suivante Run=ToolNameOrGuid|key1|key2=value2|key3=value

Commande “Merge=”

Fichier IFC (avec chemin d’accès complet) à fusionner avec le modèle déjà importé ou ouvert. La fusion peut éventuellement être configurée à l’aide de la syntaxe suivante

**Merge=File**|key1|key2=value2|key3=value3

Vous pouvez utiliser des caractères génériques dans le paramètre File. Par exemple, C:\Script Files\*.ifc Lorsque le script est analysé, le répertoire spécifié dans le paramètre File est analysé à la recherche de fichiers qui correspondent au modèle et une commande distincte est automatiquement créée pour chaque fichier. Cela facilite la réutilisation des fichiers de script avec différentes combinaisons de fichiers qui doivent être fusionnés.

Les configurations prises en charge sont les suivantes :

Clé	Valeur(s)	Description
MERGE_TYPE	FULL (par défaut) CREATELOCATIONPRISMSREADLOCATIONPRISMS	Fusionnez le modèle complet, créez des prismes d’emplacement 3D à partir d’empreintes ou lisez uniquement des prismes d’emplacement 3D à partir du modèle.
MERGE_SITES	n/a	Fusionner des sites
MERGE_SITES_BY_NAME	ON OFF (par défaut)	Fusionner les sites par leur nom Le modèle résultant n’a qu’un seul site
MERGE_BUILDINGS	n/a	Fusionner des bâtiments
MERGE_BUILDINGS_BY_NAME	ON OFF (par défaut)	Fusionnez les bâtiments au sein de chaque site par le nom du bâtiment. Le modèle résultant n’a qu’un seul bâtiment sur chaque site.
MERGE_BUILDING_STOREYS_BY_NAME	n/a	Fusionnez les étages des bâtiments par leur nom. Ne peut être utilisé qu’avec MERGE_BUILDINGS. Peut être utilisé avec MERGE_BUILDING_STOREYS_BY_ELEVATION
MERGE_BUILDING_STOREYS_BY_ELEVATION	n/a	Fusionner les étages des bâtiments par élévation. Ne peut être utilisé qu’avec MERGE_BUILDINGS. Peut être utilisé avec MERGE_BUILDING_STOREYS_BY_NAME
BY_BUILDINGSTOREYS	ON OFF (par défaut)	Uniquement pertinent avec CREATELOCATIONPRISMS. Créez un prisme d’emplacement distinct pour chaque étage du bâtiment.
EXTEND_LOWEST_BUILDINGSTOREY	ON (par défaut) OFF	Uniquement pertinent avec CREATELOCATIONPRISMS. Étend le prisme d’emplacement le plus bas jusqu’à l’élévation inférieure de l’élément de construction le plus bas.

Commande disponibles (suite)

Export=	Fichier (avec chemin d’accès complet) du fichier IFC exporté.
Save=	Le fichier (avec le chemin d’accès complet) du fichier Cube enregistré
Save=	Fichier (avec chemin d’accès complet) du fichier à supprimer. L’utilisateur ne sera pas invité à confirmer l’opération de suppression.
StartLog=	Le fichier (avec le chemin d’accès complet) du fichier journal StartLog peut apparaître n’importe où après la première importation et la fermeture finale. Vous pouvez écrire un journal distinct pour chaque opération, un journal pour l’ensemble du script ou pour toute séquence d’opérations entre les deux.
SaveLog=	Enregistre le journal dans le fichier journal spécifié dans StartLog
Close=	Fichier (avec le chemin d’accès complet) du fichier journal en cas de blocage de l’application. Si l’application ne se bloque pas, le fichier journal n’est pas écrit. Close peut également être utilisé sans valeur

Exemple de script avancé

# This is a comment
Variable=PATH=C:\My Files
Import=%PATH%\test1.ifc
Merge=%PATH%\location_prisms.ifc|MERGE_TYPE=READLOCATIONPRISMS
Run=Split Geometries|SPLIT_TYPE=ALL|SMART_SPLIT=OFF
Save=%PATH%\test1.cube
StartLog=%PATH%\test1_out1.log
Apply=%PATH%\test1.xlsx
Run=Basic Quantities
SaveLog Export=%PATH%\test1_out1.ifc
Open=%PATH%\test1.cube
StartLog=%PATH%\test1_out2.log
Apply=%PATH%\test2.xlsx
Apply=%PATH%\test3.xlsx
SaveLog
Export=%PATH%\test1_out2.ifc
Delete=%PATH%\test1.cube
Close=%PATH%\test1_fail.log/p>

L’exemple de script ci-dessus effectue les opérations suivantes.

1. Ligne de commentaire qui ne fait rien

2. Définit la variable PATH avec la valeur C:\MyFiles

3. Importe un modèle à partir d’un fichier IFC (test1.ifc))

4. Fusionne les prismes d’emplacement d’un autre fichier IFC (location_prisms.ifc)

5. Résout les emplacements et fractionne les objets si nécessaire en exécutant l’outil Fractionner les géométries

6. Enregistre le modèle importé dans un fichier binaire (test1.cube). Ceci est fait parce qu’il est plus rapide plus tard d’ouvrir le fichier binaire que de réimporter le fichier IFC

7. Commence à écrire le journal pour appliquer un modèle (test1_out1.log)

8. Applique un modèle (test1.xlsx)

9. Enregistre le journal pour l’application du modèle (dans test1_out1.log)

10. Exporte le modèle modifié dans un nouveau fichier IFC (test1_out1.ifc)

11. Ouvre le modèle à partir du fichier binaire (test1.cube) enregistré à l’étape 2. Ceci est fait afin d’obtenir un modèle propre pour l’application des modèles suivants.

12. Commence à écrire le journal pour appliquer les modèles suivants (test1_out2.log)

13. Applique le premier modèle (test2.xlsx)

14. Applique le deuxième modèle (test3.xlsx)

15. Enregistre le journal pour l’application du premier et du deuxième modèle (dans test1_out2.log)

16. Exporte le modèle modifié dans un nouveau fichier IFC (test1_out2.ifc)

17. Supprime le fichier binaire (test1.cube)

18. Ferme l’application. Si l’application se bloque au cours de l’une des étapes ci-dessus, la raison du blocage sera écrite dans le fichier spécifié (test1_fail.log)

Variable existante :

MODEL_FILE	Chemin complet avec le nom du fichier	C:\MyFiles\Scripts\Sample.ifc
MODEL_PATH	Chemin du fichier dans "\" à la fin	C:\MyFiles\Scripts
MODEL_NAME	Nom du fichier sans l'extension	Sample
MODEL_EXT	Extension du fichier	ifc