# Time lapse mode Time lapse mode in NimbusImage provides powerful capabilities for tracking and analyzing objects across time points. This feature is particularly useful for cell tracking, movement analysis, and other time-dependent studies. ## Enabling Time lapse mode When working with time lapse datasets, the Time lapse mode option automatically becomes available in the interface:
1. Look for the "Time lapse mode" checkbox in the variable navigation panel 2. Check the box to enable tracking visualization and special time lapse features When enabled, Time lapse mode shows additional options:
## Understanding tracks and connections In Time lapse mode, objects are connected across time points to form "tracks" that represent the same biological entity (like a cell) over time. ### Visualizing tracks Tracks appear as connected lines between objects across different time points: Key features of track visualization: * **Current time point**: The current time point is highlighted with "Curr T=X" label and typically appears larger * **Connected objects**: All objects connected to the current object are shown as a track * **Time labels**: Each object shows its time point (T=1, T=7, etc.). These labels are clickable to take you right to that time point. * **Connection colors**: * **Colored connections**: Normal connections between consecutive time points. Each color represents a different track. * **Red connections**: Connections that skip time points (track connecting from e.g. t=8 to t=10) * **Line thickness**: Forward-in-time connections are thicker than backward-in-time connections ### Track window setting The "Track window" slider controls how many time points before and after the current time point are shown in the track visualization: * Higher values show more of the track's history and future * Lower values focus on just the immediate connections * Adjust based on the density of your data and analysis needs The tags field allows you to only do time-lapse analysis on a subset of objects defined by the specified tags. Delete all timelapse connections will delete all connections made by the "Connect timelapse" tool and also the "Lasso connect". ## Creating and editing tracks ### Using Connect timelapse tool NimbusImage provides a dedicated tool for connecting objects across time: Key settings: * **Object to connect tag**: Select which type of objects to connect (based on their tags) * **Connect across gaps**: Allows connecting objects even when there are missing time points * **Max distance**: Maximum pixel distance between objects in consecutive frames to be considered for connection To use the tool: 1. Create the Tool from the toolset menu 2. Configure the settings 3. Click "COMPUTE" to automatically connect objects based on proximity and settings ### Using Lasso connect for manual tracking One of the most powerful features is the ability to use a lasso tool to manually define tracks: 1. Create a lasso connect tool from the toolset menu 2. Draw a lasso around the objects you want to connect across time 3. NimbusImage will **automatically connect them sequentially by time point** This feature is particularly helpful for: * Connecting "orphaned" objects to existing tracks * Creating new tracks from scratch * Fixing tracking errors where automatic tracking failed Here's an example of connecting up an "orphan" cell at t=8 (orphans are in gray). The track is connected up until t=7 and from t=9 onwards, but sometimes you get a gap in the track because of a missed cell segmentation. Here, we drew in the missing cell manually, but then you want to connect up the track:
Using "Lasso connect", you can just circle (sloppily) all the points in the track, and it will "auto-magically" connect the tracks up sequentially:
## Navigating time with tracks Tracks provide an intuitive way to navigate through time: * **Click on any point in a track** to jump directly to that time point * Use this to quickly inspect the history or future of a specific object * Especially useful when analyzing division events or complex behaviors ## Best practices for time lapse analysis 1. **Start with automatic connections** using the Connect timelapse tool 2. **Review and fix tracks** using the lasso connect tool for any errors 3. **Use track window setting** to adjust visualization density 4. **Enable "Show labels"** to see time point information directly on objects 5. **Create properties** to analyze track information (velocity, displacement, etc.) ## Exporting time lapse data Once you've established tracks, you can: 1. Create properties to measure changes over time 2. Export track data to CSV for further analysis in Python/R 3. Create snapshots to document specific tracking events 4. Download time lapse movies showing your tracks (see [Snapshots](/documentation/snapshots.md) for more details) ## Common applications Time lapse mode is particularly useful for: * Cell migration tracking * Mitotic event analysis * Particle movement studies * Growth measurements over time * Interaction analysis between objects By combining NimbusImage's flexible object tagging system with Time lapse mode, you can create sophisticated tracking analyses that capture the dynamic nature of your biological systems. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.nimbusimage.com/documentation/time-lapse-mode.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.