You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/timelapse.md
+8-11Lines changed: 8 additions & 11 deletions
Original file line number
Diff line number
Diff line change
@@ -12,15 +12,17 @@ The folder structure is created depending on what you fetch, and you can fetch f
12
12
13
13
All images in an image set will be used to build a timelapse. So for example, if you've collected an entire set of satellite images from the past 2 hours, and run the build timelapse command on that image set, your timelapse will be built of the files from those 2 hours. At the moment, **bomthegov** does not ignore any frames from a collected image set, so whatever images are in the 'images' folder for that ID, is what will be used to build your timelapse.
14
14
15
-
To see a list of available image sets that can be timelapsed, you can run:
15
+
To begin the process of building a timelapse from a list of available images, you can run:
16
16
17
17
`bash bomthegov timelapse list`
18
18
19
-
If you know the ID of the image set you wish to timelapse right away, you can specify it, like so:
19
+
That will show you a list of IDs that are ready to timelapse, and ask you questions about what maximum resolution and Frames Per Second (FPS) rate you want the video to be.
20
+
21
+
If you know the ID of the image set, and you wish to timelapse right away from the command line (with resolution and FPS defaults), you can specify the ID to process, like so:
20
22
21
23
`bash bomthegov timelapse IDR024`
22
24
23
-
and **bomthegov** will start building it immediately.
25
+
and **bomthegov** will start building a timelapse for that ID immediately/uninteractively.
24
26
25
27
26
28
@@ -30,7 +32,7 @@ and **bomthegov** will start building it immediately.
30
32
31
33
The conversion process is likely to be resource-intensive on RAM, CPU, and disk, and depending on how many images need to be converted to video frames, and their original resolution, building the timelapse video may take a long time.
32
34
33
-
Once a timelapse has been successfully created, **bomthegov** will notify you, and then move the collected image set to a folder called '.archive' so that your image collection for that same ID starts "fresh" for a new timelapse from now on. Your previously collected images are not deleted however, they're simply moved to the '.archive' folder inside 'images' where you can either use/merge them again later, or delete them manually if you choose.
35
+
Once a timelapse has been successfully created, **bomthegov** will notify you, and then ask if you would like to remove the ID from the timelapse list/move the collected image set to a folder called '.archive' so that your image collection for that same ID starts "fresh" for a new timelapse. Your previously collected images are not deleted during this process, they're simply compressed into an archive file (TAR), and moved to the '.archive' folder inside 'images' where you can either use/merge them again later, or delete them manually if you choose.
34
36
35
37
You can explore the archived images sets yourself here:
36
38
@@ -48,12 +50,7 @@ Previously prepared timelapse videos will not be deleted in a reset.
48
50
49
51
## Technical details
50
52
51
-
The "Frames Per Second" (FPS) for timelapse videos are currently set as follows:
52
-
53
-
* Radar images timelapse at 10fps,
54
-
* Satellite images timelapse at 25fps.
55
-
56
-
These rates may change in future versions of **bomthegov**.
53
+
The default maximum video resolution and Frames Per Second (FPS) for timelapse videos is 1920x1080 (full HD) at 25fps.
57
54
58
-
Timelapse videos export to MP4 video format, with default settings that should make them streamable on the web, and viewable on mobile devices.
55
+
All timelapse videos export to MP4 video format, which should make them streamable on the web, and viewable on mobile devices.
0 commit comments