Processing user guide
You must have a shell pointing to folder sound-scape-explorer-11.9.0
and active python
virtual environment.
Find related documentation in running campaigns
Runโ
- Open a shell window. (Double-click
start.bat
on Windows or usecd
on Ubuntu / macOS) - Type
sse
followed by a<space>
- Drag and drop your
Excel
file to the shell window - Press
Enter
Example:
# Windows
sse D:\campaign\config.xlsx
# Ubuntu / macOS
sse campaign/config.xlsx
Most frequent use caseโ
If you want to execute all the requested metrics declared in your configuration
file, please use the Run All
menu choice.
- Select
Run All
- Wait for the processing to complete. When the menu displays again, the processing has completed
- You can now go further to visualisation user guide in order to display your data
Menuโ
You will get the menu below.
Use you arrow
and Enter
keys to navigate through it.
๐ Welcome to SoundScapeExplorer!
โโโโโโโโโโโณโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ File โ Path โ
โกโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฉ
โ config โ relative/or/absolute/path/to/config.xlsx โ
โ storage โ relative/or/absolute/path/to/storage.h5 โ
โโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
? Choose your action (Use arrow keys)
โฏ Refresh configuration
Run extractions and aggregations
Run reductions
---------------
Run computation UMAPs and mean distances matrix (needed for autocluster)
Purge computation UMAPs and mean distances matrix
---------------
Run autoclusters
Run trajectories
Run digests
---------------
Run all
Export dataframe as .csv
Export computation UMAPs as .npy
Export mean distances matrix as .npy
Repack storage with `h5repack` (UNIX only)
---------------
Quit
Commandsโ
- Refresh configuration
- Run extractions and aggregations
- Run reductions
- Run computation UMAPs and mean distances matrix
- Purge computation UMAPs and mean distances matrix
- Run autoclusters
- Run trajectories
- Run digests
- Run all
- Export dataframe
- Export computation UMAPs
- Export mean distances matrix
- Repack storage
- Quit
Refresh configuration commandโ
Digest your Excel configuration file and copy all its information inside your storage file.
NoteYou will need to run this again if you change your configuration file.
Run extractions and aggregations commandโ
Extract data from your audio files either through neural networks or indicators algorithms.
Take the raw data and aggregate them using your integration settings.
NoteThese raw data can optionally be stored with the
persist
option.
Run reductions commandโ
Take the aggregated data produced by neural networks and reduce them using your reducers settings.
Run computation UMAPs and mean distances matrix commandโ
Run the necessary data for autoclusters to be performed.
Those data will never be read in the Front
so you can use the purge command
to remove it from your storage file.
Purge computation UMAPs and mean distances matrix commandโ
Remove computation data from your storage file as it will not be consumed by
the Front
.
Run autoclusters commandโ
Automatically attribute numerical clusters (groups) of intervals that are related together depending on your settings.
These clusters will appear in the Front
as standard labels.
Run trajectories commandโ
Compute the coordinates of the requested trajectories.
Run digests commandโ
Take aggregated data and produce derived data using digesters algorithms.
Run all commandโ
Run all the commands necessary for a complete campaign.
Export dataframe commandโ
Exports all intervals and associated data to a .csv
file.
Export computation UMAPs commandโ
Exports all computation UMAPs to a .npy
file.
Export mean distances matrix commandโ
Exports the mean distances matrix to a .npy
file.