File Exchange 정보
File Exchange를 사용하여 사용자 지정 응용 프로그램, 클래스, 코드 예제, 드라이버, 함수, Simulink 모델, 스크립트 및 비디오를 찾고 공유할 수 있습니다. File Exchange를 통해 다음과 같은 작업을 수행할 수 있습니다.
- 파일 제출
- GitHub 리포지토리에 연결
- MATLAB 코드를 포함하는 웹 사이트 공유
- 라이선스 정보
- 다른 사용자가 내 작업을 인용할 수 있도록 지침 제공
- 콘텐츠 유형, 검색 상자 및 검색 지시어를 사용하여 파일 찾기
- 추후에 조회, 리뷰 및 토론할 수 있도록 태그를 추가하여 제출물에 주석 추가
- 회원들이 사용, 태깅 및 평가하는 파일을 제출하여 커뮤니티 내 인지도 향상
- 배지 획득
- 평판 쌓기
- 질문 및 사용자 의견
File Exchange 사용은 MATLAB Central 사용 약관의 적용을 받습니다.
파일 제출
최대 250MB의 파일을 제출할 수 있습니다. 파일을 제출하려면 커뮤니티 프로필에 로그인하세요. 프로필이 없으면 새로 만들어야 합니다. 계정 페이지에서 “게시”를 클릭하여 컴퓨터에 있는 파일을 업로드하거나 GitHub 리포지토리에 연결할 수 있습니다.
GitHub 리포지토리에 연결
File Exchange와 GitHub를 연결하면 참여자가 두 곳에 모두 파일을 업로드할 필요 없이 단일 환경에서 소프트웨어 프로젝트를 개발할 수 있습니다. 참여자는 GitHub에서의 협업 개발이 주는 모든 이점을 얻을 수 있고, 커뮤니티 회원들은 File Exchange 또는 GitHub 중 어디서 시작하든 최신 버전의 프로젝트에 액세스할 수 있습니다. GitHub에 연결된 파일을 다운로드하는 커뮤니티 회원은 이러한 파일의 내용과 라이선싱을 확인할 책임이 있습니다.
GitHub 리포지토리에 연결하면 File Exchange는 File Exchange 및 애드온 탐색기에서 사용할 수 있도록 MathWorks 서버에 리포지토리 내용을 저장합니다. MathWorks 서버에 저장된 파일은 읽기 전용이며 GitHub의 변경 사항을 반영하도록 자동으로 업데이트됩니다. MathWorks는 리포지토리 내용을 저장하여 MATLAB 코드에 대한 미리보기를 제공하는 등 편리한 기능을 제공할 수 있습니다.
GitHub에 리포지토리를 연결하려면 다음 옵션 중 하나를 선택하세요.
- GitHub Releases – GitHub Releases는 권장되는 연결 방법입니다. 리포지토리를 배포할 준비가 되면 GitHub Releases를 사용하여 코드를 패키징하세요. GitHub Releases를 사용하면 GitHub에서 새 Release를 만들 때 File Exchange 제출물도 자동으로 업데이트됩니다.
GitHub Release를 만드는 경우:
- 코드를 툴박스로 패키징하는 경우 툴박스(.mltbx 파일)를 릴리스에 첨부하세요. 그러면 File Exchange가 툴박스를 다운로드로 제공합니다. 릴리스에 .mltbx 파일을 첨부하지 않을 경우 File Exchange는 zip 릴리스 자산을 사용합니다.
- 다음 팁을 따라 버전 레이블을 지정하세요.
- 버전을 major.minor.patch.extension(patch와 extension은 선택 사항임) 형식으로 입력합니다.
- 버전 번호는 6자리 미만이어야 합니다.
- 영숫자 레이블은 인식되지 않습니다(예: 2-beta).
- 릴리스에 mltbx 파일을 첨부할 때 패키지의 버전 번호를 GitHub 릴리스의 버전 번호와 동일하게 설정하세요.
- GitHub Releases에 대한 자세한 내용은 GitHub의 문서를 참조하세요.
- 디폴트 브랜치 – 이 방법의 경우 File Exchange는 파일 미리보기를 표시하고 다운로드할 패키지를 제공하기 위해 리포지토리의 디폴트 브랜치(일반적으로 "main" 또는 "master")를 사용합니다. 디폴트 브랜치에 커밋하는 변경 사항은 24시간 이내에 사용할 수 있습니다. 개발 공정에 따라 다르지만 File Exchange에서 디폴트 브랜치를 사용할 수 있도록 설정하면 사용자가 불안정한 코드를 받을 수도 있습니다. 안정적인 코드 배포를 위해 GitHub Releases를 사용하는 것을 권장합니다.
- Git LFS를 사용 중인 경우 코드를 툴박스로 패키징하고 mltbx 파일을 리포지토리의 GitHub Release에 첨부하세요. File Exchange의 디폴트 브랜치 연결에는 Git LFS가 지원되지 않습니다.
파일을 쉽게 찾고 사용하는 방법
- 제목과 설명이 명확하고 간결하면서도 내용을 잘 묘사해야 합니다.
- 제출물에 대한 내용이 가독성이 좋고 오타가 없는지 다시 한 번 읽어 보세요.
- 타겟 검색에 도움이 되는 태그를 사용하세요(태그 만들기 항목 참조).
- 이미지를 추가할 때 이미지가 코드와 동일한 디렉터리에 있고 동일한 파일 이름을 사용하는지 확인하세요.
- 제출물이 나올 수 있게 도움을 준 파일을 명시하세요. 도움 내용은 파일 페이지와 도움을 준 파일의 페이지에 표시됩니다.
라이선스 정보
라이선싱은 File Exchange에 있는 코드의 작성자 및 사용자로서 갖는 권리를 명시합니다. 라이선싱은 코드를 사용할 수 있다는 것을 상세하게 알려주고 수정, 배포 및 상업적 사용 권리에 대한 일반적인 질문에 대한 답을 제공합니다.
BSD 라이선스는 File Exchange에 직접 게시하는 코드에 대해 유일하게 지원되는 라이선스이며, 파일 업로드를 사용하여 File Exchange에 직접 제출한 커뮤니티 콘텐츠에 자동으로 추가됩니다. GitHub에 연결 또는 외부 웹 사이트에 연결를 사용하는 커뮤니티 기여에 대해서는 다른 라이선스 유형이 허용됩니다. 하드웨어 지원 패키지를 비롯한 MathWorks 임직원이 제출하는 제출물은 MathWorks 제한적 라이선스가 적용될 수 있습니다. 라이선스가 부여된 File Exchange 제출물에는 라이선스 보기 링크가 있습니다. File Exchange의 라이선싱에 대한 자세한 내용은 File Exchange 라이선싱 FAQ를 참조하세요.
다른 사용자가 내 작업을 인용할 수 있도록 지침 제공
인용 지침은 커뮤니티 회원이 자신의 연구 또는 파생 작업에서 여러분의 작업을 사용할 때 이를 참조할 수 있도록 도와줍니다. 예를 들어 다른 사람이 여러분의 File Exchange 세부 정보 페이지, 여러분이 쓴 연구 논문, 소속 그룹 또는 아티팩트를 인용하려는 경우가 있습니다.
새 File Exchange 항목은 여러분이 삭제할 수 있는 기본 인용 지침과 함께 생성됩니다. 이외에도 다음을 수행할 수 있습니다.
- 사용자 지정 텍스트를 사용하여 인용 지침 지정
- 다른 곳에서 생성해야 하는 DOI 지정(DOI.org의 설명 참조)
- 여러 개의 인용 지침 생성
수치 연산과 관련된 파일 검색. 왼쪽에 다양한 필터가 있는 영역이 있습니다.
콘텐츠 유형 찾아보기
File Exchange는 제출물과 연관된 정보를 기반으로 파일에 콘텐츠 유형을 할당합니다.
| 콘텐츠에 할당되는 유형 | 파일의 확장자 | 제출물에 포함된 기준 |
|---|---|---|
앱 |
.mlappinstall |
- |
드라이버 |
.mdd |
- |
예제 |
.m |
/html 서브디렉터리 및 MATLAB .m 파일과 이름이 동일한 .html 파일 |
함수 |
.m |
function 호출 |
Simulink 모델 |
.mdl |
- |
비디오 |
.avi, .mp4, .wmv, .mpg, .mov, .swf, .mpeg |
- |
팁: 파일 제출 시 제출물의 파일이 표시되지만 미리보기 이미지 대신 미리보기 이미지를 찾을 수 없음 메시지가 표시되는 경우, 코드와 동일한 파일 이름을 갖는 이미지를 같은 디렉터리에 추가하면 File Exchange에서 파일과 함께 이미지를 표시합니다. 예: "foo.mdl"이라는 파일이 있는 경우 이름이 foo.gif인 스크린샷을 추가하면 이 메시지 대신 Simulink 모델의 스크린샷이 사용자에게 표시됩니다.
라이선스 정보
라이선싱은 File Exchange에 있는 코드의 작성자 및 사용자로서 갖는 권리를 명시합니다. 라이선싱은 파일이 어떻게 사용될 수 있는지에 대한 자세한 정보와 수정, 배포 및 상업적 사용에 대한 권리와 관련된 일반적인 질문에 대한 답을 제공합니다.
BSD 라이선스는 File Exchange에 직접 게시하는 코드에 대해 유일하게 지원되는 라이선스이며, 파일 업로드를 사용하여 File Exchange에 직접 제출한 커뮤니티 콘텐츠에 자동으로 추가됩니다. GitHub에 연결 또는 외부 웹 사이트에 연결를 사용하는 커뮤니티 기여에 대해서는 다른 라이선스 유형이 허용됩니다. 하드웨어 지원 패키지를 비롯한 MathWorks 임직원이 제출하는 제출물은 MathWorks 제한적 라이선스가 적용될 수 있습니다. 라이선스가 부여된 File Exchange 제출물에는 라이선스 보기 링크가 있습니다. File Exchange의 라이선싱에 대한 자세한 내용은 File Exchange 라이선싱 FAQ를 참조하세요.
지시어를 사용하여 파일 찾기
검색 지시어를 통해 File Exchange에서 파일을 찾을 수 있습니다. 검색 상자에서 검색 지시어를 지정할 수 있습니다.
| 검색 결과 | 지시어 | 예 |
|---|---|---|
지정한 이름의 작성자 |
author: |
|
1에서 5까지 범위의 평균 파일 평점을 갖는 작성자 |
authoraverage: |
|
공개 프로필에서 지정된 회사/조직 이름이 기재된 커뮤니티 회원 |
organization: |
|
콘텐츠 유형 |
type: |
|
파일 세부 정보 페이지 상단에 표시되는 파일 식별 번호 |
id: |
|
지정된 문자열을 포함하는 라이선스 |
license: |
|
지정된 평균 커뮤니티 평점 |
rating: |
|
지정된 문자열의 태그가 적용된 퍼블리시된 제출물 |
tag: |
|
DOI 또는 사용자 지정 인용이 있는 파일 찾기 |
citation_type: |
지시어 사용
- 여러 단어로 구성된 어구를 검색하려면 이를 따옴표로 묶으세요(예:
author:"Helen Chen"). - 검색 결과를 좁히려면 검색에 여러 지시어를 조합하여 사용하세요. 각 지시어 사이에는 공백이 있어야 합니다. File Exchange는 지정된 모든 지시어와 일치하는 모든 파일을 찾습니다.
- 동일한 지시어에 대한 둘 이상의 값을 검색하려면 각 값마다 하나씩 지시어를 지정하세요. 예를 들어, 구문
tag:graphicstag:vector는graphics와vector가 동시에 태그로 지정된 파일을 전부 찾습니다. - 검색 결과에서 특정 파일을 제외하려면 지시어 구문 앞에 마이너스 기호(-)를 삽입하세요. 예를 들어, 구문
-tag:game은game태그가 있는 모든 파일을 제외합니다.
파일에 태그 지정
태그는 관심 있는 파일을 찾거나 기억하는데 도움을 줄 수 있는 책갈피와 같은 역할을 합니다. 태그를 이용하면 할당된 키워드를 사용하여 제출된 파일을 검색할 수 있습니다. 프로필이 있는 커뮤니티 회원은 아무 파일에나 태그를 지정할 수 있습니다. 모든 태그는 누구나 볼 수 있도록 공개됩니다.
여러분의 프로필에서 여러분이 파일에 적용한 태그를 볼 수 있습니다. 파일 내에서는 커뮤니티의 모든 사람들이 적용한 태그를 볼 수 있습니다. 태그를 지정하면 커뮤니티 회원들에게 여러분의 관심사에 대한 정보를 제공하여 협업과 아이디어 교환을 용이하게 할 수 있습니다.
여러분이 새 파일을 제출하거나 기존 파일을 볼 때 태그를 추가할 수 있습니다. 쉼표를 사용하여 여러 태그를 구분하고 인용 부호를 사용하여 여러 단어로 된 태그를 나타냅니다.
배지 획득
File Exchange 참여를 통해 배지를 획득할 수 있습니다. 획득한 배지는 여러분의 커뮤니티 프로필 페이지에 표시됩니다.
획득할 수 있는 배지의 예는 다음과 같습니다.
- 첫 번째 제출
- 첫 번째 리뷰
- 편집자 선정
- 개인 최다 다운로드
- 이외 다수
획득할 수 있는 배지 유형을 보려면 커뮤니티 배지 페이지를 참조하세요.
| 충족 조건 | 추가 점수 |
|---|---|
제출물이 "이주의 선정" 블로그에 포함될 경우 |
+50점 |
제출물이 연간 배지를 획득한 경우 |
+50점 |
제출물이 별 5개 평점을 받은 경우 |
+5점 |
제출물이 별 4개 평점을 받은 경우 |
+4점 |
제출물이 10회 다운로드된 경우 |
제출물이 지난 3개월 내에 업데이트되지 않은 경우 +1점 제출물이 지난 3개월 내에 업데이트된 경우 +2점 |
리더보드에서 평판이 가장 높은 사람을 볼 수 있습니다!
질문 및 사용자 의견
File Exchange에 대한 궁금한 사항이나 의견이 있는 경우 이 사용자 의견 포럼을 사용하세요. 카테고리는 "MATLAB Central"을 선택합니다. 특정 File Exchange 제출물의 기능과 관련된 질문 및 의견은 해당 제출물 내의 댓글 또는 토론을 통해 해결할 수 있습니다.
MATLAB Answers에서 커뮤니티 전문가들로부터 MATLAB 및 Simulink 관련 질문에 대한 답을 얻을 수 있습니다. 라이선싱 또는 다른 MathWorks 제품이나 서비스와 관련하여 추가 도움이 필요한 경우 지원팀에 문의하세요.
