4. Running rsudp¶
After modifying the settings file to your liking, you are ready to start rsudp.
4.1. Starting rsudp on Unix¶
Unix users may prefer to start with the easy-to-use start script available in the git repository:
4.2. Starting rsudp on Windows¶
After modifying the settings file, Windows users can double click
on the batch file named
win-start-rsudp.bat to start.
4.3. Starting manually on Windows or Unix¶
This start method is covered in our rsudp start/run tutorial video.
1. First, to activate the conda environment, type
conda activate rsudp.
If you can’t do this, and you’re on Unix, you may need to Run the sourcing line.
2. Next, configure a datacast stream (formerly known as a UDP stream)
to forward data to an open port on the computer where this program is running.
By default this port is
3. The UNIX installer will create a settings file in
Change the settings in this file to control how the client operates.
Windows users will need to type
rs-client -d default to dump the settings to a file
the first time they run this program.
To dump the default settings to a different location of your choosing, type
rs-client -d /path/to/settings.json.
As stated above, to rebuild and overwrite the default settings file in
rs-client -d default
4. After modifying the settings file to your liking,
rs-client to use the settings file at
rs-client -s /path/to/settings.json to run with a settings file other than the default one.
This library can only handle incoming data from one Shake per port. If for some reason more than one Shake is sending data to the port, the software will only process data coming from the IP of the first Shake it sees sending data. All data coming from any other Shake(s) will be ignored.
4.4. Running in demonstration/testing mode¶
See more about this functionality in Testing and demoing rsudp.
To start, open a Terminal or Anaconda Prompt window.
Activate the conda environment by typing
conda activate rsudp.
rs-testand press enter.
Test data will begin flowing through the program. Several features will be tested, including the earthquake detection functionality, the alarm sound, and the plot.