Formula Editor

개요 및 개발 배경

브레이크, 센서, 제어 루프에 대한 요구사항에는 정지 거리, 공차, 필터 같은 공식이 자주 필요합니다. DOORS Next에는 공식 편집기가 없습니다. 팀은 Word에서 가져온 스크린샷을 붙여 넣는데, 원본 파일 없이는 나중에 아무도 바꿀 수 없습니다. 아니면 공식을 일반 텍스트로 입력하는데, 읽기가 어렵습니다.

Formula Editor를 사용하면 DOORS Next 안에서 LaTeX로 공식을 작성할 수 있습니다. 입력하는 대로 공식을 그리고, 선택한 아티팩트 뒤의 새 아티팩트나 선택한 아티팩트에 그림으로 모듈에 넣습니다. LaTeX는 아티팩트와 함께 저장되므로, 나중에 공식을 선택하면 편집기에서 다시 열립니다.

해결하는 문제

• 스크린샷으로 붙여 넣어, 원래의 Word 파일 없이는 아무도 바꿀 수 없는 공식.
• s = v^2/(2*mu*g)처럼 일반 텍스트로 입력되어 검토와 내보내기에서 읽기 어려운 공식.
• 둘 중 하나를 손으로 바꾼 뒤 텍스트와 더 이상 맞지 않는 공식 그림.
• 공식을 새로 만들거나 바꿀 때마다 다른 도구로 전환하고 그림을 다시 복사해 오는 작업.

이점

• 입력하는 대로 확인: 작성하는 동안 미리 보기가 공식을 그리고 그림의 크기를 보여 줍니다.
• 나중에도 변경 가능: LaTeX가 아티팩트에 보관되므로 공식을 선택하면 다시 열리고, Update가 새 그림을 그립니다.
• 텍스트는 그대로: 텍스트가 있는 아티팩트에 Update를 하면 공식이 텍스트 뒤에 추가되고 문구는 유지됩니다.
• 다른 웹사이트 불필요: 공식은 MathJax가 브라우저에서 그리며, 온라인 편집기로 보내지지 않습니다.
• 위치와 함께 표시되는 오류: 빠진 중괄호나 알 수 없는 명령은 필드 아래에 해당 문자 위치와 함께 표시됩니다.

사용 방법

1. 모듈을 열고 아티팩트 하나를 선택합니다.
2. LaTeX로 공식을 입력하거나 필드 아래의 키를 클릭합니다: 분수, 근호, 거듭제곱, 아래 첨자, 합, 적분, 그리스 문자, 플러스마이너스, 행렬. More symbols를 누르면 21개가 더 표시됩니다. 미리 보기에 그림과 크기가 표시됩니다.
3. Insert를 클릭하면 선택한 아티팩트 뒤의 새 아티팩트에 공식을 추가하고, Update를 클릭하면 선택한 아티팩트에 씁니다. 확인 메시지를 읽고 Insert formula 또는 Update formula를 클릭합니다.
4. 결과 블록에 수행된 작업이 표시되며, Log로 변경 보고서를 다운로드할 수 있습니다.
5. 공식을 바꾸려면 모듈에서 그 공식을 선택합니다. 위젯에서 열리면(Editing 1531 …) LaTeX를 바꾸고 Update를 클릭합니다.

참고 사항

• 결과가 원하는 대로가 아니면 버릴 수 있도록 변경 세트 안에서 작업하십시오. 새 아티팩트는 바로 저장됩니다.
• 그림은 DOORS Next 서버에 저장되는 PNG이며, 두 배 크기로 그려지므로 화면과 내보내기에서 선명하게 유지됩니다. Settings에는 S, M, L의 세 가지 크기가 있습니다.
• 프로젝트에 Formula라는 속성이 있으면 LaTeX가 그 속성에 들어가고, 그림 설명에는 항상 들어갑니다. 따라서 이 속성이 없는 프로젝트에서도 공식을 다시 열 수 있습니다.
• 새 아티팩트는 선택한 아티팩트의 유형을 받습니다. Settings에서 Insert에 사용할 프로젝트의 다른 아티팩트 유형을 고를 수 있으며, 위젯은 이를 프로젝트별로 기억합니다. Update는 유형을 유지합니다.
• 공식의 그림이 손으로 교체된 경우 위젯이 이를 알려 주고, Update 확인 메시지에서 그 변경이 사라진다고 경고합니다. 항상 LaTeX가 우선합니다.