Release pyDARNio v1.1

[mts299]

Scope

The new feature is reading/writing Borealis v0.6.

Documentation:

Changes:

• reading/writing Borealiss 0.6
• reading partial Map records
• fixed Borealis Slive interface

Approvals

3 - all testing and reviewing. Please state on approval what OS and python version you used.

DEADLINE: May 17, 2021

Testing

• general install
• general reading DMAP and Borealis files
• reading/writing Borealiss 0.6
• reading partial Map records
• Borealis Slive interface

Please ask @kevinkrieger where to get Borealis files to test on

[carleyjmartin]

I'm having trouble installing, I'm making a venv and then tried:
pip3 install git+https://github.com/superdarn/pyDARNio@release/v1.1
that didn't work so I also tried the clone then pip3 install . --user way, that didnt work so I tried the python setup.py install way.
They all just hang until I tell it to quit.
on the first way, It hangs after:

Collecting git+https://github.com/superdarn/pyDARNio@release/v1.1
  Cloning https://github.com/superdarn/pyDARNio (to revision release/v1.1) to /private/var/folders/fw/0wyj_jf501l_gj69h6dn009w0000gn/T/pip-req-build-7dw0v5ap
  Running command git clone -q https://github.com/superdarn/pyDARNio /private/var/folders/fw/0wyj_jf501l_gj69h6dn009w0000gn/T/pip-req-build-7dw0v5ap
  Running command git checkout -b release/v1.1 --track origin/release/v1.1
  Switched to a new branch 'release/v1.1'
  Branch 'release/v1.1' set up to track remote branch 'release/v1.1' from 'origin'.

I don't know if that helps or not, but I'm a bit stuck if I can't install it :P

Edit: this is on Mac

[Lozzy-Bear]

Okay, I thought I just didn't know what I was doing. I also can't get it installed via pip or setup.py (likely my user error).

…

________________________________ From: carleyjmartin ***@***.***> Sent: May 14, 2021 12:31 PM To: SuperDARN/pyDARNio ***@***.***> Cc: Lozinsky, Adam ***@***.***>; Assign ***@***.***> Subject: Re: [SuperDARN/pyDARNio] Release pyDARNio v1.1 (#21) CAUTION: External to USask. Verify sender and use caution with links and attachments. Forward suspicious emails to ***@***.*** I'm having trouble installing, I'm making a venv and then tried: pip3 install ***@***.***/v1.1 that didn't work so I also tried the clone then pip3 install . --user way, that didnt work so I tried the python setup.py install way. They all just hang until I tell it to quit. on the first way, It hangs after: Collecting ***@***.***/v1.1 Cloning https://github.com/superdarn/pyDARNio (to revision release/v1.1) to /private/var/folders/fw/0wyj_jf501l_gj69h6dn009w0000gn/T/pip-req-build-7dw0v5ap Running command git clone -q https://github.com/superdarn/pyDARNio /private/var/folders/fw/0wyj_jf501l_gj69h6dn009w0000gn/T/pip-req-build-7dw0v5ap Running command git checkout -b release/v1.1 --track origin/release/v1.1 Switched to a new branch 'release/v1.1' Branch 'release/v1.1' set up to track remote branch 'release/v1.1' from 'origin'. I don't know if that helps or not, but I'm a bit stuck if I can't install it :P — You are receiving this because you were assigned. Reply to this email directly, view it on GitHub<#21 (comment)>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/AFJ3WCNWBR2ZR5JNAMXHEYDTNVUBJANCNFSM435LRCQQ>.

[RemingtonRohel]

OS: OpenSUSE Leap 15.2
Python Version: 3.6.12

[carleyjmartin]

• general install
  Install problems just went away and now I can install it with no issue?

• general reading DMAP and Borealis files
  Read older rawacf and bfiq borealis files using BorealisRead()
  Read dmap rawacf file using DmapRead()

• reading/writing Borealiss 0.6
  Used BorealisConvert() to convert a new borealis rawafc file to a dmap.
  Assuming that you're not supposed to be able to us BorealisRead() on v6 files as I get a structural error?

I don't know how to test these two?

• reading partial Map records
• Borealis Slive interface

OS: Mac Catalina 10.15.5
Python: 3.7.3

[mts299]

don't worry about the last two @RemingtonRohel did a good job on it. Map one is tricky since you need to find a partial record in a file which is not easy. The slice interface is you read an array file in and convert to a slice file or you call on records? @RemingtonRohel can you explain?

[RemingtonRohel]

Yes, the slice interface (actually the method unshared_fields_dims_site, @mts299 mentioned to me) is called when you access the records property of either a BorealisArrayRead or BorealisArrayWrite object. So basically just read a Borealis Array file and access the records.
For the partial map record, I installed pyDARN v1.0.0 in a virtual environment and tried to read in a map file from 1993, then caught the exception and tried reading it with pyDARNio.

[Lozzy-Bear]

Windows 10 x86-64
Python 3.7.10

OpenSUSE 15.2
Python 3.8.5

[Devin-Huyghebaert]

Reviewed the templates. There are some minor suggestions.

Was able to read in the data for the files that @RemingtonRohel posted. Did not test the other formats.

Example code:
`import pydarnio

sd_rawacf = pydarnio.BorealisRead('data/20210225.2219.22.sas.0.rawacf.hdf5.site', 'rawacf', 'site')

print(sd_rawacf.records)
`

OS: Ubuntu 20.04.2 LTS
Python 3.8.5