Soil Tiller Calculator

성능 계산 기능

이 프로그램은 다음 항목을 계산합니다:

• 인발력 F (뉴턴 단위)
• 유저 저항력 q (뉴턴/미터 단위)
• 인발 동력 P (킬로와트 단위)
• 연료 소비 Q (리터/시간 단위, 한 도구당)

도구 비교 및 분석

사용자는 두 가지 도구를 유저 저항력 기준으로 비교할 수 있습니다. 이는 표준 КПС-4,0 도구, 실험용 도구 또는 사용자 정의 도구 간 성능 차이를 분석하는 데 유용합니다.

사용자 정의 도구 관리

사용자는 다음과 같은 매개변수로 자신만의 작업 도구를 정의할 수 있습니다:

• 기술적 식별자 (id)
• 도구 이름
• 작업 폭 (미터 단위)
• 참조 깊이 (센티미터 단위)
• 참조 점들 (속도:힘 쌍)
• 그래프에서의 선 색상 및 스타일

참조 점 사이에서는 선형 보간법을, 범위 밖에서는 선형 외삽법을 사용하여 힘을 계산합니다.

Windows용 Chocolatey 설치

Chocolatey 패키지 관리자를 통해 간단히 설치할 수 있습니다. 관리자 권한으로 PowerShell을 열고 다음 명령을 실행합니다:

choco install soil-tiller-calculator

설치 후 다음 명령으로 프로그램을 실행할 수 있습니다:

soil-tiller-calculator

또는 짧은 별칭:

stc

Chocolatey 패키지는 Windows용 ZIP 아카이브를 다운로드하여 패키지 디렉터리에 압축을 풀고, soil-tiller-calculator 및 stc 두 가지 명령을 생성합니다.

수동 설치 (ZIP 아카이브)

GitHub 릴리스 페이지에서 SoilTillerCalculator-windows.zip 파일을 다운로드합니다. 아카이브를 완전히 압축 해제한 별도 폴더에 두고 다음 명령을 실행합니다:

.SoilTillerCalculator.exe

중요: 실행 파일을 ZIP 아카이브 안에서 직접 실행하지 마세요. _internal 폴더에 필수 라이브러리가 있어야 정상 작동합니다.

기본 사용법

1. 먼저 토양 처리 깊이를 지정합니다.
2. 도구 모드를 선택합니다: 단일 도구 사용, КПС/실험용 도구 비교, 또는 사용자 정의 도구 비교 중 하나입니다.
3. 속도 모드를 결정합니다: 수동 입력 또는 자동 최적화 탐색 중 선택합니다.
4. ‘실행 계산’ 버튼을 클릭합니다.

계산 결과는 화면 오른쪽에 표시되며, 텍스트 블록에서 각 기호의 의미를 확인할 수 있습니다:

• F — 인발력
• q — 유저 저항력
• P — 인발 동력
• Q — 연료 소비

설정 및 구성

주요 설정은 상단 메뉴에서 접근할 수 있습니다:

• 파일: JSON 설정 파일 내보내기/가져오기, 설정 파일 저장 위치 선택, 기본 위치로 복원
• 도구: 작업 중인 도구들의 추가, 편집, 삭제 및 관리
• 설정: 인터페이스 언어 선택, 사용자 정의 속도 및 깊이 임계값 조정, 최적화 속도 탐색 단계 설정

기본 설정 파일 저장 위치는 다음과 같습니다:

• Windows: %APPDATA%SoilTillerCalculatorconfig.json
• Linux: $XDG_CONFIG_HOME/soil-tiller-calculator/config.json 또는 ~/.config/soil-tiller-calculator/config.json

사용자가 다른 저장 위치를 선택하면, 해당 경로는 config-location.json 파일에 기록되어 기억됩니다.

고급 실행 옵션

명령줄에서 다음과 같은 옵션을 사용할 수 있습니다:

• 기본 실행: soil-tiller-calculator 또는 stc
• 직접 모듈 실행: python -m soil_tiller_calculator
• 디버그 로그 활성화: soil-tiller-calculator –debug (상세 로그는 %APPDATA%SoilTillerCalculatordebug.log에 기록)
• 함수 호출 트레이싱: soil-tiller-calculator –debug-trace (매우 상세하며 실행 속도 저하 유발)

윈도우 창 버전에서 심각한 시작 오류가 발생하면, 오류 내용은 %APPDATA%SoilTillerCalculatorstartup-error.log 파일에 기록됩니다.