This package provides an interface between python and ARIS files.

###Additional sources of information: Soundmetrics GitHub Repo.: https://github.com/SoundMetrics

Currently this packages has only been tested with the ARIS Explorer 3000 in 128 beam mode. It should work with other versions, but they have yet to be tested. This package currently doesn't support the tele-photo len.

• Python (3.0)
• OpenCV (3.4.2)
• Numpy (1.19.2)
• PIL (1.1.7)
• tqdm (4.11.2)
• Pytz (2015.4)
• ffmpeg (Optional for exporting to video)

	import pyARIS
	filename = 'C:/Test_file.aris'
	ARISdata, frame = pyARIS.DataImport(filename)

The DataImport function opens the aris file, mines the metadata, populates the ARISdata data structure. It then opens the first file, populates the frame data structure with the frame metadata and raw data. A look-up table is created to remap the data from the raw data structure (i.e. beam number and bin number) to a real-world mapping.

Additional arguments: startFrame: The first frame to be populated into the data structure (Default = 1). frameBuffer: Adds a specified number of pixels to be added to the remapped frame. Primarily for display purposes.

Once the data file has been opened, specific frames can be loaded.

	frame = pyARIS.FrameRead(ARISdata, 2)

This methods could be used with a loop to iterate through the frames in the file.

	for i in range(ARISdata.FrameCount):
        frame = FrameRead(ARISdata, i)

Additional arguments: frameBuffer: Adds a specified number of pixels to be added to the remapped frame. Primarily for display purposes.

####Using the ARIS data At this point the data can be passed into different packages. To view and save the remapped image with matplotlib:

	import matplotlib.pyplot as plt
	plt.imshow(frame.remap, origin = "lower", vmin = 0, vmax = 255)
	plt.savefig('frame.png', bbox_inches = 'tight', pad_inches = 0.25)
	plt.show()

To view using PIL

	from PIL import Image
	im = Image.fromarray(frame.remap)
	im.show()

The data is OpenCV compatable. To view:

	import cv2
	cv2.imshow('data',frame.remap)
	cv2.waitKey(5000)
	cv2.destroyAllWindows()

The VideoExport() method utilizes FFMpeg to pipe the frame data into a MP4 container. If FFMpeg is not in your filepath then I typically put the FFMpeg.exe file in the working directory. An optional timestamp argument will place the sonar timestamp on the frame. Timestamp parameters include the fontsize and position (ts_pos).

To implement:

	pyARIS.VideoExport(data, 'test_video.mp4', start_frame = 10, end_frame = 50, timestamp = True, fontsize=30, ts_pos = (10,1200))