In GoodVision Video Insights, traffic videos are organized in folders at 3 different levels: Projects -> Locations -> Data Sources.
The three entities you will work with are:
Projects: A general, high-level category for all materials used for overall definitions and enabling the folder structure.
Locations: Mid-level folders used for grouping of particular Data Sources according to user-defined criteria.
Data Sources: A folder for your single-source videos you want to process and analyze. One Data Source is dedicated for one scene/view.
1. Project level
Project is the highest level of the application structure. At the project level, you can set some general characteristics that will be valid for all videos uploaded to the same Project. For example, when creating a new Project you can customize the classification scheme according to your needs. The object classes can be renamed, merged together or completely removed from the scheme. Adjusted classification will then be used through the whole Project.
Picture 1: Creating a new Project
You can also collaborate with your colleagues, clients or providers by sharing the whole project to someone else, who has a GoodVision account. When on the Projects page, click on the three menu dots by a Project and select “Share”.
Picture 2: Sharing a Project
You’ll be asked to enter an email address and choose rights for the collaborator - Read or Read & Write. The collaborator will then get access to view the videos and/or data in the project, possibly upload new videos or perform analyses.
Projects have their own Vault space too. The capacity of the Vault is shared across the entire account, but each Project has a separate storage for video files. Videos uploaded to one Project will thus not be automatically available in other Projects so pay attention to the project structure when organizing the video materials.
If you are new to the Video Insights application, you’ll see an empty black screen and will create a new Project or Projects by clicking on the “+” button on the Projects screen. You can also import a showcase project with some prepared demo material to try the traffic analytics in the platform.
When you are already a GoodVision client with some older processed data, you will still find them under the "My Project" folder on the main Projects page.
Picture 3: Creating a new Project and the possibility to import a demo Project
Under the project, you will then create various Locations and Data Sources for sorting the videos and doing the traffic analysis.
2. Location level
Location represents a set of Data Sources/Cameras sharing a common feature. Locations of a Project can be for example different cities (when the project shall analyse traffic in the whole country/area/district), different city districts (if the project is to run throughout a city) or road/street areas (for modelling traffic on different intersections).
Locations have no predefined settings, feel free to create Locations using your own criteria - by department, by date, by geographical location etc. Doing this will keep your work well-organized. You can always move Data Sources between Locations of the same Project or rename them as you wish.
Location is also a folder for your Data Sources - the camera views of your recordings where the videos will be placed after the successful processing.
Picture 4: A possible locations structure of a demo project
3. Data Source level
Data Source is a subfolder of a Location used for processing of a single video or multiple videos recorded from the same camera. In GoodVision Video Insights, you are always analyzing a video or videos processed in a particular Data Source.
Video files in one Data Source (if there are more than one) shall be from the identical scene with the same viewpoint, data input type and video parameters like resolution or FPS. It is important to remember that one Data Source is dedicated for one scene/view. Usually it is used for batches of shorter video pieces of a longer recording or for cases of several recordings from the same camera but at different times. Imagine your video recordings are split by 1 hour, or you are recording every second week in a month, but you want to analyze the traffic for the whole year. With GoodVision it is possible.
Learn how to upload and process video recordings in this article.
Picture 5: Various Data Sources ready for traffic analysis in one user-defined Location
When the videos are successfully uploaded to the Vault and processed in a Data Source, you can start with the traffic analysis. Just click on the screen of the Data Source with the “Analyze” button and you’ll be navigated to the Describe scene page. That’ s where you will place virtual Lines and Zones, define desired Movements or Events, analyze data and create Reports and Exports. The traffic analysis in GoodVision is generally described in this article.
In the Data Source view, you can also click on the three dots in the upper right corner of a particular Data Source and go to Details to check the video characteristics like Location, input type and device type as well as the metadata like duration, resolution and FPS.
Picture 6: Checking the video data in a Data Source
Under the “Videos” tab you can also check the original video file where you can edit the timeframe of the video. In case you have not chosen to delete the video immediately after upload, you will be able to download the file when needed, or delete it from the Vault.
Picture 7: Editing/deleting the original video file
If the original video file was deleted from the Vault after upload, you can still access and analyze the extracted data from the recording. GoodVision shows the exact vehicle trajectories from the video and displays them in a nice traffic flow pattern:
That’ s also the reason for the need for the identical viewpoint and settings when multiple videos are processed in one Data Source. Imagine what would you see if some of the videos in the same Data Source have shifted viewpoints… yes, the traffic flow patterns would be shifted, most probably not matching each other like in the image below.
To avoid this, always please pay attention to the camera view and try to make sure that the it is not shifted in any way when you want to do the traffic analysis in one Data Source.