Bat Recording Manager v8.n

This program provides a management system for your library of bat (or other) recordings. It can be flexible in its approach but is primarily designed to work with libraries stored and analysed according to a particular protocol which is described below. The program has four main ‘views’. The default view lists all recording sessions, with details of the currently selected session. Sessions can be added or edited manually or deleted from the database. Similarly individual recordings within the session can be added, edited or deleted. The program assumes that the recordings are of bat calls, and incorporates a reference list of bat species, which can also be modified by the user. This reference list also defines a set of ‘tags’ which can be used when analysing recordings to indicate the presence of each species. Recordings may also be displayed ‘by bat species’. In this case the defined species are listed and the recording sessions and recordings which detected the selected species are shown. An ‘Import’ page allows recording sessions which have been analysed using Audacity to be imported into the database. A single folder containing a set of recordings may be imported or a selection of folders can be imported sequentially.Analyse and Import mode allows interaction with Audacity or Kaleidoscope Light for rapid sequential analysis of recording files.The program also provides report generation in a number of formats, storage of screen capture images during analysis, and the ability to replay portions of recordings at reduced speed or in heterodyne (tuned bat detector) mode.This setup file incorporates .NET 4.7.2 and Audacity 2.3.2 which will be installed automatically if required. The Audacity installation will not affect any pre-existing installations. Kaleidoscope interaction requires that Kaleidoscope is installed to C: v8.0 builds on version 7.3 (see other figshare project) but updates to .NET 4.72 and provides virtualized data access for faster loading in some situations. v8.0.7111 completes the conversion to Visual Studio 2019 and .NET 4.72 with extensive refactoring and code tidying using Resharper. Source code is now available from GitHub.https://github.com/jathalls/BatRecordingManager_v8.n v8.0.7115 Bugfixes for issues with identifying and extracting data from .txt files during import or analyse and import. v8.0.7120 Bugfix causing a crash in 'analyse and import' when the filename doesn't include the date v8.0.7130 Adds the ability to save 'played' snippets to a .wav file, either as slowed down audio file or as a heterodyned audio file. v8.0.7141 allows for editing the labels file when a recording is opened in Audacity from the Recording Sessions View (by Double-clicking on the recording name in the Recordings list), or from the List By Bats view (By double clicking on a recording in the recordings list pane). In these cases, if the .txt file has been modified then the database will be updated accordingly and the main window will be fully refreshed from the updated database. This does NOT happen if the recording is opened by double-clicking on a Labelled Segment (in the RecordingSessions View) or if the file is opened using the OPEN button in the image comparison window. In these cases any changes made to the .txt file will not cause the database to be modified unless the recording is specifically opened as above and the labels file re-saved, or if the entire session is re-imported.Also now defaults to the correct folder for Audacity to ExportLabels.v8.0.7153 Fixed problems with slow generation of reportsv8.0.7160 Various bug fixes and speed improvementsv8.0.7164 Upgrade to Audacity 2.3.2 and fix the wait cursor bug in report.v8.0.7171 Improvements to the ByFrequency report generationv8.0.7177 Bug fixes to wav file import, Kaleidoscope analyse when folder has zero length files, and Frequency Table report generation for sessions running over multiple days.v8.0.7192 Improvements to the UI especially the display of the Recordings list. Also significant improvements to the mechanism for detecting the current database version which hopefully will prevent the installation problems reported on some machines. Also provided a mechanism for taking a backup copy of the database by running BRMBackup.cmd in folder c:\BRMBackup.v8.0.7193Enables installation to Windows 8.1 and possibly Windows 7(SP1). If the installer fails it may be necessary to manually install .NET Framework runtime 4.7.2 and SQLServerExpress 2016 both downloadable form Microsoft. Installer has been tested on Windows 8.1 and worked.v8.0.7195Fixes problems with the report Frequencies table and changes the table to use times with respect to sunset on the date of the recording session.v8.0.7201Adds the ability to get online weather data (if connected to the internet) for a session with a known GPS location and date. Uses the DarkSky API to get the historical weather data which may not be geographically precise but will be for the nearest location known to DarkSky.v8.0.7206The Export button is repurposed to write new .txt files for the selected session. It is only enabled for a single session and can either write just the missing.txt files or can overwrite and replace the existing .txt files including the header file.v8.0.7216 Adds a new Report format which gives a summary report for multiple sessions. Data is listed by session (Location, Tag, GPS, MapRef, Start, End) and then by bat (Name, Passes/segments, Min, Max, Mean, Total duration). v8.0.7230Makes improvements to analyseAndImport for folders and files with non-standard format namesv8.0.7244Fixed a problem with exporting the summary report that missed data in some fields. Version 8.2 introduces a new feature in the form of indirect supportive applications.These additional features are accessed through the main menu under the heading of Supp Apps.At present there is a single supplementary app called Filter which can be used to extract files from a folder if their notes or comments contain one of a range of user definable keywords. This can typically be used to identify all .wav files in a folder which have not been analysed or in which it is was not possible to make a clear identification. The same app can be used to re-merge re-analysed files into the main folder and to update the database accordingly.8.2 will also progressively improve the user interface in situations where therre are multiple click type to access a range of features. In Future right-clicking will bring up a context menu from which the appropriate action can be selected. 8.2.7320Introduces the Filter supplementary App and also adds a right-click context menu when selecting one or more recordings in the List-By-Bats View. If one or more recordings are selected in the List-ByBats View the context menu gives the choice of opening the Add Image dialog (the previous right-click function) or of exporting those .wav files to a user selected folder. In this case the original files and the database are unaffected.8.2.7326 Fixed some selection bugs in filter and export functions and added additional context menus8.2.7339 Addition of more context menus to simplify the UI especially in the image comparison window8.2.7354 Bug fix to Filter function本程序为蝙蝠（bat）录音文库提供管理系统。其设计思路兼具灵活性，主要适配遵循下述特定协议进行存储与分析的录音文库。 本程序包含四大核心视图。默认视图可展示所有录音会话，并显示当前选中会话的详细信息。用户可手动新增、编辑会话，或从数据库中删除会话；同理，会话内的单条录音也支持新增、编辑与删除操作。 本程序默认处理蝙蝠鸣叫声录音，内置可由用户修改的蝙蝠物种参考列表。该参考列表同时定义了一组标签，用于在录音分析阶段标记对应物种的检出情况。程序支持按蝙蝠物种分类展示录音：此时将列出已定义的物种，并展示检出该选中物种的所有录音会话与单条录音。 用户可导入包含多组录音的单个文件夹，也可依次导入多个选定文件夹。分析与导入模式支持与Audacity或Kaleidoscope Light联动，实现录音文件的快速批量分析。 程序支持多种格式的报告生成，可存储分析过程中的屏幕截图，还能以减速播放或外差（heterodyne，调谐式蝙蝠探测器）模式回放录音片段。 本安装包集成了.NET 4.7.2与Audacity 2.3.2，可根据需求自动安装。Audacity的安装不会影响用户已有的其他安装实例。与Kaleidoscope联动需将Kaleidoscope安装至C盘。v8.0版本基于7.3版本开发（详见其他figshare项目），升级至.NET 4.7.2，并引入虚拟化数据访问机制，可在部分场景下提升加载速度。 v8.0.7111版本完成了向Visual Studio 2019与.NET 4.7.2的迁移，通过Resharper完成了大规模代码重构与整理。源代码现已开放至GitHub：https://github.com/jathalls/BatRecordingManager_v8.n v8.0.7115：修复了导入或分析导入阶段从.txt文件识别与提取数据的相关问题。 v8.0.7120：修复了当文件名不含日期时，“分析与导入”功能崩溃的问题。 v8.0.7130：新增功能，可将“已播放”的片段保存为.wav文件，支持减速音频或外差音频两种格式。 v8.0.7141：支持在从录音会话视图（通过双击录音列表中的录音名称）或按蝙蝠分类视图（通过双击录音列表面板中的录音）中打开Audacity编辑标签文件。在此类操作中，若.txt文件被修改，数据库将同步更新，主窗口也会基于更新后的数据库完成全量刷新。但若通过双击录音会话视图中的标注片段，或通过图像对比窗口中的“打开”按钮打开录音文件，则不会触发数据库自动更新。此类场景下，用户修改.txt文件后，除非按前述方式重新打开录音并重新保存标签文件，或重新导入整个会话，否则数据库不会同步变更。此外，本版本现已默认设置Audacity导出标签文件的正确目录。 v8.0.7153：修复了报告生成缓慢的问题。 v8.0.7160：修复多项缺陷并提升运行速度。 v8.0.7164：升级至Audacity 2.3.2，并修复了报告生成阶段的等待光标异常问题。 v8.0.7171：优化按频率分类的报告生成功能。 v8.0.7177：修复了.wav文件导入、文件夹内含零字节文件时Kaleidoscope分析，以及跨多日会话的频率表报告生成相关问题。 v8.0.7192：优化了用户界面，尤其是录音列表的展示效果；大幅改进了当前数据库版本的检测机制，有望解决部分设备上出现的安装问题；新增数据库备份机制，用户可通过运行c:BRMBackup文件夹中的BRMBackup.cmd脚本完成备份。 v8.0.7193：支持在Windows 8.1及Windows 7(SP1)系统上安装。若安装程序运行失败，用户可能需要手动安装.NET Framework Runtime 4.7.2与SQLServerExpress 2016，两款工具均可从微软官网下载。本安装程序已在Windows 8.1系统上完成测试并可正常运行。 v8.0.7195：修复了频率报告表的相关问题，并将报告表格的时间基准改为录音会话当日的日落时间。 v8.0.7201：新增功能，支持为已知GPS位置与录制日期的会话获取在线天气数据（需联网）。本功能通过DarkSky API获取历史天气数据，数据的地理精度可能有限，但会匹配DarkSky可识别的最近位置。 v8.0.7206：重新定义了“导出”按钮的功能，用于为选中的会话生成新的.txt文件。该按钮仅在选中单个会话时可用，支持仅生成缺失的.txt文件，或覆盖包括头文件在内的所有现有.txt文件。 v8.0.7216：新增多会话汇总报告格式。报告将按会话（包含位置、标签、GPS、地图参考、开始时间、结束时间）分组，再按蝙蝠物种（包含名称、通过次数/片段数、最小值、最大值、平均值、总时长）展示数据。 v8.0.7230：优化了分析与导入功能，使其可处理格式名称非标准的文件夹与文件。 v8.0.7244：修复了汇总报告导出时部分字段缺失数据的问题。 8.2版本新增了间接支持应用类新功能。这些附加功能可通过主菜单下的“辅助应用（Supp Apps）”栏目访问。当前仅提供一款名为Filter（筛选器）的辅助应用，可根据用户自定义的关键词范围，从文件夹中提取包含对应备注或注释的文件。该功能通常可用于识别文件夹中所有未经过分析，或无法明确识别物种的.wav文件。此外，该应用还可将重新分析后的文件重新合并至主文件夹，并同步更新数据库。 8.2版本还将逐步优化多点击类型操作场景下的用户界面，未来将通过右键单击调出上下文菜单，以选择对应操作。 8.2.7320：新增Filter辅助应用，并在按蝙蝠分类视图中添加了针对单条或多条录音的右键上下文菜单。在按蝙蝠分类视图中选中录音后，上下文菜单将提供两个选项：打开添加图片对话框（原右键功能），或将选中的.wav文件导出至用户指定文件夹。此操作不会影响原始文件与数据库。 8.2.7326：修复了筛选与导出功能中的部分选择逻辑漏洞，并新增了更多上下文菜单。 8.2.7339：新增更多上下文菜单，进一步简化用户界面，尤其是图像对比窗口的操作逻辑。 8.2.7354：修复了筛选器功能的相关缺陷。