¶ Gas Data Analysis - User Manual
¶ Overview
The Gas Data Analysis page allows users to select measurements from gas monitoring equipment and launch detailed analysis over specific time periods.
Figure 1: Initial view of the Gas Data Analysis page showing the Time Frame Selector
¶ Getting Started
¶ 1. Time Frame Selection
- First Step: Select your analysis time period using the Time Frame Selector
- This is the only section visible when you first load the page
- Once you set a time frame, additional options will appear
!
Figure 2: Time Frame Selector with date picker controls
¶ 2. Selection Mode
After setting a time frame, you can choose between two selection modes:
!
Figure 3: Radio buttons for choosing between "Select by Groups" and "Select by Assets"
¶ Option A: Select by Groups
- Use Case: When you want to analyze multiple related assets organized into logical groups
- Steps:
- Select "Select by Groups" radio button
- Choose one or more groups from the dropdown
- Use "Select All Groups" to quickly select everything
- Use "Deselect All Groups" to clear selections
!
Figure 4: Group selection dropdown with available groups and control buttons
¶ Option B: Select by Assets
- Use Case: When you want to analyze specific individual assets
- Steps:
- Select "Select by Assets" radio button
- Use the asset search to find and add specific assets
- Selected assets appear as removable chips
- Click the X on any chip to remove that asset
Figure 5: Asset search interface with selected assets shown as removable chips
¶ 3. Measurement Selection
Once you've selected groups or assets:
- A measurements table will appear showing all available measurements
- The table displays:
- Measurement Name: The parameter being measured
- Asset Name: Which equipment the measurement comes from
- Event Count: How many data points are available
- Description: Additional details about the measurement
Figure 6: Measurements table showing available measurements with their details
¶ Selection Controls:
- Individual Selection: Check boxes next to specific measurements
- Select All Pages: Selects all measurements across all table pages
- Deselect All Pages: Clears all selections across all table pages
Figure 7: "Select All Pages" and "Deselect All Pages" buttons above the measurements table
Important: Regular checkboxes only affect the current page. Use the buttons above the table to select/deselect across all pages.
¶ 4. Launch Analysis
- Click the yellow "Launch Analysis" button when ready
- The system will validate your selections and navigate to the detailed events view
- You'll see a confirmation showing how many measurements were analyzed
Figure 8: Yellow "Launch Analysis" button in enabled state
¶ Navigation Flow
Time Frame Selection → Group/Asset Selection → Measurement Selection → Launch Analysis → Events Page
¶ Key Features
¶ URL State Management
- Your selections are automatically saved in the URL
- You can bookmark or share analysis configurations
- Returning to the same URL restores your previous selections
¶ Real-time Validation
- The system shows loading indicators while fetching data
- Error messages appear if there are issues
- Success messages confirm when operations complete
Figure 9: Loading indicators shown while fetching measurement data
¶ Smart Defaults
- When selecting groups/assets, all related measurements are selected by default
- This saves time for common analysis scenarios
¶ Tips for Efficient Use
- Start Broad: Begin with group selection if you're unsure which specific assets to analyze
- Use Time Frames Strategically: Longer periods provide more data but may take longer to process
- Check Event Counts: Measurements with zero events won't provide useful analysis
- Save Configurations: Bookmark commonly used analysis setups using the URL
¶ Troubleshooting
No measurements appear: Check that your selected groups/assets have associated equipment with gas sensors
Analysis button disabled: Ensure you've selected both a time frame and at least one measurement
Loading takes too long: Try reducing the time frame or number of selected measurements
¶ Technical Details
¶ Component Structure
Based on the Vue.js component analysis:
- Time Frame Selector: Custom component for date range selection
- Selection Mode Toggle: Radio button group for choosing between groups/assets
- Asset Search: Reusable component for finding specific assets
- Measurements Table: Data table with pagination and selection controls
- Launch Analysis: Navigation handler that constructs query parameters
¶ Data Flow
- User selects time frame →
timeFrameAppliedflag set to true - User chooses selection mode → clears previous selections
- Groups/Assets selected → triggers measurement loading
- Measurements loaded → displayed in paginated table
- User selects measurements → stored in reactive array
- Launch Analysis → constructs URL parameters and navigates to events page
¶ URL Parameters
The application automatically manages these URL parameters:
startDate,endDate: Selected time frameselectionMode: "group" or "asset"groupUids: Array of selected group identifiersassetUids: Array of selected asset identifiersmeasurementUids: Array of selected measurement identifiers
¶ Error Handling
- Form validation before analysis launch
- Loading states during data fetching
- User-friendly error messages for common issues
- Automatic cleanup of invalid selections