Main Content

IsInRange

Create query to select range of property values

collapse all in page

    Syntax

    query = IsInRange(name,beginRangeValue,endRangeValue)

    Description

    query = IsInRange(name,beginRangeValue,endRangeValue) creates a query query that the find and createView functions use to select a range of values from beginRangeValue to endRangeValue for a specified property name name.

    example

    Examples

    collapse all

    Open Live Script

    Import the namespace that contains all of the System Composer™ queries.

    import systemcomposer.query.*

    Open the Simulink® project file for the keyless entry system.

    openProject("scKeylessEntrySystem");

    Load the architecture model.

    model = systemcomposer.loadModel("KeylessEntryArchitecture");

    Create a query to find components with values from 10 ms to 40 ms for the Latency property.

    constraint = IsInRange(PropertyValue("AutoProfile.BaseComponent.Latency"),...
Value(10,"ms"),Value(40,"ms"));
latency = find(model,constraint,Recurse=true,IncludeReferenceModels=true)
    latency = 5x1 cell
    {'KeylessEntryArchitecture/Sound System/Dashboard Speaker'                          }
    {'KeylessEntryArchitecture/Door Lock//Unlock System/Rear Driver Door Lock Actuator' }
    {'KeylessEntryArchitecture/Door Lock//Unlock System/Rear Pass Door Lock Actuator'   }
    {'KeylessEntryArchitecture/Door Lock//Unlock System/Front Driver Door Lock Actuator'}
    {'KeylessEntryArchitecture/Door Lock//Unlock System/Front Pass Door Lock Actuator'  }

    Input Arguments

    collapse all

    Property name for model element, specified in the form "<profile>.<stereotype>.<property>" or any property on the designated class.

    Example: "Name"

    Example: "AutoProfile.BaseComponent.Latency"

    Data Types: char

    Beginning range value for propertyName, specified as a systemcomposer.query.Value object.

    Example: Value(20)

    Example: Value(5,"ms")

    Ending range value for propertyName, specified as a systemcomposer.query.Value object.

    Example: Value(100)

    Example: Value(20,"ms")

    Output Arguments

    collapse all

    Query, returned as a systemcomposer.query.Constraint object.

    More About

    collapse all

    Definitions

    TermDefinitionApplicationMore Information
    view

    A view shows a customizable subset of elements in a model. Views can be filtered based on stereotypes or names of components, ports, and interfaces, along with the name, type, or units of an interface element. Create views by adding elements manually. Views create a simplified way to work with complex architectures by focusing on certain parts of the architectural design.

    You can use different types of views to represent the system. Switch between a component diagram, component hierarchy, or architecture hierarchy. For software architectures, you can switch to a class diagram view. A viewpoint represents a stakeholder perspective that specifies the contents of the view.
    element group

    An element group is a grouping of components in a view.

    Use element groups to programmatically populate a view.
    query

    A query is a specification that describes certain constraints or criteria to be satisfied by model elements.

    Use queries to search elements with constraint criteria and to filter views.

    		Find Elements in Model Using Queries
    component diagram

    A component diagram represents a view with components, ports, and connectors based on how the model is structured.

    Component diagrams allow you to programmatically or manually add and remove components from the view.

    		Inspect Components in Custom Architecture Views
    hierarchy diagram

    You can visualize a hierarchy diagram as a view with components, ports, reference types, component stereotypes, and stereotype properties.

    System Composer™ has two types of hierarchy diagrams:

    • Component hierarchy diagrams display components in tree form with parents above children. In a component hierarchy view, each referenced model is represented as many times as it is used.

    • Architecture hierarchy diagrams display unique component architecture types and their relationships using composition connections. In an architecture hierarchy view, each referenced model is represented only once.

    		Display Component Hierarchy and Architecture Hierarchy Using Views

    Version History

    Introduced in R2019b

    See Also

    Tools

    Objects

    Functions

    Topics