CyAnimator: Simple Animations of Cytoscape Networks

John H. Morris; Dhameliya Vijay; Steven Federowicz; Alexander R. Pico; Thomas E. Ferrin

doi:10.12688/f1000research.6852.2

Home Browse CyAnimator: Simple Animations of Cytoscape Networks

ALL Metrics

Views

Downloads

Get PDF

Get XML

Export

▬

✚

Software Tool Article

Revised

CyAnimator: Simple Animations of Cytoscape Networks

[version 2; peer review: 3 approved]

John H. Morris ¹, Dhameliya Vijay², Steven Federowicz³, Alexander R. Pico⁴, Thomas E. Ferrin⁵

John H. Morris ¹, Dhameliya Vijay², [...] Steven Federowicz³, Alexander R. Pico⁴, Thomas E. Ferrin⁵

PUBLISHED 30 Dec 2015

Author details Author details

¹ Resource for Biocomputing, Visualization and Informatics,, University of California, San Francisco, CA, 94143, USA
² Dhirubhai Ambani Institute of Information and Communication Technology, Gujarat, India
³ Intrexon Inc., San Diego, CA, 92121, USA
⁴ Gladstone Institutes, San Francisco, CA, USA
⁵ Resource for Biocomputing, Visualization and Informatics, University of California, San Francisco, CA, USA

OPEN PEER REVIEW

REVIEWER STATUS

This article is included in the Bioinformatics gateway.

This article is included in the Cytoscape gateway.

Abstract

CyAnimator (http://apps.cytoscape.org/apps/cyanimator) is a Cytoscape app that provides a tool for simple animations of Cytoscape networks. The tool allows you to take a series of snapshots (CyAnimator calls them frames) of Cytoscape networks. For example, the first frame might be of a network shown from a ”zoomed out” viewpoint and the second frame might focus on a specific group of nodes. Once these two frames are captured by the tool, it can animate between them by interpolating the changes in location, zoom, node color, node size, edge thickness, presence or absence of annotations, etc. The animations may be saved as a series of individual frames, animated GIFs, or H.264/MP4 movies.

CyAnimator is available from within the Cytoscape App Manager or from the Cytoscape app store.

Keywords

Cytoscape, CyAnimator, network, animation

Corresponding author: John H. Morris

Competing interests: No competing interests were disclosed.

Grant information: JHM was funded by NIGMS grants P41-GM103504 and P41-GM103311. TF is funded by NIGMS grant P41-GM103311. AP is funded by NIGMS grant P41-GM103504.

Copyright: © 2015 Morris JH et al. This is an open access article distributed under the terms of the Creative Commons Attribution License, which permits unrestricted use, distribution, and reproduction in any medium, provided the original work is properly cited. Data associated with the article are available under the terms of the Creative Commons Zero "No rights reserved" data waiver (CC0 1.0 Public domain dedication).

How to cite: Morris JH, Vijay D, Federowicz S et al. CyAnimator: Simple Animations of Cytoscape Networks [version 2; peer review: 3 approved]. F1000Research 2015, 4:482 (https://doi.org/10.12688/f1000research.6852.2) First published: 05 Aug 2015, 4:482 (https://doi.org/10.12688/f1000research.6852.1) Latest published: 30 Dec 2015, 4:482 (https://doi.org/10.12688/f1000research.6852.2)

Revised Amendments from Version 1

This version of the CyAnimator manuscript describes version 2 of CyAnimator. Version 2 has several significant changes over version 1, which are described in the manuscript, including:

Significantly improved coverage of visual attributes
Ability to save and restore timelines in and from session files
Reworked UI, including the ability to drag frames to adjust the duration of transitions
Significant changes to the internal model, which was documented as deficient in version 1 of the manuscript. This version describes the new internal model, which improves maintainability and robustness.

See the authors' detailed response to the review by Nathan Salomonis

Introduction

Biological networks are typically represented as nodes and edges (node-link diagrams) that might represent the pathways, signaling cascades, interactions between proteins, and other relationships between biological entities. The problem with this representation is that it makes it seem like these relationships are static, but it is well known that biological networks are dynamic, adapting and changing in response to the cell cycle, environmental conditions, development, and, over longer periods of time, evolution. One of the best methods to represent these changes is to take advantage of motion, showing changes by interpolating between the two states. This use of motion is one way to address “change blindness”¹, which makes it difficult to detect the difference between two images when they are shown in succession. This is important both for presentation of results to collaborators and the broader scientific community and for the exploration of data by individual researchers.

Cytoscape² is one of the most common tools used to visualize and analyze biological networks. It provides very powerful visualization tools to map a variety of categorical and numeric data into visual attributes associated with the nodes and edges of node-link diagrams. Unfortunately, Cytoscape does not provide any inherent animation capabilities, making it difficult to use interpolation to detect changes between two states, however, Cytoscape does provide a rich infrastructure for extending its core functionality through “apps”³. Several Cytoscape apps provide some animation capabilities. For example, VistaClara⁴, 3DScape⁵, and clusterMaker⁶ provide support to animate through the columns of a heat map. DynNetwork (http://apps.cytoscape.org/apps/dynnetwork) reads specially constructed input files that specifically encodes changes to the network over time. Of these, only clusterMaker2 and DynNetwork are available in Cytoscape 3, and offer relatively limited restrictive animation capabilities (in the case of clusterMaker2) or require construction of special input files in advance (in the case of DynNetwork). None of the available tools allows for the animation of arbitrary changes to the network topology or visualization.

CyAnimator attempts to fill this gap by providing a tool that supports animation by allowing the user to designate particular network views as “key frames”. These frames represent the state of the network at particular moments in time including the current list of nodes and edges and the visual attributes of those nodes and edges. The user may then arrange those frames in a desired sequence and CyAnimator will interpolate between the frames resulting in a smooth animation between the states of the network. The resulting animation may be saved as a movie.

Methods

Implementation

The main object in CyAnimator is a CyFrame, which contains all of the information about the visual attributes of the network background, annotations, nodes, and edges. This information is stored in a series of maps indexed by the network, node, edge or annotation object. CyAnimator makes heavy use of the visual property system in Cytoscape and the pseudocode for the general loop for populating a CyFrame is:

getNetworkVisualProperties();
foreach Node:
   getNodeVisualProperties();
foreach Edge:
   getEdgeVisualProperties();
foreach Annotation:
   getAnnotationVisualProperties();
getImage();

The captured image is used to show thumbnails to the user in the CyAnimator dialog (see below). The result of the above pseudocode is the creation of 4 maps:

Map<CyNode, Map<VisualProperty<?>, Object>> nodePropertyMap;
Map<CyEdge, Map<VisualProperty<?>, Object>> edgePropertyMap;
Map<CyNetwork, Map<VisualProperty<?>, Object>> networkPropertyMap;
Map<Annotation, Map<VisualProperty<?>, Object>> annotationPropertyMap;

When the user clicks on a frame in the CyAnimator dialog or during the animation, the stored visual properties are mapped onto the current network. This is a straightforward mapping except in circumstances where the current network does not have the node, edge, or annotation that the stored CyFrame had or the CyFrame did not have a node, edge, or annotation that the current network has. In the first case, the missing object is added to the network and styled using the stored information. This approach depends on the fact that deleted nodes and edges are not removed from the CyRootNetwork (the root of the network collection), so the topology of the network at the time the CyFrame was stored may be recreated. In the second case, the CyFrame sets the visibility of the object to false, hiding that object, and resulting in a network view that is consistent with the saved visual properties.

Interpolation between CyFrames is handled by the Interpolator, which maintains lists of interpolators for node visual attributes, edge visual attributes, annotation visual attributes, and network visual attributes. The Interpolator makeFrames() method takes as input the list of CyFrames, the user saved (key frames) and returns an array of frames that includes interpolations between each pair of key frames. So, if the user has requested 30 frames between each key frame, and created 5 key frames, makeFrames(), will return 121 frames, which is the number of key frames to interpolate between (key frames - 1), multiplied by the number of interpolations between each key frame, plus the initial key frame ((keyframes - 1)*interpolations + 1).

CyAnimator currently supports several different interpolators:

Color	Colors are linearly interpolated between the two key frames. Color interpolation may include interpolation of transparency using a Bezier to provide more natural fade-in/fade-out
Size	Linear interpolation of numerical values (usually sizes) between the two key frames.
Transparency	Linear interpolation of transparency values
ObjectPosition	Special interpolator for changes in label and custom graphics positions. Doesn’t support changes in justification or object anchor.
Position	Linearly interpolate changes in X,Y position of objects
Crossfade	For properties that can not be easily interpolated (e.g. node shape), fades the object out, then fades it in with the new property
CustomGraphicsCrossfade	Crossfade between two custom graphics.
Visible	Fades an object in or out if the visibility changes
None	This visual attribute is not interpolated.

Table 1 shows the interpolated visual attributes and the type of interpolation.

Table 1. Visual Property Interpolations.

Object Type	Visual Attributes	Interpolation
Network	Background Paint	Color
	X, Y, and Z Location	Position
	Depth, Height, Scale Factor, Size, and Width	Size
Node	Border Paint, Fill Color, Label Color	Color
	Border Transparency, Label Transparency, Transparency	Transparency
	Border Width, Height, Width, Size, Label Size, Custom Graphics Size (1–9)	Size
	X, Y, and Z Location	Position
	Shape, Label, Font Face,	CrossFade
	Label Position, Custom Graphics Position (1-9)	ObjectPosition
	Custom Graphics (1–9)	CustomGraphicsCrossfade
	Nested Network Visible	None
	Visible	Visible
Edge	Label Color, Paint	Color
	Label, Font Face, Line Type,	Crossfade
	Label Transparency, Transparency	Transparency
	Width, Label Size	Size
	Visible	Visible
Annotations	X and Y Location	Position
	Zoom, Width, Height, Border Width, Font Size, Image Contrast, Image Brightness, Arrow Source Size, Arrow Width, Arrow Target Size	Size
	Color, Font Color, Border Color, Arrow Source Color, Arrow Target Color, Arrow Color	Color
	Opacity, Image Opacity	Transparency
	Shape, Text, Font Style, Font Family, Image URL, Arrow Source Anchor, Arrow Target Anchor, Arrow Source Type, Arrow Target Type	Crossfade
	Canvas	None

To implement the creation of a movie, three different mechanisms are used. In each case, an image file is created for each interpolated frame. One option the user has is to just write out the individual frames and allow them to use whatever movie making tool they desire. We have also implemented an animated GIF writer using the native Java ImageIO library. Finally, for creating MP4 movies with the H.264 codec, we utilize the JCodec (http://jcodec.org/) Java library, which includes the necessary video codecs.

CyAnimator is not able to handle all visual properties, however. Currently edge bends are not correctly interpolated and neither are certain changes in label position (particularly those that require knowledge of the rendered width or height). Furthermore, with the introduction of multiple back-end renderers in Cytoscape 3.2 and 3.3, it’s not clear how well CyAnimator will work with other renderer implementations.

Operation

To bring up CyAnimator select Apps→CyAnimator. This will bring up an empty CyAnimator dialog (Figure 1). Note that CyAnimator is only able to animate between networks in the same network collection (In Cytoscape 3, a Network Collection contains multiple networks which possibly share nodes and edges). Starting CyAnimator on a new network collection will create a new, empty, CyAnimator dialog. Once a CyAnimator dialog is open, the general workflow is to manipulate the network to what you want it to look like at the start of your movie, then select to add the frame to CyAnimator. Once the frame has been added, modify your network to what you want it to look like in the next frame of your movie and then again select . Note that CyAnimator will do all of the interpolation to get from one frame to another, so the manipulations of the network can include a variety of changes, including changes in color, position, zoom, annotations, etc. Repeat this process until you are happy with your movie, then simply press the record () button. If you want more time between any two frames, simply drag the image. The timeline is measured in seconds and assumes that 30 frames will be interpolated for each second.

Figure 1. The CyAnimator Dialog showing two key frames.

To support creating and modifying complicated movies, CyAnimator saves all of the frames as part of the session. When you open a Cytoscape session that has been saved with an active CyAnimator timeline, that timeline will be presented when the CyAnimator dialog is presented (Apps→CyAnimator).

CyAnimator dialog

The CyAnimator dialog provides the main interface to CyAnimator, including the following controls:

	Add the current network view as a frame to the animation.
	Remove all currently selected frames
Clear All Frames	Remove all frames from the timeline
	Play the animation by interpolating through each frame.
	Pause the currently playing animation.
	Stop the currently playing animation.
	Step backwards to the previous interpolated frame.
	Step forwards to the next interpolated frame.
	This toggle button controls whether the animation is looped or not. When the button is in, the animation will continue to loop, otherwise, it will stop at the end.
	Bring up the Output Options dialog and record a movie or (optionally) save each of the interpolated frames.
Animation Speed	The speed slider controls the speed of the animation (but is ignored for the recorded movies, which uses it’s own Frames Per Second option.

Clicking on a frame and then dragging it will move the frame in the timeline. Holding down the shift key when clicking and dragging a frame will move all of the frames to the right the same amount. To make a frame current (i.e. show that frame in the Network Window), double-click on the frame. To delete a frame, click on the frame to select it, and press the trash can icon ().

Output options

The Output Options Dialog (see Figure 2) provides the controls to choose the type of video you want to produce, options about the resolution and speed of the video, and the location of the video output.

Figure 2. The Output Options Dialog showing the production of an MP4/H.264 video file at the screen resolution and 30 frames/second.

Video types

Frames. This is the simplest of the video types. This will output each frame as a ".png" file at the requested resolution (see ’Resolution’ below) into the Video location directory specified. To make a movie, you could use any of the standard video packages that accept individual frames (e.g. iMovie on Mac). Note that the Frames Per Second option doesn’t make sense for this output type since we’re only writing individual frames (no time encoding), so this option is disabled (grayed out) in the interface.

GIF. This will output an animated GIF of the interpolated frames. Animated GIF files are easy to show on web sites, but are not the currently accepted standard format. On the other hand, animated GIF files are computationally very easy to produce.

MP4/H.264. This will output a raw MPEG4 file of the interpolated frames. Producing an MP4 can be computationally expensive, and will require more time and memory to complete.

Frame options

Frame rate. This controls the speed of the movie in terms of the number of frames per second. Four frame rates are offered, the two standard frame rates: 25 (PAL) and 29.97 (NTSC), and 30 and 60. The timeline dialog is calibrated at 30 frames per second, so a frame rate of 30 will correspond to the timeline and is a good default unless there is a reason to use one of the standards.

Resolution. This controls the resolution of the output frames. The units are % expansion, so a Resolution of 300 would result in a 300% (or 3X) expansion of the output image. This is extremely important for high-quality videos. We recommend at least a 2X (Resolution of 200) expansion for any published video.

Example movie

A sample movie is provided (see Supplementary_File_1.mov) that was created with CyAnimator 2.0.2 and Cytoscape 3.3.0. This movie used galFiltered.cys, which may be located in the sampleData subdirectory of the Cytoscape installation directory (e.g. /Applications/Cytoscape_v3.3.0/sampleData on a Mac). The movie consisted of 13 key frames:

1. the full network using the default style
2. a view focused on MCM1 (YMR043W)
3. that same view using COMMON NAME for the node label and circle for node shape
4. same view as 3, but scaled the node size and node label size by Degree
5. added in some annotations to highlight MCM1
6. Change the node colors using the data from the gal1RGexp column. Color gradient is from blue to yellow. Added a text annotation describing the data
7. the same view as the above – to hold it on the screen
8. The same as #6, but using gal4RGexp as the column
9. Again, use the same frame before to provide some time onscreen
10. The same as #8, but using gal80Gexp as the column
11. Another frame of gal80Gexp
12. This frame uses the custom graphics Chart feature to show all three expression values and shows how custom graphics fade in. The labels were also moved down to avoid the charts
13. another capture frame of the same frame as #12

Conclusions

CyAnimator is an important addition to the suite of Cytoscape apps. It provides an easy tool to interpolate between different states of a network and may be used to animate changes over time, condition, or treatment. In the future, we will be adding support for visualization engines other than current default, including the ability to animate 3D renderers.

Software availability

Author contributions

JHM wrote the manuscript and enhanced the app. SF developed initial version of the app for Cytoscape 2.8. VD ported the app to Cytoscape 3. AP and TF supervised app development and provided input on the manuscript.

Competing interests

No competing interests were disclosed.

Grant information

JHM was funded by NIGMS grants P41-GM103504 and P41-GM103311. TF is funded by NIGMS grant P41-GM103311. AP is funded by NIGMS grant P41-GM103504.

Acknowledgments

The authors wish to acknowledge the support of the NRNB Academy.

Supplementary material

Sample movie created with CyAnimator and Cytoscape 3.3. This movie used galFiltered.cys, which may be located in the sampleData subdirectory of the Cytoscape installation directory (e.g. /Applications/Cytoscape_v3.3.0/sampleData on a Mac) as a starting point.

Click here to access the data.

See below for the saved session file.

http://dx.doi.org/10.5256/f1000research.6852.s110143

Click here to access the data.

Session file used to create the sample video.

The session file saved with the timeline used to create the sample video.

http://dx.doi.org/10.5256/f1000research.6852.s110145

Click here to access the data.

Faculty Opinions recommended

References

1. Simons DJ, Ambinder MS: Change blindness: theory and consequences. Curr Dir Psychol Sci. 2005; 14(1): 44–48. Publisher Full Text
2. Shannon P, Markiel A, Ozier O, et al.: Cytoscape: a software environment for integrated models of biomolecular interaction networks. Genome Res. 2003; 13(11): 2498–2504. PubMed Abstract | Publisher Full Text | Free Full Text
3. Pico AR, Bader GD, Demchak B, et al.: The Cytoscape app article collection [version 1; referees: not peer reviewed]. F1000Res. 2014; 3: 138. PubMed Abstract | Publisher Full Text | Free Full Text
4. Kincaid R, Kuchinsky A, Creech M: VistaClara: an expression browser plug-in for Cytoscape. Bioinformatics. 2008; 24(18): 2112–2114. PubMed Abstract | Publisher Full Text | Free Full Text
5. Wang Q: 3DScape: three dimensional visualization plug-in for Cytoscape. Nature Precedings. 2011. Reference Source
6. Morris JH, Apeltsin L, Newman AM, et al.: clusterMaker: a multi-algorithm clustering plugin for Cytoscape. BMC Bioinformatics. 2011; 12(1): 436. PubMed Abstract | Publisher Full Text | Free Full Text
7. Morris S, Dhameliya V, Wu A, et al.: CyAnimator v2: Simple Animations of Cytoscape Networks. Zenodo. 2015. Data Source

Comments on this article Comments (0)

Version 2

VERSION 2 PUBLISHED 05 Aug 2015

Author details Author details

Competing interests

No competing interests were disclosed.

Grant information

JHM was funded by NIGMS grants P41-GM103504 and P41-GM103311. TF is funded by NIGMS grant P41-GM103311. AP is funded by NIGMS grant P41-GM103504.

Article Versions (2)

version 2

Revised

Published: 30 Dec 2015, 4:482

https://doi.org/10.12688/f1000research.6852.2

version 1

Published: 05 Aug 2015, 4:482

https://doi.org/10.12688/f1000research.6852.1

© 2015 Morris JH et al. This is an open access article distributed under the terms of the Creative Commons Attribution License, which permits unrestricted use, distribution, and reproduction in any medium, provided the original work is properly cited. Data associated with the article are available under the terms of the Creative Commons Zero "No rights reserved" data waiver (CC0 1.0 Public domain dedication).

Download

Export To

metrics

	Views	Downloads
F1000Research	-	-
PubMed Central Data from PMC are received and updated monthly.	-	-

Citations

SEE MORE DETAILS

CITE

how to cite this article

Morris JH, Vijay D, Federowicz S et al. CyAnimator: Simple Animations of Cytoscape Networks [version 2; peer review: 3 approved] F1000Research 2015, 4:482 (https://doi.org/10.12688/f1000research.6852.2)

NOTE: it is important to ensure the information in square brackets after the title is included in all citations of this article.

track

receive updates on this article

Track an article to receive email alerts on any updates to this article.

Open Peer Review

Current Reviewer Status: ?

Key to Reviewer Statuses VIEW HIDE

ApprovedThe paper is scientifically sound in its current form and only minor, if any, improvements are suggested

Approved with reservations A number of small changes, sometimes more significant revisions are required to address specific details and improve the papers academic merit.

Not approvedFundamental flaws in the paper seriously undermine the findings and conclusions

Version 2

VERSION 2

PUBLISHED 30 Dec 2015

Revised

Views

Reviewer Report 01 Apr 2016

Nathan Salomonis, Cincinnati Children's Hospital Medical Center Research Foundation, Cincinnati, OH, USA

Approved

https://doi.org/10.5256/f1000research.8183.r11744

The authors of CyAnimator described an enhanced and improved version of the software (version 2). These improvements include an advanced and intuitive interface for controlling the animations and improved software architecture to ensure maintainability. Extensive documentation and methods description are ... Continue reading

CITE

Report a concern

Respond or Comment

Views

Reviewer Report 11 Feb 2016

Piet Molenaar, Academic Medical Center, Amsterdam, The Netherlands

Approved

https://doi.org/10.5256/f1000research.8183.r12291

The CyAnimator app is a valuable addition to the Cytoscape network visualization tool. Cytoscape itself doesn't provide animation capabilities and the authors rightfully state that animation can provide additional insights for researchers.

There is some flickering visible while animating (nodes appearing and disappearing behind other nodes) but this apparently has to do with the current rendering engine. In future implementations it is expected that these issues will be solved.

Competing Interests: No competing interests were disclosed.

I confirm that I have read this submission and believe that I have an appropriate level of expertise to confirm that it is of an acceptable scientific standard.

CITE

Report a concern

Respond or Comment

Version 1

VERSION 1

PUBLISHED 05 Aug 2015

Views

Reviewer Report 02 Sep 2015

Nathan Salomonis, Cincinnati Children's Hospital Medical Center Research Foundation, Cincinnati, OH, USA

Approved with Reservations

https://doi.org/10.5256/f1000research.7370.r10174

The authors present a useful Cytoscape app that fills in an important void not provided by the parent application: dynamically transitioning between distinct network states or associated visualized datasets. The application is thus novel and provides an important function in Cytoscape that could significantly assist with biological interpretation.

Major Point 1: The authors state: “Note that CyAnimator is only able to animate between networks in the same network collection.”

Can a network collection be different networks that share some or all of the same nodes? If not, I understand how this could be a technical limitation of the app, but would be of particular use when curating distinct pathway states from an original network. Often, adding, subtracting, moving and re-coloring nodes in succession to different states in the same network instances is challenging, but storing these as distinct snap shots that can be animated together is extremely powerful. If not present, is this a future option?

Major Point 2: The shown movie is a reasonable simple demonstration of CyAnimator, however, this does not show of the more interesting dynamic options of the tools, such as transitioning between different developmental or temporal states (node color attributes, aka gene expression fold differences) or temporally distinct interactions for a given pathway (e.g., chain of metabolic events). While I realize this would be some work to do, this would more strongly demonstrate the capabilities of the software.

Minor Point: One of the powerful uses of this software would be via programmatic generation of animations, by defining network states and visual parameters. While I know that some of these capabilities are embedded in Cytoscape 3, are these possible within CyAnimator for the purpose of making animations outside of the UI? If so, can the authors provide an example set of code to do this? A link to documentation or a tutorial would also be helpful for the end-users to properly use the software.

Competing Interests: No competing interests were disclosed.

I confirm that I have read this submission and believe that I have an appropriate level of expertise to confirm that it is of an acceptable scientific standard, however I have significant reservations, as outlined above.

CITE

Report a concern

Author Response 30 Dec 2015

Scooter Morris, Resource for Biocomputing, Visualization and Informatics,, University of California, San Francisco, 94143, USA

30 Dec 2015

Author Response

Thank you for your review. I have just submitted version 2 of the CyAnimator paper, which corresponds to the latest release of the App on the Cytoscape App store. The ... Continue reading Thank you for your review. I have just submitted version 2 of the CyAnimator paper, which corresponds to the latest release of the App on the Cytoscape App store. The new app version is a significant rewrite and offers several advantages over the previous version, which I believe address move of your concerns. To answer point-by-point:

Major Point 1: The authors state: “Note that CyAnimator is only able to animate between networks in the same network collection.”

Can a network collection be different networks that share some or all of the same nodes? If not, I understand how this could be a technical limitation of the app, but would be of particular use when curating distinct pathway states from an original network. Often, adding, subtracting, moving and re-coloring nodes in succession to different states in the same network instances is challenging, but storing these as distinct snap shots that can be animated together is extremely powerful. If not present, is this a future option?

Yes, a network collection in Cytoscape 3 includes multiple networks that share nodes and edges. Essentially, a network collection can be thought of as a set of projections of a single network, very similar to the Cytoscape 2 model. Cytoscape 3 allows users to create multiple network collections and the nodes and edges aren't shared between them. Both versions of the App support this capability.

Major Point 2: The shown movie is a reasonable simple demonstration of CyAnimator, however, this does not show of the more interesting dynamic options of the tools, such as transitioning between different developmental or temporal states (node color attributes, aka gene expression fold differences) or temporally distinct interactions for a given pathway (e.g., chain of metabolic events). While I realize this would be some work to do, this would more strongly demonstrate the capabilities of the software.

The sample movie has been updated as suggested to show three different expression fold changes and a heat strip representation showing all three at once.

Minor Point: One of the powerful uses of this software would be via programmatic generation of animations, by defining network states and visual parameters. While I know that some of these capabilities are embedded in Cytoscape 3, are these possible within CyAnimator for the purpose of making animations outside of the UI? If so, can the authors provide an example set of code to do this? A link to documentation or a tutorial would also be helpful for the end-users to properly use the software.

This version of the App introduces some simple commands that may be used by app developers to create frames. At this point, the capability remains somewhat rudimentary and doesn't allow programmatic changes to frame ordering or transition duration. This will be added in a future version and more detailed documentation will be written at that time.
Thank you for your review. I have just submitted version 2 of the CyAnimator paper, which corresponds to the latest release of the App on the Cytoscape App store. The new app version is a significant rewrite and offers several advantages over the previous version, which I believe address move of your concerns. To answer point-by-point:

Major Point 1: The authors state: “Note that CyAnimator is only able to animate between networks in the same network collection.”

Can a network collection be different networks that share some or all of the same nodes? If not, I understand how this could be a technical limitation of the app, but would be of particular use when curating distinct pathway states from an original network. Often, adding, subtracting, moving and re-coloring nodes in succession to different states in the same network instances is challenging, but storing these as distinct snap shots that can be animated together is extremely powerful. If not present, is this a future option?

Yes, a network collection in Cytoscape 3 includes multiple networks that share nodes and edges. Essentially, a network collection can be thought of as a set of projections of a single network, very similar to the Cytoscape 2 model. Cytoscape 3 allows users to create multiple network collections and the nodes and edges aren't shared between them. Both versions of the App support this capability.

Major Point 2: The shown movie is a reasonable simple demonstration of CyAnimator, however, this does not show of the more interesting dynamic options of the tools, such as transitioning between different developmental or temporal states (node color attributes, aka gene expression fold differences) or temporally distinct interactions for a given pathway (e.g., chain of metabolic events). While I realize this would be some work to do, this would more strongly demonstrate the capabilities of the software.

The sample movie has been updated as suggested to show three different expression fold changes and a heat strip representation showing all three at once.

Minor Point: One of the powerful uses of this software would be via programmatic generation of animations, by defining network states and visual parameters. While I know that some of these capabilities are embedded in Cytoscape 3, are these possible within CyAnimator for the purpose of making animations outside of the UI? If so, can the authors provide an example set of code to do this? A link to documentation or a tutorial would also be helpful for the end-users to properly use the software.

This version of the App introduces some simple commands that may be used by app developers to create frames. At this point, the capability remains somewhat rudimentary and doesn't allow programmatic changes to frame ordering or transition duration. This will be added in a future version and more detailed documentation will be written at that time.
Competing Interests: No competing interests were disclosed. Close
Report a concern
Respond or Comment

COMMENTS ON THIS REPORT

Author Response 30 Dec 2015

Scooter Morris, Resource for Biocomputing, Visualization and Informatics,, University of California, San Francisco, 94143, USA

30 Dec 2015

Author Response

Thank you for your review. I have just submitted version 2 of the CyAnimator paper, which corresponds to the latest release of the App on the Cytoscape App store. The ... Continue reading Thank you for your review. I have just submitted version 2 of the CyAnimator paper, which corresponds to the latest release of the App on the Cytoscape App store. The new app version is a significant rewrite and offers several advantages over the previous version, which I believe address move of your concerns. To answer point-by-point:

Major Point 1: The authors state: “Note that CyAnimator is only able to animate between networks in the same network collection.”

Can a network collection be different networks that share some or all of the same nodes? If not, I understand how this could be a technical limitation of the app, but would be of particular use when curating distinct pathway states from an original network. Often, adding, subtracting, moving and re-coloring nodes in succession to different states in the same network instances is challenging, but storing these as distinct snap shots that can be animated together is extremely powerful. If not present, is this a future option?

Yes, a network collection in Cytoscape 3 includes multiple networks that share nodes and edges. Essentially, a network collection can be thought of as a set of projections of a single network, very similar to the Cytoscape 2 model. Cytoscape 3 allows users to create multiple network collections and the nodes and edges aren't shared between them. Both versions of the App support this capability.

Major Point 2: The shown movie is a reasonable simple demonstration of CyAnimator, however, this does not show of the more interesting dynamic options of the tools, such as transitioning between different developmental or temporal states (node color attributes, aka gene expression fold differences) or temporally distinct interactions for a given pathway (e.g., chain of metabolic events). While I realize this would be some work to do, this would more strongly demonstrate the capabilities of the software.

The sample movie has been updated as suggested to show three different expression fold changes and a heat strip representation showing all three at once.

Minor Point: One of the powerful uses of this software would be via programmatic generation of animations, by defining network states and visual parameters. While I know that some of these capabilities are embedded in Cytoscape 3, are these possible within CyAnimator for the purpose of making animations outside of the UI? If so, can the authors provide an example set of code to do this? A link to documentation or a tutorial would also be helpful for the end-users to properly use the software.

This version of the App introduces some simple commands that may be used by app developers to create frames. At this point, the capability remains somewhat rudimentary and doesn't allow programmatic changes to frame ordering or transition duration. This will be added in a future version and more detailed documentation will be written at that time.
Thank you for your review. I have just submitted version 2 of the CyAnimator paper, which corresponds to the latest release of the App on the Cytoscape App store. The new app version is a significant rewrite and offers several advantages over the previous version, which I believe address move of your concerns. To answer point-by-point:

Major Point 1: The authors state: “Note that CyAnimator is only able to animate between networks in the same network collection.”

Can a network collection be different networks that share some or all of the same nodes? If not, I understand how this could be a technical limitation of the app, but would be of particular use when curating distinct pathway states from an original network. Often, adding, subtracting, moving and re-coloring nodes in succession to different states in the same network instances is challenging, but storing these as distinct snap shots that can be animated together is extremely powerful. If not present, is this a future option?

Yes, a network collection in Cytoscape 3 includes multiple networks that share nodes and edges. Essentially, a network collection can be thought of as a set of projections of a single network, very similar to the Cytoscape 2 model. Cytoscape 3 allows users to create multiple network collections and the nodes and edges aren't shared between them. Both versions of the App support this capability.

Major Point 2: The shown movie is a reasonable simple demonstration of CyAnimator, however, this does not show of the more interesting dynamic options of the tools, such as transitioning between different developmental or temporal states (node color attributes, aka gene expression fold differences) or temporally distinct interactions for a given pathway (e.g., chain of metabolic events). While I realize this would be some work to do, this would more strongly demonstrate the capabilities of the software.

The sample movie has been updated as suggested to show three different expression fold changes and a heat strip representation showing all three at once.

Minor Point: One of the powerful uses of this software would be via programmatic generation of animations, by defining network states and visual parameters. While I know that some of these capabilities are embedded in Cytoscape 3, are these possible within CyAnimator for the purpose of making animations outside of the UI? If so, can the authors provide an example set of code to do this? A link to documentation or a tutorial would also be helpful for the end-users to properly use the software.

This version of the App introduces some simple commands that may be used by app developers to create frames. At this point, the capability remains somewhat rudimentary and doesn't allow programmatic changes to frame ordering or transition duration. This will be added in a future version and more detailed documentation will be written at that time.
Competing Interests: No competing interests were disclosed. Close
Report a concern

Views

Reviewer Report 18 Aug 2015

Giovanni Scardoni, Center for BioMedical Computing, University of Verona, Verona, Italy

Approved

https://doi.org/10.5256/f1000research.7370.r9880

The App is very useful and easy to use. As the article highlights It is very important to have a tool allowing the user to create animations from static frames of a network, and there are no other Cytoscape apps with the same characteristics of CyAnimator. The paper is well written and both implementation and features are easy to understand.

Minor changes:

The sentence about the future implementation of the maps in the implementation section should be moved to the conclusions session or to the supplementary materials. So the reader can concentrate on the current features of the app.
Similarly, the last sentence of the conclusions sounds better as "The ability to save the key frames of an animation as part of a session will be added .....".

Competing Interests: No competing interests were disclosed.

I confirm that I have read this submission and believe that I have an appropriate level of expertise to confirm that it is of an acceptable scientific standard.

CITE

Report a concern

Respond or Comment

Comments on this article Comments (0)

Version 2

VERSION 2 PUBLISHED 05 Aug 2015

Open Peer Review

Reviewer Status

Reviewer Reports

	Invited Reviewers
	1	2	3
Version 2 (revision) 30 Dec 15		read	read
Version 1 05 Aug 15	read	read

Giovanni Scardoni, University of Verona, Verona, Italy
Nathan Salomonis, Cincinnati Children's Hospital Medical Center Research Foundation, Cincinnati, USA
Piet Molenaar, Academic Medical Center, Amsterdam, The Netherlands

Comments on this article

All Comments(0)

Add a comment

Browse by related subjects

Back to all reports

Reviewer Report

3 Views

01 Apr 2016 | for Version 2

Nathan Salomonis, Cincinnati Children's Hospital Medical Center Research Foundation, Cincinnati, OH, USA

3 Views Cite this report Responses(0)

Approved

Competing Interests

No competing interests were disclosed.

I confirm that I have read this submission and believe that I have an appropriate level of expertise to confirm that it is of an acceptable scientific standard.

Respond to this report

Responses (0)

Back to all reports

Reviewer Report

6 Views

11 Feb 2016 | for Version 2

Piet Molenaar, Academic Medical Center, Amsterdam, The Netherlands

6 Views Cite this report Responses(0)

Approved

Competing Interests

No competing interests were disclosed.

I confirm that I have read this submission and believe that I have an appropriate level of expertise to confirm that it is of an acceptable scientific standard.

Respond to this report

Responses (0)

Back to all reports

Reviewer Report

26 Views

02 Sep 2015 | for Version 1

Nathan Salomonis, Cincinnati Children's Hospital Medical Center Research Foundation, Cincinnati, OH, USA

26 Views Cite this report Responses(1)

Approved With Reservations

Competing Interests

No competing interests were disclosed.

Respond to this report

Responses (1)

Author Response

30 Dec 2015

Scooter Morris, Resource for Biocomputing, Visualization and Informatics,, University of California, San Francisco, 94143, USA

Thank you for your review. I have just submitted version 2 of the CyAnimator paper, which corresponds to the latest release of the App on the Cytoscape App store. The new app version is a significant rewrite and offers several advantages over the previous version, which I believe address move of your concerns. To answer point-by-point:

Major Point 1: The authors state: “Note that CyAnimator is only able to animate between networks in the same network collection.”

Can a network collection be different networks that share some or all of the same nodes? If not, I understand how this could be a technical limitation of the app, but would be of particular use when curating distinct pathway states from an original network. Often, adding, subtracting, moving and re-coloring nodes in succession to different states in the same network instances is challenging, but storing these as distinct snap shots that can be animated together is extremely powerful. If not present, is this a future option?

Yes, a network collection in Cytoscape 3 includes multiple networks that share nodes and edges. Essentially, a network collection can be thought of as a set of projections of a single network, very similar to the Cytoscape 2 model. Cytoscape 3 allows users to create multiple network collections and the nodes and edges aren't shared between them. Both versions of the App support this capability.

Major Point 2: The shown movie is a reasonable simple demonstration of CyAnimator, however, this does not show of the more interesting dynamic options of the tools, such as transitioning between different developmental or temporal states (node color attributes, aka gene expression fold differences) or temporally distinct interactions for a given pathway (e.g., chain of metabolic events). While I realize this would be some work to do, this would more strongly demonstrate the capabilities of the software.

The sample movie has been updated as suggested to show three different expression fold changes and a heat strip representation showing all three at once.

Minor Point: One of the powerful uses of this software would be via programmatic generation of animations, by defining network states and visual parameters. While I know that some of these capabilities are embedded in Cytoscape 3, are these possible within CyAnimator for the purpose of making animations outside of the UI? If so, can the authors provide an example set of code to do this? A link to documentation or a tutorial would also be helpful for the end-users to properly use the software.

This version of the App introduces some simple commands that may be used by app developers to create frames. At this point, the capability remains somewhat rudimentary and doesn't allow programmatic changes to frame ordering or transition duration. This will be added in a future version and more detailed documentation will be written at that time.

View more View less

Competing Interests

No competing interests were disclosed.

Back to all reports

Reviewer Report

23 Views

18 Aug 2015 | for Version 1

Giovanni Scardoni, Center for BioMedical Computing, University of Verona, Verona, Italy

23 Views Cite this report Responses(0)

Approved

The sentence about the future implementation of the maps in the implementation section should be moved to the conclusions session or to the supplementary materials. So the reader can concentrate on the current features of the app.
Similarly, the last sentence of the conclusions sounds better as "The ability to save the key frames of an animation as part of a session will be added .....".

Competing Interests

No competing interests were disclosed.

I confirm that I have read this submission and believe that I have an appropriate level of expertise to confirm that it is of an acceptable scientific standard.

Respond to this report

Responses (0)

Alongside their report, reviewers assign a status to the article:

Approved - the paper is scientifically sound in its current form and only minor, if any, improvements are suggested

Approved with reservations - A number of small changes, sometimes more significant revisions are required to address specific details and improve the papers academic merit.

Not approved - fundamental flaws in the paper seriously undermine the findings and conclusions

[1] 1. Simons DJ, Ambinder MS: Change blindness: theory and consequences. Curr Dir Psychol Sci. 2005; 14(1): 44–48. Publisher Full Text

[2] 2. Shannon P, Markiel A, Ozier O, et al.: Cytoscape: a software environment for integrated models of biomolecular interaction networks. Genome Res. 2003; 13(11): 2498–2504. PubMed Abstract | Publisher Full Text | Free Full Text

[3] 3. Pico AR, Bader GD, Demchak B, et al.: The Cytoscape app article collection [version 1; referees: not peer reviewed]. F1000Res. 2014; 3: 138. PubMed Abstract | Publisher Full Text | Free Full Text

[4] 4. Kincaid R, Kuchinsky A, Creech M: VistaClara: an expression browser plug-in for Cytoscape. Bioinformatics. 2008; 24(18): 2112–2114. PubMed Abstract | Publisher Full Text | Free Full Text

[5] 5. Wang Q: 3DScape: three dimensional visualization plug-in for Cytoscape. Nature Precedings. 2011. Reference Source

[6] 6. Morris JH, Apeltsin L, Newman AM, et al.: clusterMaker: a multi-algorithm clustering plugin for Cytoscape. BMC Bioinformatics. 2011; 12(1): 436. PubMed Abstract | Publisher Full Text | Free Full Text

[7] 7. Morris S, Dhameliya V, Wu A, et al.: CyAnimator v2: Simple Animations of Cytoscape Networks. Zenodo. 2015. Data Source

CyAnimator: Simple Animations of Cytoscape Networks

Abstract

Keywords

Revised Amendments from Version 1

Introduction

Methods

Implementation

Table 1. Visual Property Interpolations.

Operation

Figure 1. The CyAnimator Dialog showing two key frames.

CyAnimator dialog

Output options

Figure 2. The Output Options Dialog showing the production of an MP4/H.264 video file at the screen resolution and 30 frames/second.

Video types

Frame options

Example movie

Conclusions

Software availability

Software available from

Latest source code

Archived source code as at the time of publication

License: Lesser GNU Public License 3.0

Author contributions

Competing interests

Grant information

Acknowledgments

Supplementary material

References

Comments on this article Comments (0)

Open Peer Review

Comments on this article Comments (0)

Open Peer Review

Reviewer Status

Reviewer Reports

Comments on this article

Browse by related subjects

Competing Interests Policy

Stay Updated