V4.10.0 - See Release Notes

Author: signag

README.md

@@ -1,4 +1,4 @@
-# raspiCamSrv V4.9.0
+# raspiCamSrv V4.10.0
 
 **raspiCamSrv** is a Web server for Raspberry Pi systems providing an App for control and streaming of CSI and USB cameras as well as for controlling a large variety of connected GPIO devices.
 
@@ -15,7 +15,7 @@ USB web cams are seamlessly integrated.
 
 Due to responsive layout from W3.CSS, all modern browsers on PC, Mac or mobile devices can be used as clients.
 
-For more details, refer to the [raspiCamSrv Documentation](https://signag.github.io/raspi-cam-srv/latest/)    
+For more details, refer to the [raspiCamSrv Documentation](https://signag.github.io/raspi-cam-srv/latest/), especially the [Features List](https://signag.github.io/raspi-cam-srv/latest/features/)    
 or check the [Release Notes](https://signag.github.io/raspi-cam-srv/latest/ReleaseNotes/) for current version and latest updates.
 
 

docs/PhotoSeriesTimelapse.md

@@ -6,14 +6,21 @@ This screen allows special configurations for Photo Series in the Timelapse doma
 Of course, every normal Photo Series can be used for Timelapse purposes. However, users often require specific features like specific time slots for multi-day series or automatic exposure adjustment during sunset/sunrise phases (Autoramping / "Timelapse Holy Grail").
 
 This page is dedicated to this kind of configuration settings.   
-Currently, raspiCamSrv supports limiting photo shooting to configurable periods depending on sunrise and sunset.
+Currently, raspiCamSrv supports the following *Sun-control Mode*s:
+
+- *Sunrise/Sunset*
+<br>limiting photo shooting to configurable periods depending on sunrise and sunset.
+- *Azimuth*
+<br>taking photos at specific azimuth values over a period of days so that photos are taken with the same horizontal direction of sun.
 
 Usage of this feature requires calculation of sunrise and sunset, depending on date.    
 The algorithm (see [Sunrise Equation](#sunrise-equation)) requires information about the geografic coordinates of the camera position.   
 These need to be specified on the [Settings](./Settings.md) screen before a Series can be classified as "Sun-controlled".   
 It is recommended to [store the configuration](./SettingsConfiguration.md#server-configuration-storage) in order to have these settings available after a server restart.
 
-When this screen is activated after a [new Series](./PhotoSeries.md#creation-of-a-new-series) has been created, it will show up as
+## Sunrise/Sunset Mode
+
+When this screen is activated after a [new Series](./PhotoSeries.md#creation-of-a-new-series) has been created, it will be initialized with *Sunrise/Sunset* mode:
 
 ![Timelapse1](./img/PhotoSeriesTL1.jpg)
 
@@ -32,14 +39,44 @@ When submitting entries with a reasonable interval and Number of Days, the syste
 
 ![Timelapse2](./img/PhotoSeriesTL2.jpg)
 
-## Example: Single Period for Daylight Photos
+### Example: Single Period for Daylight Photos
 
 ![Timelapse3](./img/PhotoSeriesTL3.jpg)
 
-## Example: Two Periods around Sunrise and Sunset
+### Example: Two Periods around Sunrise and Sunset
 
 ![Timelapse4](./img/PhotoSeriesTL4.jpg)
 
+## Azimuth Mode
+
+When choosing *Sun-Control Mode* "Azimuth", the screen layout will change to
+
+![Timelapse5](./img/PhotoSeriesTLAzimuth1.jpg)
+
+- *Time for Azimuth*
+<br>can be used to calculate the azimuth at a specific time.
+<br>When its value is not explicitely set, it will be updated with the current date/time. 
+- *Azimuth [°]*
+<br>is the azimuth at the given time
+- *Elevation [°]*
+<br>is the elevation of the sun above horizon at the given time
+- *Azimuth 1*, ... *Azimuth 4*
+<br>Here, you can specify up to 4 azimuth values for which photos shall be taken at every day within the specified number of days from series start.
+<br>For each value the *Todays Time* at the current day will be calculated when the sun position will have this azimuth.
+<br>The system will also verify that azimuth values are valid for the entire period of the series. If this is not the case, an error message will be shown.
+<br>When entering more than one azimuth value, these will be sorted with increasing times.
+
+
+![Timelapse6](./img/PhotoSeriesTLAzimuth.jpg)
+
+### Series Log File
+
+For photo series using *Azimuth* Mode, the [Series Log File](./PhotoSeries.md#series-log-file) will include the Azimuth value for each photo:
+
+![Timelapse7](./img/PhotoSeriesTLAzimuthLog.jpg)
+
+
+
 ## Sunrise Equation
 
 The algorithm for the sunrise/sunset equation has been taken from Wikipedia:   

docs/ReleaseNotes.md

@@ -2,6 +2,23 @@
 
 [![Up](img/goup.gif)](./index.md)
 
+## V4.10.0
+
+### New Features
+
+- [Photo Series of Type "Timelapse"](./PhotoSeriesTimelapse.md) were extended with a new [Azimuth Mode](./PhotoSeriesTimelapse.md#azimuth-mode). This allows taking multi-day photo series where photos are taken at times when the sun position has specific azimuth values.
+- Extended capabilities of ```GET api probe``` [API](./API.md) WebService endpoint:    
+Now, the ```PhotoSeriesCfg``` object and its properties are accessible which represents the settings for photo series.
+- [Information / Software Stack](./Information_Sys.md) now also shows version of libcamera.
+- A tutorial has been added which shows how to enable [Neural Network-based Automatic White Balance](./tutorials/AWB_with_neural_networks.md)
+
+### Bugfixes
+
+- Empty *ID* is no longer possible when creating a new [Device](./SettingsDevices.md)
+- Fixed error ```AttributeError: 'Picamera2' object has no attribute 'allocator'``` which could occur when the Flask server was started or restarted with an active [Photo Series](./PhotoSeries.md) for which *Cont. on Server Start* was active.
+- Fixed errors which could occur when creating Histograms ([Photo Taking on Live screen](./Phototaking.md#histogram) or [Exposure Series](./PhotoSeriesExp.md))
+<br>This resolves [raspi.cam-srv Issue #89](https://github.com/signag/raspi-cam-srv/discussions/89).
+
 ## V4.9.0
 
 ### New Features

docs/features.md

@@ -1,5 +1,5 @@
 
-# Features V4.9.x
+# Features V4.10.x
 
 [![Up](img/goup.gif)](./index.md)
 
@@ -58,6 +58,7 @@ The [automatic installer](./installation.md) as well as the [Docker Image](https
 - [Auto Exposure Control](./CameraControls_AutoExposure.md) for CSI cameras.
 - [Exposure Control](./CameraControls_Exposure.md) for CSI cameras.
 - [Image Control](./CameraControls_Image.md) for CSI cameras as well as for USB cameras (if supported by the camera).
+- **NEW**: Automatic White Balance using Nueral Networks can be activated through [Modification of Tuning Files](./tutorials/AWB_with_neural_networks.md)
 - Panel for [Direct Control](./LiveDirectControl.md) of numeric control parameters.
 - Configurable [Live View buttons](./CameraControls_Ctrl.md) to be used for physical pan/tilt, light or control of other devices
 
@@ -100,6 +101,7 @@ The [automatic installer](./installation.md) as well as the [Docker Image](https
 - [Control of Photo Series](./PhotoSeries.md) (start, stop, pause, resume).
 - [Download of Photo Series](./PhotoSeries.md).
 - [Timelapse Series](./PhotoSeriesTimelapse.md) with optional sunrise/sunset restrictions.
+- **NEW**: [Sun-Controlled Timelapse Series](./PhotoSeriesTimelapse.md#azimuth-mode) with well-defined sun azimuth.
 - [Exposure Series](./PhotoSeriesExp.md) with varying exposure time or gain (ISO).
 - [Exposure Series Result](./PhotoSeriesExp.md#result) showing histograms.
 - [Focus Stack Series](./PhotoSeriesFocus.md) iterating through a range of focus settings.
@@ -134,9 +136,9 @@ The [automatic installer](./installation.md) as well as the [Docker Image](https
 - Triggering by [Motion Detection](./TriggerMotion.md)
 - Triggering by Camera events (photo taken, video start, video stop)
 - [Configuration of Actions](./TriggerActions.md)
-- **NEW**: [Testing of Actions](./TriggerActions.md#testing-an-action)
+- [Testing of Actions](./TriggerActions.md#testing-an-action)
 - Actions by [GPIO Output Devices](./SettingsDevices.md) (LED, buzzer, servo, motor)
-- **NEW**: All action methods of all [gpiozero Output Devices](https://gpiozero.readthedocs.io/en/stable/api_output.html#regular-classes) are supported
+- All action methods of all [gpiozero Output Devices](https://gpiozero.readthedocs.io/en/stable/api_output.html#regular-classes) are supported
 - Actions by Camera (take photo, start/stop video)
 - [Camera Actions](./TriggerCameraActions.md) in case of motion detection (video duration, photo burst)
 - [Notification](./TriggerNotification.md) actions (mail, mail attachments)