Systems Engineering Tool for Intelligent Transportation SET-IT Tool Training June 2017 SET-IT Tool Training Systems Engineering Tool for Intelligent Transportation SET-IT Tool Walk-Through (Part 2) Module 4 Welcome to the fourth module of the SET-IT training. In this module, we will continue to walk through the SET-IT tool investigating its features.

This module will take approximately 60 minutes to complete. SET-IT Tool Training June 2017 Module Outcome Identify Part 2 of the key features of SET-IT used to create an ITS project architecture Communications View Definitions Menu Outputs The outcome for this module is that you will be able to identify more of the key features of SET-IT used to create an ITS project architecture. This module picks up where module 3 left off and covers the Communications View, other Diagram Tools, the Definitions Menu, and how to Review the architecture and generate Outputs. This module will take approximately 60 minutes to complete. This module will take approximately 60 minutes to complete.

Opening SET-IT Open SET-IT from the Start menu SET-IT Tool Training June 2017 Opening SET-IT Open SET-IT from the Start menu Double-click on the SET-IT icon on the desktop You can open SET-IT from the Start menu or by double-clicking on the SET-IT icon placed on the desktop during installation.

Opening a Project in SET-IT SET-IT Tool Training June 2017 Opening a Project in SET-IT Or… To open an existing project, go to the Project tab. Then select Open. The pull-down on the right shows the Recent Documents that you can choose your last file. Or you can click Open and bring up the usual File Open dialog box and find your folder and the .setit file for the project you want to open.

SET-IT Tool Training June 2017 Validation on Open When you open an existing project SET-IT asks if you want to run Validation to review your architecture Yes, will select All validation reports and open them in Word No, will go to the main SET-IT window When you open an existing project SET-IT asks if you want to run Validation to review your architecture. This is a good idea if you have been working on your file or have had someone else working on your file and want to check the progress. Yes, will select All validation reports and open them in Word. We’ll discuss Validation later but there are a number of queries it runs on each view of the architecture and this will run all of them at once. No, will go to the main SET-IT window. This is the option you will check most often. You could decide you want to always do one or the other. In which case, click “Remember my choice and don’t ask me again.” We’ll just say No for now.

SET-IT Tool Training June 2017 Communications View

Communications View Recall from ARC-IT Training – the Comm View… SET-IT Tool Training June 2017 Communications View Recall from ARC-IT Training – the Comm View… defines the layered sets of communications protocols to support communications among the physical objects Each information flow triple has been mapped to a set of standards or published specifications Recall from Module 2 of the ARC-IT Training, the Comm View defines the layered sets of communications protocols to support communications among the physical objects. In ARC-IT each information flow triple (Source, Destination, Flow) has been mapped to a set of standards or published specifications.

Communications View, cont. SET-IT Tool Training June 2017 Communications View, cont. Once our architecture’s physical view has been customized we can look at the Communications View Once we have finished customizing our physical view, which means that we finished assigning custom/local element names to each of the Physical Object shapes in the Physical View’s service package diagrams, we can now turn our attention to the Communications, or Comm, View.

Communications View, cont. SET-IT Tool Training June 2017 Communications View, cont. Typical triple solution: Pair of comm protocol stacks with security plane Here is a typical information flow triple solution. It is illustrated as a pair of communications stacks, as shown to the right. The ARC-IT Communications View includes dozens of communications profiles that support all links defined in the physical view. These links are commonly abbreviated as n2m, where n and m are one of C (Center or Support), I or F (Field), V (Vehicle), P (Traveler, or Personal). So V2V names the link between vehicles, while C2F names the link between center and field infrastructure. Similarly, the model includes many more data profiles that accommodate the data needs of all associated triples. When combined, a data profile and communications profile provide a solution.

Comm View In SET-IT Clicking the Comm View button SET-IT Tool Training June 2017 Comm View In SET-IT Clicking the Comm View button Launches a process to copy in “Template” drawings for the communications protocol solution or profile Based on the information flows between customized elements in your physical view When you click the Comm View button at the top of the SET-IT window, it launches a process that analyzes all of the physical view information flows and determines the appropriate communications profiles. It looks at what profiles have already been included and updates them with any new profiles based on changes to the physical view.

Comm View in SET-IT SET-IT Tool Training June 2017 The Comm View is screen opens with a list of the communications profiles template drawings listed on the left and one of the diagrams showing on the Visio portion of the screen. The stencil is simplified to include only those elements that can be added to a Communications diagram: Notes, Comment, and Title Block.

Comm View in SET-IT Templates Based on ARC-IT SET-IT Tool Training June 2017 Comm View in SET-IT Templates Based on ARC-IT Drawings that will be used as basis for outputs of each interface The templates shown on the left are called Templates instead of Diagrams because these are the templates that will be used when you generate your output diagrams for your interfaces. These are just the somewhat generic template for the communications solutions that are possible in your architecture based on the information flows and how they are defined in the Comm View for ARC-IT.

Comm View Shape Properties SET-IT Tool Training June 2017 Comm View Shape Properties SET-IT’s Comm View allows you to further customize your architecture by deciding which standard should be associated with each layer of the comm protocol stack. To customize a comm template, you do what you did in Physical and Enterprise – Double-click on a shape or click the shape and click the Shape Properties button. From here you see the standards that ARC-IT associates with this layer as well as potentially other standards that could be associated with this layer. The buttons at the top of the list of Standards allow you to Refresh the list, get Info about a Standard, or Mirror the choices on one side of the interface to the other side (this is the default and you can unclick it). The top layer, ITS Application Information Layer cannot be customized on the template drawing – we use the Definitions grid for that which we’ll cover later.

SET-IT Tool Training June 2017 Other Diagram Tools

SET-IT Tool Training June 2017 More on Diagrams Physical, Enterprise, and Comm Views have been entered and customized Using basic drawing selection and Shape Properties What else can we do with Diagrams? At this point, Physical, Enterprise, and Comm Views have been entered and customized Using basic drawing selection and Shape Properties What else can we do with Diagrams?

Other Diagram Tools Terminals Data Distribution SET-IT Tool Training June 2017 Other Diagram Tools Terminals Data Distribution To complete the discussion on tailoring diagrams, we will return to the physical view and look at two additional tools in SET-IT for creating and editing physical diagrams. Let’s look at the two tools: terminals and data distribution.

Terminals SET-IT Tool Training June 2017 Terminals can be used to simplify complicated diagrams in SET-IT. Terminals are small rounded rectangles with an abbreviation that represents another physical object on that same diagram. Terminals simplify how the information flows are shown on the diagram. This feature is useful when a specific physical element is connected to many different physical elements thereby increasing the visual complexity of the diagram. Terminals can be used on any layer diagram but using a terminal on a Layer 2 diagram does not automatically place it on the Layer 0 or 1 diagrams. See the SET-IT Help for specific instructions on adding a terminal to a drawing.

Steps to Use Terminals Shape Properties / Edit Element Details SET-IT Tool Training June 2017 Steps to Use Terminals Shape Properties / Edit Element Details Enter an abbreviation for your element Shorter is better (3-5 chars) To use Terminals, go back to a Physical View drawing and open up Shape Properties for an Element. Click Edit to bring up the Element Details form for that element. Enter an abbreviation that is unique and logical for your architecture. You may notice some letters already there. As you created your element SET-IT created a default abbreviation using the first letter of each word. Try to keep the Abbreviation to 3 to 5 characters. This will ensure that the characters fit in the small space provided for the Terminal.

Steps to Use Terminals, cont’d SET-IT Tool Training June 2017 Steps to Use Terminals, cont’d Drag the Terminal shape from the stencil onto the Element Next, drag the Terminal shape from the Stencil on top of the Element. SET-IT detects that and assigns that Terminal to use the Element’s abbreviation. It is now a representative of that element.

Steps to Use Terminals, cont’d SET-IT Tool Training June 2017 Steps to Use Terminals, cont’d Now drag that terminal out onto the diagram, perhaps onto the other side. Connect flows to that terminal just like the element Now you can drag that Terminal shape out onto the drawing surface and it will keep the Element assignment. Now you can connect flows to it as if it where the element itself. This can make a cleaner diagram for really complicated applications. TIP: Drag another Terminal into that original element and leave it there so you can see what the terminal means.

Data Distribution SET-IT Tool Training June 2017 A connected vehicle environment is characterized by the fact that the producers of the data do not necessarily have a direct relationship with the consumers of that data. In traditional information technology projects, the system developer will be building the data collection as well as the data processing systems or specific external interfaces will be defined between systems. Even in traditional ITS systems, the center and the field devices are typically owned and operated by the same agency. With connected vehicle systems, new relationships are possible or no relationships may exist between the data sources and data destinations. The data distribution concept allows interfaces to be established such that application developers can take advantage of these supporting systems that provide the data distribution mechanics and the application developers can focus on the transportation needs being addressed. These ‘clearinghouses’ of data make it possible for one agency to set up a set of data collectors and make them available to any number of agencies that register and subscribe to the data they need. See the SET-IT Help for more information on data distribution in the connected vehicle environment and how to show data distribution in a project in SET-IT.

Using Data Distribution SET-IT Tool Training June 2017 Using Data Distribution On a Service Package diagram for an ITS service you can show how information flows go from a source to a destination but the data is actually routed through, or via, a data distribution or a wide area information system. To show this, first you must create the Data Distribution or Wide Area Information Dissemination system elements. Now Click on a flow and bring up Shape Properties. Use the “Via” pull-down to pick one of these communication domain elements to route the information through. NOTE: not every flow in ARC-IT is eligible for routing through communications domain objects.

SET-IT Tool Training June 2017 Definitions Menu

Definitions Menu SET-IT Tool Training June 2017 SET-IT is a tool that integrates drawing and database tools so, in addition to diagrams, the left menu includes a Definitions menu that provides a set of buttons for the components of the current view of the architecture. These buttons allow you to view and edit the components in a table or grid format. The components vary for the physical, enterprise, and communication views.

Definitions Menu, Physical SET-IT Tool Training June 2017 Definitions Menu, Physical The following buttons are shown on the Physical View Definitions menu: Service Package Instances Service Packages Diagram Information Stakeholders Need Areas Needs Scenario Sequences Elements Physical Objects Functional Objects Information Flows Information Flow Triples Status Values P-Interconnects P-Interconnect Triples Requirements Elements Requirements This slide shows the list of 18 buttons shown on the Physical View Definitions menu. Pressing each button on the left opens a grid or table in the main part of the display. The content will vary based on the database schema. Consult the SET-IT Help file for more information on each grid or table.

Definitions Menu, Enterprise SET-IT Tool Training June 2017 Definitions Menu, Enterprise The following buttons are shown on the Enterprise View Definitions menu: Service Package Instances Service Packages Diagram Information Stakeholders Elements Status Values Enterprise Objects Resources Roles Agreements Expectations Relationships This is the list of 12 buttons shown on the Enterprise View Definitions menu. Consult the SET-IT Help file for more information on each grid or table.

Definitions Menu, Communications SET-IT Tool Training June 2017 Definitions Menu, Communications The following buttons are shown on the Communications View Definitions menu: Diagram Information P-Interconnects Layers Profiles Standards Standards to Layers Profiles to Standards Flow Triples to Standards/Layers This is the list of 8 buttons shown on the Communications View Definitions menu. Consult the SET-IT Help file for more information on each grid or table.

Definitions Menu - Elements SET-IT Tool Training June 2017 Definitions Menu - Elements As on most of the tables of Definitions, you can select Details to edit characteristics about one of the components.

Definitions Menu Tools SET-IT Tool Training June 2017 Definitions Menu Tools Column Sort Text Filters On the Definitions Menu grids there are also some things you can do to help manage large tables. You can click the top of any column and it will sort that column. Want to sort it in descending order? Just click it again. You can also filter what’s shown to just one or a few things by clicking the little arrow at the top of the column to bring up a list of the things in that column and you can deselect things you may not want to see. You can also use the Text Filter button to filter certain things out, say only things that start with “State DOT”. When you click Apply the grid will change accordingly. To switch it back, open the filters again and click “(Select All)” to go back to showing everything from that column.

Definitions Menu – Details Form SET-IT Tool Training June 2017 Definitions Menu – Details Form Such tables and detail forms allow you to define the other components of a project architecture.

Synchronize SET-IT Tool Training June 2017 Whenever changes are made from the Definitions menu, SET-IT will usually automatically synchronize to make sure the changes are reflected on the diagrams. There may be times when you make a subtle change that isn’t picked up by synchronize. If you notice that a message hasn’t been displayed at the bottom like “Refreshing diagrams or tables” then hit the Synchronize button. There are options to update the Database to match the Diagrams or to Update the Diagrams to match the changes you made in the database. In this case, we’ve been in the definitions menu and Since the database was modified, you would select the bottom option to Update diagrams to match database.

SET-IT Tool Training June 2017 Menubar & Tabs

Project Tab SET-IT Tool Training June 2017 Now that we have looked at all of the left menu, let’s look at the tabs. As we saw earlier in this module, on the Project tab, you can create a new project, open an existing project, save the file, save it with a new name, close the project (and leave SET-IT open), print, obtain help, open a sample project, set options for SET-IT, learn about SET-IT and close the tool. The sample project file includes a basic set of objects and interfaces that are likely to be common in many ITS and, particularly, connected vehicle projects. Selecting the Sample Project option from the Project tab brings up a window called Create New Sample Project. This window is like the Save As window and allows you to save this sample as your own project into your own file folder. Use this window to choose the file folder and the name for the project. When you select OK, the new sample project opens and you can edit the file, add to it, change the names to match your own, or just review and print out portions of the sample project to better understand how SET-IT works and how to build a project architecture.

SET-IT Options, General Tab SET-IT Tool Training June 2017 SET-IT Options, General Tab There are a number of options that a SET-IT user can establish and change in order to personalize the usage of the software. Selecting Options on the Project tab opens a window with five tabs on the left: General, Diagrams, Synchronization, Validation, and Output. On the General tab, you can set: Project Settings which are used to set a default directory for your SET-IT project files. Use the Browse button to navigate your file system and select the directory or folder that will be used as the default starting point when you Create, Open, or Save As a project. Appearance options are used to set defaults for the color scheme, lightness, and styles for the project files.

SET-IT Options, Diagrams Tab SET-IT Tool Training June 2017 SET-IT Options, Diagrams Tab Appearance options are used to set the font to be used as the default for notes added to diagrams.

SET-IT Options, Synchronization Tab SET-IT Tool Training June 2017 SET-IT Options, Synchronization Tab There is also a check box to check if you want to delete the database interfaces that are not included in any of the diagrams. The Delete checkbox is useful when you have finished a project architecture and want to clean out unused entries in the database. Another checkbox lets you turn off Auto Synchronization. You may find that your performance is suffering and you want to control when it Syncs.

SET-IT Options, Validation Tab SET-IT Tool Training June 2017 SET-IT Options, Validation Tab You can use the next set of checkboxes to identify missing descriptions for: physical objects, functional objects, elements and stakeholders. The Enterprise set of checkboxes pertain to the stakeholders and their roles: owner, operator, installer, maintainer and certifier. For now, the critical roles to make sure are assigned to each of your elements are who owns and who operates them as they are used by SET-IT to identify the relationships that will need to take place between stakeholders. The Communications set of validation reports are used to identify profiles that may have missing mappings to standards on a layer, triples without an information layer standard, invalid characteristics, proper mapping between flows and profiles, missing standards, etc. The General tab is used to decide if Validation should run on Open or whether you want it to look for missing descriptions. (early on you may not)

SET-IT Options, Output Tab SET-IT Tool Training June 2017 SET-IT Options, Output Tab The checkbox allows you to roll up (or merge) identical data in multiple rows into a single cell, thereby improving the readability of the output table.

SET-IT Options, Event Log SET-IT Tool Training June 2017 SET-IT Options, Event Log SET-IT has an automatic logging feature that runs in the background and keeps a record of changes to the database, diagrams, files, etc. You can use this to manage what gets logged and where the file is stored and how big it can get before it starts writing over. You will need to “Run As Administrator” to be able to make changes to the details of what is logged.

Home Tab SET-IT Tool Training June 2017 Regardless of what item is selected on the left menu, the Home tab allows you to create new diagrams or architecture items, change views and access tools useful in developing an architecture. While it is recommended that you use a diagram from ARC-IT for a related service package whenever possible, SET-IT does allow you to create a diagram from scratch. To create a custom diagram, select the desired layer from the pull-down Diagrams menu in the New section of the ribbon. SET-IT currently supports development of physical diagrams at Layer 0, 1 or 2. For the enterprise view, only Layer 0 and 2 diagrams can be created. The New Item button allows you to create new architecture items. In the Physical and Enterprise Views, you can create a new service package, stakeholder, element, or status value, In the Physical View, you can create a new physical object, functional object, information flow, physical interconnect, or requirement. In the Enterprise View, you can add new agreements, expectations, or roles. In the Communications view, you can create a new profile and then use the Definitions grids and Template drawings to customize them by assigning standards to each layer. Whenever a new item is created, another window opens in which you provide the name, description, and the other details appropriate for the item. As we have reviewed earlier, the buttons in the Views section of the ribbon allow you to switch between the enterprise and physical views of the project.

Diagram Tab SET-IT Tool Training June 2017 The clipboard provides the basic cut, copy, and paste functions as used in other programs. Connection Points allows you to let SET-IT realign the connection points around an object. Connection points are the places around a shape where you attach connecting lines, e.g. information flows on a physical diagram or a relationship on an enterprise diagram. This can be helpful after resizing a shape if the connection points got distributed unevenly.

Diagram Tab, Text Tool SET-IT Tool Training June 2017 When a diagram is open, the Diagram tab is added. It contains all of the items on the Home tab plus several specific for tailoring diagrams. Let’s look at an example of using the Text tool.

Text Tool SET-IT Tool Training June 2017 On our physical diagram, we notice that the name of an information flow is not placed appropriately. To fix it, we select the flow then open the Text tool. In the Text box that opens, we can use the arrows to move the text up so it isn’t touching the line. We could also use this to change how the text is wrapped.

Diagram Tab (cont.) SET-IT Tool Training June 2017 If you edit the name of a diagram in the left menu, SET-IT will update the name in the title block of the diagram as well as the name of diagrams of different views of the same application.

Review Tab SET-IT Tool Training June 2017 The Review tab contains tools to assist you in reviewing your architecture. The first Review feature is a Spell check tool. Spell check is almost always running and you may notice the red squiggly lines under a word you just typed indicating it’s misspelled. Here, clicking Spell check will look across your entire database and open an new grid showing rows that have spelling errors to be fixed. You can even manage the dictionary by adding or removing unique terms with unique spellings. The Validate button opens a window that allows you to decide what parts of your architecture to check for consistency. This step is called Validation. The Validation window includes tabs for each view and a general tab. These checkboxes to select which items to look for during validation including unassigned stakeholders, disconnected flows, physical objects without element mappings, functional objects that are not contained within elements and other options to balance inconsistencies between Layers 0, 1, and 2 physical diagrams. You can use the next set of checkboxes to identify missing descriptions for the physical objects, functional objects, elements and stakeholders. Another set of checkboxes allows you to check the stakeholder roles of owner, operator, installer, maintainer and/or certifier. The Comm checkboxes look for standards to profiles mismappings and for flows not assigned a standard or inappropriately assigned. The general tab looks for empty descriptions. Once the validation options are set, select whether to save the results to a file (either a Word, Excel, or text file) or to open the results in an application (either Word or Excel). If you find yourself running the same validation reports over and over again, you can select the validation options you want to be your defaults in the SET-IT Options, as shown earlier in this module.

Output Tab - Tables SET-IT Tool Training June 2017 From the Output tab, tools that generate outputs about your project are provided. There are over 30 tables that can be generated from the current version of SET-IT. The types or groups of output tables include Project or File Info, Needs & Requirements Tables, Physical View tables, Enterprise View tables, Communications View tables, and Scenarios. At the top part of the Output Tables window use your mouse to expand the groups to find a particular table you want to generate. Then as you click on a table at the top the list of available columns will appear at the bottom left. Select the columns you want by using the back and forth arrows. 3rd, select the action – save to file or open the application. Then click with the Word, Excel, or Text buttons to create the output.

Creating an Output Table SET-IT Tool Training June 2017 Creating an Output Table To create a table, select the Tables button to open the Output Tables window. Select the type of table to be created from the Select Table pull-down menu. Then select from the Available Columns which will vary depending on the type of table being created. Use the left arrow to select individual columns to include (as they are selected they will move to the Selected Columns area). You can use the double left arrow to include all the columns in the table. After the columns for the table are selected, specify whether the table will be saved in a file or opened in an application. The final step is to select the format for the table. If it is to be saved to a file, you can save it as a Word, Excel or text file. You can open the table directly in Word or Excel.

Output Tab - Documents SET-IT Tool Training June 2017 In addition to tables, SET-IT can create a concept of operations document for the project. A concept of operations (or ConOps) describes the current state of operations, establishes the reasons for change, and defines operations for the future in terms of functions or features and supporting operations. For ITS projects, a ConOps establishes the driving needs for the project, the roles and responsibilities of the stakeholders, shows the high-level physical and enterprise architecture views in both diagrams and definitions based on ARC-IT and a set of operational scenarios. The ConOps document created by SET-IT will include the information included in the SET-IT file and will be a good start for a concept of operations but it will need to be completed with information not available in SET-IT. To create a concept of operations document, select it from the pull-down menu of the Documents button. This opens a window from which you setup, create and view the document.

Output Tab – Concept of Operations Setup SET-IT Tool Training June 2017 Output Tab – Concept of Operations Setup When you set up a concept of operations document, the Document Setup window opens with two tabs: General and Content. On the General tab, you can set the name and location for the file, apply a template to the document, and define information for its title page. On the Content tab, you define what information to include in the chapters of the document. You can use the Ready to Create? button to have SET-IT see if you are ready to create the document. Any issues found are listed in a Word file. When you are ready to create the document, close the Document Setup window.

Output Tab - Documents SET-IT Tool Training June 2017 When the setup of the concept of operations document is complete, select the Create button to create the file. While the document is being created, the status is provided. When it has been created, the Word document for the concept of operations opens. In addition to other documents, future releases of SET-IT will include more ways to generate output from your project including diagrams and Web pages.

Process for Creating a Project Architecture in SET-IT SET-IT Tool Training June 2017 Process for Creating a Project Architecture in SET-IT Open a project Include Service Package(s) in the project Tailor Physical View of each Service Package (on a diagram and in the definitions) Tailor the other views of the application Create outputs While walking through the features of SET-IT, we have presented a process for creating a project architecture. To summarize, the process is to open a project. Remember to consider using the sample project available in SET-IT as a starting point. Whether you start with a new project or the sample project, you will need to include the ITS Service Package(s) of your project. Once an application has been added, you need to tailor a view of it (we suggest starting with the physical view) using the diagram and the definitions. Remember to synchronize throughout the process to keep the diagrams and database in sync. Also, as with any program but especially one that is still a work in progress, it is a good idea to save the file after several changes have been made to it. Next, tailor the other views of the service package, again synchronizing and saving when revisions are made. If desired, you can create higher level diagrams for either of the views. Finally, you can create the desired outputs including a draft concept of operations document.

Quiz SET-IT allows you to create an ITS project architecture using: SET-IT Tool Training June 2017 Quiz SET-IT allows you to create an ITS project architecture using: Diagrams only Database Definition entries only Diagrams and Definitions All of the above D. All of the above

SET-IT Tool Training June 2017 Quiz Review SET-IT allows you to create an ITS project architecture using: Diagrams only Database Definitions only Both Diagrams and Definitions All of the above In SET-IT you may create an ITS project architecture using diagrams, database definitions or a combination of the two.

Review Module Outcomes SET-IT Tool Training June 2017 Review Module Outcomes Identify Part 2 of the key features of SET-IT used to create an ITS project architecture Communications View Definitions Menu Outputs This concludes Module 4 of the SET-IT training. You can now identify the key features of SET-IT and use them to create an ITS project architecture. This module covered the Communications View, other Diagram Tools, the Definitions Menu, and how to Review the architecture and generate Outputs. Return to the training curriculum to select the next module. To close this window, select the "X" in the upper right hand corner of your screen