npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@itwin/clash-detection-client

v0.2.3

Published

Clash Detection client for the iTwin platform

Downloads

97

Readme

Clash Detection Client Library

Copyright © Bentley Systems, Incorporated. All rights reserved. See LICENSE.md for license terms and full copyright notice.

iTwin.js is an open source platform for creating, querying, modifying, and displaying Infrastructure Digital Twins. To learn more about the iTwin Platform and its APIs, visit the iTwin developer portal.

If you have questions, or wish to contribute to iTwin.js, see our Contributing guide.

About this Repository

The @itwin/clash-detection-client package consists of thin wrapper functions for sending requests to the iTwin Clash Detection API. There are CRUD functions for the four components of clash detection: suppression rules, tests, runs and results. Define clash suppression criteria in suppression rules, define clash criteria in tests and add suppression rules, run the tests for versions of iModels, and retrieve the clash results. Visit the Clash Detection API for more details.

Key response types

Key methods

Authorization options

There are two ways to provide the authorization token for the wrapper functions:

  1. Set accessToken in parameters object every time a wrapper function is called (as shown in usage examples below).

  2. Provide a callback function to the ClashDetectionClient constructor. This callback will be called by the wrapper function if the accessToken parameter in Option 1 is not provided.

    import { ClashDetectionClient, ClashDetectionClientOptions } from "@itwin/clash-detection-client";

    public static initWrapperClient(accessToken: string, projectId: string): ClashDetectionClient {
      const options: ClashDetectionClientOptions = {};
      const accessTokenCallback = async () => this.getAccessToken();
      const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient(options, accessTokenCallback);
    }

    public static async getAccessToken(): Promise<string> {
      return "Bearer ey..."
    }

Usage examples

Get all clash detection suppression rule templates

import { ClashDetectionClient, EntityListIterator, ParamsToGetTemplateList, SuppressionRuleTemplate } from "@itwin/clash-detection-client";

/** Function that queries all suppression rule templates for a particular project and prints their ids to the console. */
async function printSuppressionRuleTemplateIds(accessToken: string, projectId: string): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const params: ParamsToGetTemplateList = {
    accessToken,
    urlParams: {
      projectId,
    },
  };
  const templatesIterator: EntityListIterator<SuppressionRuleTemplate> = clashDetectionClient.templates.getList(params);
  for await (const template of templatesIterator)
    console.log(template.id);
}

Create clash detection suppression rule

import { ClashDetectionClient, ParamsToCreateSuppressionRule, SuppressionRule } from "@itwin/clash-detection-client";

/** Function that creates a new clash detection suppression rule and prints its id to the console. */
async function createClashDetectionSuppressionRule(accessToken: string, templateId: string): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
    const params: ParamsToCreateSuppressionRule = {
      accessToken,
      templateId: clashDetectionClient.templateId,
      displayName: "TestSuppressionRule1",
      reason: "Test suppression rule 1",
      parameters: {
        propertyKey: {
          relationshipPath: "ArchitecturalPhysical:Door",
          propertyName: "Roll",
        },
        operator: {
          value: "=",
        },
      },
    },
  };
  const rule: SuppressionRule = await clashDetectionClient.rules.create(params);

  console.log(rule.id);
}

Update clash detection suppression rule

import { ClashDetectionClient, ParamsToUpdateSuppressionRule, SuppressionRule } from "@itwin/clash-detection-client";

/** Function that updates a new clash detection suppression rule and prints its id to the console. */
async function updateClashDetectionSuppressionRule(accessToken: string, ruleId: string): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const params: ParamsToUpdateSuppressionRule = {
    accessToken,
    ruleId: clashDetectionClient.ruleId,
    displayName: "TestSuppressionRule1 - updated",
    reason: "Test suppression rule 1",
  };
  const rule: SuppressionRule = await clashDetectionClient.rules.update(params);

  console.log(rule.id);
}

Get all clash detection suppression rules -minimal

import { ClashDetectionClient, EntityListIterator, MinimalSuppressionRule, ParamsToGetSuppressionRuleList } from "@itwin/clash-detection-client";

/** Function that queries all suppression rules for a particular project and prints their ids to the console. */
async function printRuleIds(accessToken: string, projectId: string): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const params: ParamsToGetSuppressionRuleList = {
    accessToken,
    urlParams: {
      projectId,
    },
  };
  const rulesIterator: EntityListIterator<MinimalSuppressionRule> = clashDetectionClient.rules.getMinimalList(params);
  for await (const rule of rulesIterator)
    console.log(rule.id);
}

Get all clash detection suppression rules -detailed

import { ClashDetectionClient, EntityListIterator, ParamsToGetSuppressionRuleList, SuppressionRuleDetails } from "@itwin/clash-detection-client";

/** Function that queries all suppression rules for a particular project and prints their ids to the console. */
async function printRuleIds(accessToken: string, projectId: string): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const params: ParamsToGetSuppressionRuleList = {
    accessToken,
    urlParams: {
      projectId,
    },
    userMetadata: true,
  };
  const rulesIterator: EntityListIterator<SuppressionRuleDetails> = clashDetectionClient.rules.getRepresentationList(params);
  for await (const rule of rulesIterator)
    console.log(rule.id);
}

Get clash detection suppression rule

import { ClashDetectionClient, ParamsToGetSuppressionRule, SuppressionRuleDetails } from "@itwin/clash-detection-client";

/** Function that gets a clash detection suppression rule and prints its name. */
async function getClashDetectionRule(accessToken: string, ruleId: string): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const params: ParamsToGetSuppressionRule = {
    accessToken,
    ruleId,
    userMetadata: true,
  };
  const rule: SuppressionRuleDetails = await clashDetectionClient.rules.getSingle(params);

  console.log(rule.displayName);
}

Delete clash detection suppression rule

import { ClashDetectionClient, ParamsToDeleteSuppressionRule } from "@itwin/clash-detection-client";

/** Function that deletes a clash detection rule. */
async function deleteClashDetectionSuppressionRule(accessToken: string, ruleId: string): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const params: ParamsToDeleteSuppressionRule = {
    accessToken,
    ruleId,
  };
  await clashDetectionClient.rules.delete(params);
}

Create clash detection test

import { ClashDetectionClient, ParamsToCreateTest, Test } from "@itwin/clash-detection-client";

/** Function that creates a new clash detection test and prints its id to the console. */
async function createClashDetectionTest(accessToken: string, projectId: string, rules: string[]): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const suppressionRules: string[] = [clashDetectionClient.ruleId];
  const params: ParamsToCreateTest = {
    accessToken,
    projectId,
    displayName: "Test1",
    description: "Test 1",
    setA: {
      modelIds: [ "0x21","0x66","0x68","0x6a" ],
      categoryIds: [],
      query: "SELECT BisCore.Element.ECInstanceId FROM BisCore.Element WHERE BisCore.Element.Model.id=0x6c",
      queryName: "Test1",
      selfCheck: true,
      clearance: 0.001,
    },
    setB: {
      modelIds: [],
      categoryIds: [],
      selfCheck: false,
      clearance: 0,
    },
    suppressTouching: false,
    touchingTolerance: 0,
    includeSubModels: false,
    suppressionRules,
    advancedSettings: {
      longClash: true,
      calculateOverlap: true,
      toleranceOverlapValidation, true,
    },
  };
  const test: Test = await clashDetectionClient.tests.create(params);

  console.log(test.id);
}

Update clash detection test

import { ClashDetectionClient, ParamsToUpdateTest, Test } from "@itwin/clash-detection-client";

/** Function that updates a new clash detection test and prints its id to the console.
 *
 * It is mandatory to provide either of modelIds/categoryIds/both or query along with queryName or queries for a specific set.
 * Cross combination is allowed i.e. setA can have modelId/categoryId and setB can have queries.
 * queryName supports max of 1024 characters.
*/
async function updateClashDetectionTest(accessToken: string, testId: string, rules: string[]): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const suppressionRules: string[] = [clashDetectionClient.ruleId];
  const params: ParamsToUpdateTest = {
    accessToken,
    testId: clashDetectionClient.testId,
    displayName: "Test1 - updated",
    description: "Test 1",
    setA: {
      modelIds: [],
      categoryIds: [],
      query: "SELECT BisCore.Element.ECInstanceId FROM BisCore.Element WHERE BisCore.Element.Model.id=0x6c",
      queryName: "Test1",
      selfCheck: true,
      clearance: 0.001,
    },
    setB: {
      modelIds: [ "0x21","0x66","0x68","0x6a" ],
      categoryIds: [],
      selfCheck: false,
      clearance: 0,
    },
    suppressTouching: false,
    touchingTolerance: 0,
    includeSubModels: false,
    suppressionRules,
    advancedSettings: {
      longClash: true,
      calculateOverlap: true,
      toleranceOverlapValidation, true,
    },
  };
  const test: Test = await clashDetectionClient.tests.update(params);

  console.log(test.id);
}

Get all clash detection tests

import { ClashDetectionClient, EntityListIterator, ParamsToGetTestList, TestItem } from "@itwin/clash-detection-client";
/** Function that queries all tests for a particular project and prints their ids to the console. */
async function printTestIds(accessToken: string, projectId: string): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const params: ParamsToGetTestList = {
    accessToken,
    urlParams: {
      projectId,
    },
    userMetadata: true,
  };
  const testsIterator: EntityListIterator<TestItem> = clashDetectionClient.tests.getList(params);
  for await (const test of testsIterator)
    console.log(test.id);
}

Get clash detection test

import { ClashDetectionClient, ParamsToGetTest, TestDetails } from "@itwin/clash-detection-client";

/** Function that gets a clash detection test and prints its name. */
async function getClashDetectionTest(accessToken: string, testId: string): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const params: ParamsToGetTest = {
    accessToken,
    testId,
    userMetadata: true,
  };
  const test: TestDetails = await clashDetectionClient.tests.getSingle(params);

  console.log(test.displayName);
}

Run clash detection test

import { ClashDetectionClient, ParamsToRunTest, Run, TestSettings } from "@itwin/clash-detection-client";

/** Function that runs a clash detection test and prints its run id. */
async function runClashDetectionTest(accessToken: string, testId: string, iModelId: string, namedVersionId?: string, testSettings?: TestSettings): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const params: ParamsToRunTest = {
    accessToken,
    testId,
    iModelId,
    namedVersionId,   // Optional - defaults to latest version
    testSettings,     // Optional
  };
  const run: Run = await clashDetectionClient.tests.runTest(params);

  console.log(run.id);
}

Delete clash detection test

import { ClashDetectionClient, ParamsToDeleteTest } from "@itwin/clash-detection-client";

/** Function that deletes a clash detection test. */
async function deleteClashDetectionTest(accessToken: string, testId: string): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const params: ParamsToDeleteTest = {
    accessToken,
    testId,
  };
  await clashDetectionClient.tests.delete(params);
}

Get all clash detection runs -minimal

import { ClashDetectionClient, MinimalRun, ParamsToGetRunList } from "@itwin/clash-detection-client";
/** Function that queries all runs for a particular project and prints their ids to the console. */
async function printRunIds(accessToken: string, projectId: string): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const params: ParamsToGetRunList = {
    accessToken,
    urlParams: {
      projectId,
    },
  };
  const runs: MinimalRun[] = await clashDetectionClient.runs.getMinimalList(params);
  runs.forEach((run) => {
    console.log(run.id);
  });
}

Get all clash detection runs -detailed

import { ClashDetectionClient, ParamsToGetRunList, RunDetails } from "@itwin/clash-detection-client";
/** Function that queries all runs for a particular project and prints their ids to the console. */
async function printRunIds(accessToken: string, projectId: string): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const params: ParamsToGetRunList = {
    accessToken,
    urlParams: {
      projectId,
    },
  };
  const runs: RunDetails[] = await clashDetectionClient.runs.getRepresentationList(params);
  runs.forEach((run) => {
    console.log(run.id);
  });
}

Get clash detection run

import { ClashDetectionClient, ParamsToGetRun, RunDetails } from "@itwin/clash-detection-client";

/** Function that gets a clash detection run and prints its name and status. */
async function getClashDetectionRun(accessToken: string, runId: string): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const params: ParamsToGetRun = {
    accessToken,
    runId,
  };
  const run: RunDetails = await clashDetectionClient.runs.getSingle(params);

  console.log('${run.displayName}: ${run.status}');
}

Delete clash detection run

import { ClashDetectionClient, ParamsToDeleteRun } from "@itwin/clash-detection-client";

/** Function that deletes a clash detection run. */
async function deleteClashDetectionRun(accessToken: string, runId: string): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const params: ParamsToDeleteRun = {
    accessToken,
    runId,
  };
  await clashDetectionClient.runs.delete(params);
}

Get clash detection result

import { ClashDetectionClient, ParamsToGetResult, ResponseFromGetResult } from "@itwin/clash-detection-client";

/** Function that gets a clash detection result and prints the count of clashes. */
async function getClashDetectionResult(accessToken: string, resultId: string): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const params: ParamsToGetResult = {
    accessToken,
    resultId,
  };
  const response: ResponseFromGetResult   = await clashDetectionClient.results.get(params);

  console.log('Results count: ${response.result.length.toString()}');
}

Extract models and categories - Deprecated

import { ClashDetectionClient, ParamsToExtractModelsAndCategories } from "@itwin/clash-detection-client";
/** Function that extracts models and categories. */
async function extractModelsAndCategories(accessToken: string, projectId: string, iModelId: string): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const params: ParamsToExtractModelsAndCategories = {
    accessToken,
    iModelId,
    urlParams: {
      projectId
    }
  };
  await clashDetectionClient.imodel.extractModelsAndCategories(params);
}

Get models and categories - Deprecated

import { ClashDetectionClient, ParamsToGetModelsAndCategories, ResponseFromGetModelsAndCategories } from "@itwin/clash-detection-client";
/** Function that gets the list of models and categories in an iModel and prints the extraction status and count of models and categories. */
async function getModelsAndCategories(accessToken: string, projectId: string, iModelId: string): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const params: ParamsToGetModelsAndCategories = {
    iModelId,
    urlParams: {
      projectId,
    },
  };
  const modelsAndCategories: ResponseFromGetModelsAndCategories = await clashDetectionClient.imodel.getModelsAndCategories(params);
  console.log('Status: ${modelsAndCategories.status}, model count: ${modelsAndCategories.models.length}, category count: ${modelsAndCategories.categories.length}');
}

Extract schema information - Deprecated

import { ClashDetectionClient, ParamsToExtractSchemaInfo } from "@itwin/clash-detection-client";
/** Function that extracts schema info. */
async function extractSchemaInfo(accessToken: string, projectId: string, iModelId: string): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const params: ParamsToExtractSchemaInfo = {
    accessToken,
    iModelId,
    urlParams: {
      projectId
    }
  };
  await clashDetectionClient.imodel.extractSchemaInfo(params);
}

Get schema information - Deprecated

import { ClashDetectionClient, ParamsToGetSchemaInfo, ResponseFromGetSchemaInfo } from "@itwin/clash-detection-client";
/** Function that gets the iModel schema information and prints the extraction status and count of schemas. */
async function getSchemaInfo(accessToken: string, projectId: string, iModelId: string): Promise<void> {
  const clashDetectionClient: ClashDetectionClient = new ClashDetectionClient();
  const params: ParamsToGetSchemaInfo = {
    iModelId,
    urlParams: {
      projectId,
    },
  };
  const schemaInfo: ResponseFromGetSchemaInfo = await clashDetectionClient.imodel.getSchemaInfo(params);
  console.log('Status: ${schemaInfo.status}, schema count: ${schemaInfo.schema.length}');
}