Skip to content

SUYA 0.1.7

Choose a tag to compare

@github-actions github-actions released this 11 Nov 02:51
· 27 commits to main since this release

Download / 내려받기

OS File / 파일 Size First run / 처음 실행
Windows 10/11 x64 SUYA-0.1.7-windows-x64-setup.exe ≈ 50 MB Installer (English/Korean). SmartScreen: More info → Run anyway / "추가 정보 → 실행"
macOS 12+ Apple Silicon (M1–M4) SUYA-0.1.7-macos-arm64.dmg ≈ 59 MB Drag to Applications. macOS 15+: open once, then System Settings → Privacy & Security → Open Anyway; macOS 12–14: right-click → Open / macOS 15 이상: 한 번 연 뒤 시스템 설정 → 개인정보 보호 및 보안 → 그래도 열기, 12~14: 우클릭 → 열기
macOS 12+ Intel SUYA-0.1.7-macos-x86_64.dmg ≈ 64 MB Same / 위와 같음
Linux x86_64 (glibc ≥ 2.35) SUYA-0.1.7-linux-x86_64.tar.gz ≈ 109 MB Extract, run ./install.sh / 풀고 ./install.sh

Not sure which Mac you have? Apple menu → About This Mac: "Chip Apple M…" → Apple Silicon, "Processor … Intel" → Intel. / Apple 메뉴 → 이 Mac에 관하여: "칩 Apple M…"이면 Apple Silicon, "프로세서 … Intel"이면 Intel.

Already on 0.1.2 to 0.1.6? You do not need to download anything. SUYA finds this release by itself when it starts and once a day. 0.1.5 and 0.1.6 install it by themselves after a 20-second prompt that lets you postpone; 0.1.2, 0.1.3 and 0.1.4 ask before installing (Help ▸ Check for updates… looks right away).
0.1.2~0.1.6을 쓰고 있으면 내려받을 필요가 없습니다. 시작할 때와 하루 한 번 이 릴리스를 스스로 찾습니다. 0.1.5와 0.1.6은 20초 동안 미룰 수 있게 물어본 뒤 스스로 설치하고, 0.1.2·0.1.3·0.1.4는 설치 전에 물어봅니다(*도움말 ▸ 업데이트 확인…*으로 바로 확인).

Checksums: SHA256SUMS.txt (below, under Assets). Every file is built by GitHub Actions from this tag (.github/workflows/release.yml) and installed on the build machine, where the installed copy has to pass its self-test before the file is attached. The builds are unsigned, hence the first-run warning.
Updating from 0.1.0 or 0.1.1: install over the old version. Your database, settings and Excel workbooks stay where they are.
Python users: pip install "suya[gui] @ git+https://github.com/jongsu-king/SUYA.git@v0.1.7" then run suya. Without [gui] you get the collector alone, with no Qt.
Containers: docker build -t suya https://github.com/jongsu-king/SUYA.git#v0.1.7, then docker run -d --name suya --restart unless-stopped -v suya-data:/data suya.
macOS with Homebrew: brew install --cask jongsu-king/suya/suya installs the same disk image, with the same first-run warning.
Homebrew를 쓰는 macOS: brew install --cask jongsu-king/suya/suya로 같은 디스크 이미지를 설치합니다. 처음 실행 경고도 같습니다.


SUYA 0.1.7 — Antarctic Ocean Monitor: Southern Ocean temperature, salinity and air temperature collected continuously from public APIs into SQLite and monthly Excel; south-polar map, profiles, T-S diagrams; English/Korean.
SUYA 0.1.7 — 남극해 수온·염분·기온 실시간 수집 프로그램.

Copyright © 2026 Jongsu Lim (Department of Physics, HMOL, Incheon National University; imjongsu1102@gmail.com; ORCID 0009-0000-3395-1484) and Suyeon Park (Department of Materials Science and Engineering, CELLMATE, Incheon National University; dbsnt110@inu.ac.kr) · MIT License

DOI — all versions (concept DOI): 10.5281/zenodo.23937852 · this version: 10.5281/zenodo.24123936 · archived on Zenodo
DOI — 전체 버전(개념 DOI): 10.5281/zenodo.23937852 · 이 버전: 10.5281/zenodo.24123936

The ion conversion now covers the whole-area salinity grids behind the map as well as the point values. Every stored salinity carries a range check, amounts per litre are given where a temperature is paired, and two collection errors are fixed. No new data source is called.
이번 릴리스부터 이온 환산이 지점값뿐 아니라 지도에 쓰는 전범위 염분 격자에도 적용됩니다. 저장되는 모든 염분에 범위 검사 결과가 붙고, 짝이 되는 수온이 있으면 리터당 양도 나오며, 수집 쪽 오류 두 가지를 고쳤습니다. 새로 부르는 자료원은 없습니다.

Derived, not measured. The ion values are calculated from salinity with a fixed composition, for the grids as for the points. No instrument here measures ions, so an ion map is the salinity map read on another scale. Real seawater differs slightly, and the changed ratios in sea-ice brine or where river water or meltwater mixes in are not modelled.
측정값이 아니라 환산값입니다. 이온 값은 지점이든 격자든 염분에 고정된 조성 비율을 곱해 계산합니다. 이온을 직접 재는 자료는 없으므로, 이온 지도는 염분 지도를 다른 눈금으로 읽은 것입니다. 실제 바닷물은 조금 다르고, 해빙 주변 브라인이나 강물·융빙수가 섞이는 곳의 비율 변화는 반영하지 않습니다.

Added / 더한 것

  • Ion conversion of the whole-area grids. The salinity grids behind the map (HYCOM salinity at each depth, SMOS, SMAP) are converted with the same factors as the point values.
    전범위 격자의 이온 환산. 지도에 쓰는 염분 격자(HYCOM 수심별 염분, SMOS, SMAP)를 지점값과 같은 계수로 환산합니다.
    • Map: a Show box on the salinity layers reads the map as one of the eight major ions in g/kg or mmol/kg. The colours stay the same; the colour-bar ticks, the cursor value and the caption change.
      지도: 염분 레이어의 표시 상자에서 주요 이온 여덟 가지 가운데 하나와 단위(g/kg, mmol/kg)를 고릅니다. 색은 그대로이고 범례 눈금, 커서 값, 설명줄이 바뀝니다.
    • Workbook: a new sheet, Grid ions, with one row per grid time for the whole area south of 60°S and for each of the five sectors: valid cells, mean salinity, reference salinity, the eight ions in g/kg and mmol/kg and the range check for the layer depth.
      엑셀: 새 시트 격자이온. 격자 시각마다 60°S 이남 전체와 해역 다섯 곳에 한 행씩, 유효 칸 수, 평균 염분, 기준 염분, 이온 여덟 가지의 g/kg·mmol/kg, 레이어 수심으로 본 범위 검사를 적습니다.
    • Database: the new view grid_ions gives the same rows. Nothing is stored for it; the amounts are computed from grids when read.
      데이터베이스: 새 뷰 grid_ions가 같은 행을 줍니다. 따로 저장하는 것은 없고 읽을 때 grids에서 계산합니다.
    • CSV: suya export grid-ions --layer hycom_salt_0 --out salt0_ions.csv and the menu entry File ▸ Export CSV ▸ Current layer ions… write every cell of the latest grid of a salinity layer with its ions. Other layers are refused.
      CSV: suya export grid-ions --layer hycom_salt_0 --out salt0_ions.csv와 메뉴 *파일 ▸ CSV 내보내기 ▸ 현재 레이어 이온…*이 염분 레이어 최신 격자의 모든 칸을 이온 값과 함께 씁니다. 염분이 아닌 레이어는 거절합니다.
    • The conversion is proportional to salinity, so the ions of a mean salinity equal the mean of the cell ions. The stored means have three decimals. The grids have no mmol/L, because no paired temperature is used.
      환산이 염분에 비례하므로 평균 염분을 환산한 값이 칸마다 환산해 평균한 값과 같습니다. 저장된 평균은 소수 셋째 자리까지입니다. 짝이 되는 수온을 쓰지 않으므로 격자에는 mmol/L이 없습니다.
  • Salinity range check. Every stored salinity is compared with the Southern Ocean range for its depth from Boyer and Levitus (1994), NOAA Technical Report NESDIS 81 (Appendix A, Table 3f). The verdict (ok, low, high) is kept in the new column salinity_check of seawater_ions and in the view argo_level_ions, and shown as a Range check column in the Ion composition sheet, the Argo levels workbook and both ion CSV exports. A new sheet, Salinity ranges, lists the table. It is a label only: no value is dropped or changed, and the ranges are broad on purpose, so only gross errors are caught.
    염분 범위 검사. 저장되는 모든 염분을 Boyer와 Levitus(1994), NOAA Technical Report NESDIS 81(부록 A, 표 3f)의 남극해 수심별 범위와 견줍니다. 결과(ok, low, high)는 seawater_ions의 새 열 salinity_check와 뷰 argo_level_ions에 남고, 이온조성 시트, Argo 층별 엑셀, 이온 CSV 두 가지에 범위 검사 열로 나옵니다. 새 시트 염분범위에 쓰인 표가 있습니다. 표시만 할 뿐 값을 버리거나 고치지 않으며, 범위를 일부러 넓게 잡아 큰 오류만 걸러냅니다.
  • Volume basis. Where a salinity row has a temperature from the same source, place, level and time, the Ion composition sheet and suya export ions add that temperature, the density at 1 atm (Millero and Poisson 1981) and the eight major ions in mmol/L. In-situ pressure is not included, and the cells stay blank without a paired temperature.
    부피 기준. 염분 행에 같은 자료·위치·층·시각의 수온이 있으면 이온조성 시트와 suya export ions에 그 수온, 1기압 밀도(Millero와 Poisson 1981), 주요 이온 여덟 가지의 mmol/L이 붙습니다. 현장 압력은 넣지 않았고, 짝이 되는 수온이 없으면 칸을 비워 둡니다.
  • Command: suya ions takes --temperature (adds the density at 1 atm and mmol/L) and --depth (adds the range check); --json carries both.
    명령: suya ions에 --temperature(1기압 밀도와 mmol/L 추가)와 --depth(범위 검사 추가)가 생겼습니다. --json에도 둘 다 들어갑니다.

Fixed / 고친 것

  • Argo surface values. The surface temperature and salinity of a profile were taken from the first row the listing request returned, which was not always the shallowest good level. They are now the shallowest quality-controlled level within 100 dbar of the stored profile, chosen separately for temperature and salinity, and the row records that depth. Rows written by earlier versions are corrected once, on the first collection after the update. On a copy of a real database this changed 10 of 781 profiles: one surface salinity went from 27.581 to 33.995, and a salinity of 39.063 was removed because that profile has no usable value within 100 dbar.
    Argo 표층 값. 프로파일의 표층 수온·염분을 목록 요청이 돌려준 첫 행에서 가져왔는데, 그 행이 늘 가장 얕은 정상 층은 아니었습니다. 이제 저장된 프로파일에서 100 dbar 안의 가장 얕은 품질 검사 통과 층을 수온과 염분 따로 고르고, 그 수심을 행에 적습니다. 이전 버전이 쓴 행은 올린 뒤 첫 수집 때 한 번 바로잡습니다. 실제 데이터베이스 사본에서는 781개 프로파일 가운데 10개가 바뀌었습니다. 표층 염분 하나가 27.581에서 33.995로 바뀌었고, 100 dbar 안에 쓸 값이 없는 프로파일의 염분 39.063은 빠졌습니다.
  • GOSUD outages recorded as "no ship observations". Every HTTP 404 from the GOSUD server was taken as an empty answer, including the 404 the server sends while it cannot find the dataset. Only the "no matching results" 404 now means no observations; any other 404 is recorded as a failure, as for Argo.
    GOSUD 장애가 "선박 관측 없음"으로 기록되던 문제. GOSUD 서버의 HTTP 404를 모두 빈 응답으로 받아들였는데, 서버가 자료 집합을 찾지 못할 때 보내는 404도 여기에 들어갔습니다. 이제 "일치하는 결과 없음" 404만 관측 없음으로 보고, 나머지 404는 Argo와 같이 실패로 기록합니다.

After updating / 올린 뒤

  • The first time 0.1.7 opens an existing database it adds the range-check column and recalculates the ion rows of the salinity already collected. Nothing has to be done by hand.
    0.1.7이 기존 데이터베이스를 처음 열 때 범위 검사 열을 더하고, 이미 쌓인 염분의 이온 행을 다시 계산합니다. 손으로 할 일은 없습니다.

Full list: CHANGELOG.md.