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.本程序为用户的蝙蝠（或其他类群）录音库提供一套专业化管理系统。其设计思路灵活多元，但主要面向遵循下述特定协议进行存储与分析的录音库开发。程序包含四大核心「视图」模块：默认视图将列出所有录音会话，并展示当前选中会话的详细信息；用户可手动添加、编辑会话，或从数据库中删除会话，同理，会话内的单条录音也支持添加、编辑或删除操作。 程序默认处理蝙蝠叫声录音，内置蝙蝠物种参考列表，用户可自行修改该列表。该参考列表同时定义了一组「标签（Tag）」，可在录音分析流程中用于标记各物种的出现情况。用户亦可按「蝙蝠物种」对录音进行分类展示：此时将列出已定义的物种，并展示检测到选中物种的录音会话与单条录音。 「导入」页面支持将使用Audacity分析完成的录音会话导入数据库，用户可导入包含一组录音的单个文件夹，也可按顺序批量导入多个选定文件夹。「分析与导入」模式可与Audacity或Kaleidoscope Light配合使用，实现录音文件的快速串行分析。 程序还支持多种格式的报告生成、分析过程中屏幕截图的存储，以及对录音片段进行减速播放或外差（调谐式蝙蝠探测器）模式回放。 本安装程序集成了.NET 4.7.2与Audacity 2.3.2，若有需求将自动完成安装，且Audacity的安装不会对用户已有的相关安装造成任何干扰。与Kaleidoscope Light的交互要求其已安装至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版本，并修复了报告功能中的等待光标显示异常bug。 v8.0.7171：优化了按频率生成报告的流程。 v8.0.7177：修复了.wav文件导入、文件夹包含零字节文件时Kaleidoscope Light分析功能异常，以及跨多日会话的频率表报告生成相关的问题。 v8.0.7192：优化了用户界面，尤其是录音列表的展示效果。同时大幅改进了当前数据库版本的检测机制，有望解决部分设备上出现的安装问题。此外，程序新增了数据库备份机制，用户可通过运行C:BRMBackup文件夹中的BRMBackup.cmd来备份数据库。 v8.0.7193：支持安装至Windows 8.1及可能的Windows 7(SP1)系统。若安装程序运行失败，用户可能需要手动安装.NET Framework Runtime 4.7.2与SQLServerExpress 2016，这两个组件均可从Microsoft官网下载。安装程序已在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）」栏目访问。目前仅有一款名为「过滤器」的辅助应用，可用于从文件夹中提取满足条件的文件：若文件的备注或注释包含用户可自定义的关键词之一。该功能通常可用于识别文件夹中所有未经过分析，或无法明确识别物种的.wav文件。该应用还可用于将重新分析后的文件重新合并至主文件夹，并同步更新数据库。 版本8.2还将逐步优化多点击类型触发各类功能的用户界面。未来，右键单击将弹出上下文菜单，用户可从中选择合适的操作。 v8.2.7320：新增了「过滤器」辅助应用，同时在「按蝙蝠分类视图」中选择一条或多条录音时，新增了右键上下文菜单功能。若在「按蝙蝠分类视图」中选中一条或多条录音，上下文菜单将提供两个选项：打开「添加图像」对话框（原右键单击功能），或导出所选的.wav文件至用户指定的文件夹。此类场景下，原始文件与数据库均不会受到任何影响。