Interactive Conceptual Diagrams (ICDs)
[NOTICE] As of April 2019, the registered user functions of the ICD application are no longer available due to a change in EPA’s server configuration. The public user functions (e.g., exploring the evidence database using EPA diagrams) are still working; you can also access the database directly using CADLink. The registered user functions (e.g., creating and editing diagrams) are not working. We have begun to develop a revised version of the ICD, which we hope to release in Fall 2019. In the meantime, please contact us if you have any questions about the ICD or any of the CADDIS causal database tools.
In CADDIS, conceptual diagrams are used as visual tools for structuring causal assessments of stream biological impairmentimpairmentA detrimental effect on the biological integrity of a waterbody that prevents attainment of the designated use.s. They are developed as part of Step 2 (List Candidate Causes) of the Stressor Identification process.
These diagrams illustrate hypothesized pathways by which human activities, sources and stressors may lead to biotic responses. The ICD application builds upon this role for these diagrams by linking supporting literature to hypothesized causal pathways. These diagrams then serve as front-end for searching an online citation database of this literature-based information.
By organizing literature evidence along the causal pathways in conceptual diagrams, the ICD application shows where evidence for different pathways is strongest, weak or lacking. It can help structure your causal assessment and aid in communicating and defending assessment results, by linking evidence to causal pathways in your conceptual diagram.
Literature evidence already entered into the ICD database can give you a better understanding of how sources, stressors and responses may operate in your system. The database allows you to quickly and efficiently access scientific literature relevant to specific cause-effect linkages.
The ICD application provides:
- A set of U.S. EPA-constructed conceptual diagrams illustrating human activities, sources and stressors, and potential biotic responses (collectively referred to as shapes). These diagrams can be used to search the ICD literature database for peer-reviewed scientific literature supporting linkages among selected shapes.
- An online graphical editor that allows users to create new (or modify existing) diagrams and link new or existing references to them.
- A collaborative workspace, whereby users can grant other users the ability to view and revise diagrams they have created.
As you use the ICD application, please keep in mind that it is meant to be a collaborative environment. At any time, the creator of a diagram can allow all registered users to view and comment on any of their diagrams. Thus, you should assume that any comments you make on a diagram can be seen by all registered users of the ICD application.
What you are able to do in the ICD application is determined by two closely related concepts: your user role, and the mode of the application in which you’re operating.
There are three user roles defined in the ICD:
- Public users are any users who do not register in the ICD application. They have access to View mode of the ICD application, for EPA-constructed diagrams.
- Registered users are any users that self-register in (and then log in to) the ICD application. They have access to View and Edit modes of the application, for all diagrams that have been set as registered user-viewable by the diagrams’ creators.
- Admin users are registered users that have been granted administrative privileges. As with other registered users, admin users are not able to view any diagrams that have not been designated as registered user-viewable by the diagrams’ creators.
Your user role determines which of the ICD application’s two modes you can access.
For more information see the Viewing ICDs and Editing ICDs tabs above and the Complete ICD User Guide (Helpful Links box at right).
- View mode allows you to select shapes within an open diagram and obtain citations for supporting literature - that is, references suggesting that linkages among the selected shapes can occur.
- Edit mode allows you to modify existing diagrams, create new diagrams, and link new or existing supporting literature to those diagrams. It also allows you to designate other registered users as collaborators, granting them permission to view and/or modify any diagram you create (even if it is not designated as viewable by all registered users).
To register for the ICD application:
- If you have an EPA LAN account, use the EPA Web Application Access site and log in using your LAN id and password. Under "Select the Community or Application for which you are requesting access" choose CADDIS, and click Submit Registration. You will receive an email when access to the CADDIS community is granted, and you can then log in to the ICD application as a registered user, using your LAN id and password.
- If you do not have an EPA LAN account, click the Self Register link on the EPA Web Application Access site. Complete the Self-Registration form, using Kate Schofield as the EPA Contact Name, email@example.com as the EPA Contact's Email Address, and (202) 564-2640 as the EPA Contact's Phone Number. Under "Select the Community or Application for which you are requesting access" choose CADDIS, then accept the EPA Privacy & Security Notice and click Submit. You will receive an email when access to the CADDIS community is granted, and you can then log in to the ICD application as a registered user, using the user name and password you provided during registration.
Remember - you only need to register once. Once you have successfully registered (and been granted access to the CADDIS community), you can simply log in to the ICD application on all subsequent visits. For more information on registering for and logging in to the ICD application, see the ICD User Guide (Helpful Links box at right).
Once you have registered for and logged in to the ICD application (or have decided remain a public user and not register; see ICD User Roles and Modes tab for more detail), you are ready to start using the tool. View mode of the ICD application allows you to select shapes within a diagram and view scientific literature that provides support for linkages among those shapes. Public users can view EPA-constructed diagrams; registered users can view any diagrams that they have created, that they have been designated as collaborators on, or that have been set as registered user-viewable by their creators.
To get started in View mode, click the Open Diagram button, select the diagram you wish to open and click Open.
- Initially some shapes in the diagram may be hidden, indicating that parent-child relationships have been assigned among shapes. A black triangle under a shape indicates that there are additional shapes (i.e., child shapes) associated with that shape (i.e., the parent shape). To show all shapes in a diagram, click Show All; to show only the child shapes under a specific parent, click the black triangle under that parent.
- When shapes are hidden in View mode, arrows and lines will not be displayed; to view all arrows and lines, click Show All to make sure all shapes are displayed.
- The large EPA diagrams in the ICD application (composite ICD, metals ICD, and sediment ICD) were drawn without arrows and lines, given the scope of these diagrams and the number of shapes they contain. By selecting shapes and highlighting the shapes linked to them (see below), you can still "view" potential causal pathways among these shapes, even without arrows explicitly included.
You can select any shape within the diagram by single-clicking it.
- The first shape you select will highlight blue.
- Any shapes linked to the shape you selected (by literature evidence entered into the ICD database) will highlight purple.
- If a shape linked to your selected shape is hidden (i.e., it is a hidden child shape), its visible parent shape will outline in orange; show that parent's child shapes (i.e., click on the black triangle under that shape) to see any purple child shapes.
- You then can select any purple shape to view citations for papers supporting a linkage between the shapes you’ve selected. If no shapes highlight purple, it means that no literature supporting linkages between the shape you selected and any other shapes has yet been entered into the database—not necessarily that these linkages do not occur, or have not been observed anywhere in the scientific literature.
- Once you select a second shape (i.e., a first purple shape), the shape-highlighting will change: your second selected shape also will highlight blue, and shapes linked to that second shape will highlight purple. You can continue to select purple shapes in this manner, to view supporting literature for multiple pair-wise linkages.
- To deselect any shape you've selected, click it again (it will return to its original color); click Deselect All to clear your search (i.e., deselect all shapes) and begin again.
Once you have selected your shapes, click on the References panel icon reference icon to view supporting citations.
- The References panel will list the shapes you’ve selected (Selected Shapes, top sub-panel), references supporting pair-wise linkages among these shapes (Selected Linkages, middle sub-panel), and any references you’ve saved from all the searches you conducted in a given session (Saved References, bottom sub-panel).
- Buttons at the bottom of the Selected Linkages panel allow you to save references into to the Saved References sub-panel. Any references you save into the Saved References sub-panel will remain there, even if you clear your search (by clicking Deselect All on the View mode toolbar) and begin again.
- Buttons at the bottom of the Saved References sub-panel allow you to download selected references from this panel.
A brief description of features on the View mode toolbar (Figure 1) follows; for more information on viewing diagrams in the ICD application see the ICD User Guide (Helpful Links box at right).
- Inset icon: Pan around the open diagram by zooming in and dragging the blue window around the Inset (you also can use the Esc key to show/hide the Inset)
- Open Diagram: Open a diagram
- Legend: View a legend of the shapes used in the EPA-constructed diagrams
- Collapse/Expand: Vertically collapse a diagram and remove any unoccupied white space/Vertically expand a diagram and include any unoccupied white space (typically used when child shapes are hidden)
- Hide All/Show All: Hide all child shapes (shapes designated as sub-categories of another shape)/Show all child shapes (i.e., view all shapes in diagram)
- Deselect All: Reset the shape selection process by deselecting all currently selected shapes
- View as Image: View an image of the diagram as it currently appears on the screen
- Log In/Log Out: Log in to the ICD application/Log out of the ICD application
- Register: Register in the ICD application (only need to do this once; after that, can just log in)
- Help icon: Access the ICD User Guide for more detailed help with using the ICDs
- Search icon: Conduct a text-based keyword search of references (rather than a diagram-based search)
- References Panel icon: View/Hide the References panel, which shows you selected shapes and supporting references for linkages among those shapes