MakeGraph 2022 - 편집 역사

2022년 5월 5일 (목) 21:43에 대한 Admin의 편집

2022-05-05T21:43:30Z

2022년 5월 5일 (목) 21:42에 대한 Admin의 편집

2022-05-05T21:42:37Z

Admin: /* MakeGraph 사용 방법 */

2022-05-05T21:27:53Z

‎MakeGraph 사용 방법

2022년 4월 28일 (목) 21:14에 대한 Admin의 편집

2022-04-28T21:14:39Z

차이 보기

2022년 4월 28일 (목) 21:13에 대한 Admin의 편집

2022-04-28T21:13:56Z

2022년 4월 28일 (목) 21:06에 대한 Admin의 편집

2022-04-28T21:06:03Z

차이 보기

Admin: 새 문서: {|class="metadata" style="width:300px" align="right" |- |style="text-align:right" | 240px |- |style="text-align:right" | 김현
한국학중앙...

2022-04-28T20:55:44Z

새 문서: {|class="metadata" style="width:300px" align="right" |- |style="text-align:right" | 240px |- |style="text-align:right" | 김현<br/>한국학중앙...

새 문서

{|class="metadata" style="width:300px" align="right"
|-
|style="text-align:right" | [[파일:MakeGraphLogo.jpg|240px]]
|-
|style="text-align:right" | [[김현]]<br/>한국학중앙연구원 인문정보학 교수
|}
==네트워크 그래프 작성 도구: MakeGraph==

*이 문서는 네트워크 그래프 작성 프로그램 '''makeGraph2021'''의 사용법을 설명합니다.
*'''makeGraph2021'''은 '''[http://visjs.org Vis.js]'''의 Network Library를 활용한 '''네트워크 그래프 시각화 (Network Graph Visualization)''' 프로그램입니다.
*'''makeGraph2021'''를 사용하면 '''[[온톨로지의 이해|온톨로지]]''' 설계 방식으로 대상 세계를 시각화할 수 있습니다.
*'''makeGraph2021'''는 한국학중앙연구원 디지털인문학연구소(소장: [[김현]] 교수)에서 인문정보학 교육 도구로 개발하였으며, 누구나 사용할 수 있습니다.
*'''makeGraph2021'''로 제작한 그래프를 다른 On-Line 또는 Off-Line저작물의 제작에 사용한 경우, 이를 다음과 같이 표시하여 주시기 바랍니다.
{|class="wikitable"
| style="color:green" | "이 저작물상의 네트워크 그래프는 [http://visjs.org '''<i>Vis.js</i>''' 네트워크 라이브러리 (Copyright (C) 2010-2017 Almende B.V. )]와 '''한국학중앙연구원 디지털인문학연구소'''에서 제공하는 온톨로지 스크립트 변환기 (http://dh.aks.ac.kr, [http://dh.aks.ac.kr/Edu/wiki/index.php?title=MakeGraph_2018 '''<i>makeGraph2021</i>''')]로 제작하였습니다."
|-
|style="color:green" | “Network graphs in this work were created using [http://visjs.org '''<i>Vis.js</i>''' Network Library (Copyright (C) 2010-2017 Almende B.V. )] and Simple Ontology Script Converter (Provided by '''Center for Digital Humanities, AKS.''' [http://dh.aks.ac.kr/Edu/wiki/index.php?title=MakeGraph_2018 '''<i>makeGraph2021</i>''' ])].”
|-
|}

==최신 버전의 부가/변경 사항==

===makeGraph2021v2.exe===
{|class="wikitable"
! version: 2021ve .... 2021-05-15
|-
| style="color:green" |
# '''3 종류의 네트워크 그래프의 레이아웃을 제공하며, 결과 화면 하단 우측의 버튼으로 그래프 형태를 선택할 수 있습니다.''' <br/ >
|-
|}

===makeGraph2021.exe===
{|class="wikitable"
! version: 2021 .... 2021-05-05
|-
| style="color:green" |
# '''실행 프로그램은 파일은 makeGraph2021.exe 하나이며, 별도의 설치 절차가 필요 없습니다.''' <br/ >
# '''lst 파일 데이터에 문법적 오류가 있을 때, 오류 내용을 네트워크 그래프 형태로 표시합니다.''' <br/ >
# '''입력 데이터를 저장하는 lst 파일의 문자 코드는 'UTF-8'이어야 합니다.''' <br/ >
|-
|}

==네트워크 작성 도구 다운로드==

* 아래의 링크를 클릭해서 네트워크 작성 도구 압축 파일을 다운로드 받으세요.
{|class="wikitable"
| style="text-align:center" | [http://dh.aks.ac.kr/Graph/makeGraph2021/makeGraph2021.zip 네트워크 작성 프로그램 makeGraph2021.exe 다운로드] (최신 버전 게시 일자: 2021. 5. 15 )
|-
|}
* 다운로드 받은 압축 파일 makeGraph2021.zip 안에는 다음과 같은 파일이 들어 있습니다.
{|class="wikitable"
| style="text-align:center" | [[File:makeGraph2021v2Folder.jpg|600px]]
|-
|}

* '''makeGraph2021.exe'''의 ''''바로 가기'''' 아이콘을 만들어서 ''''바탕 화면''''에 옮겨 놓으세요.

[[File:makeGraph2021exe.png|90px]]

==MakeGraph 사용 방법==

* 예제 데이터 파일이 있는 sample1 폴더로 가세요.

* 네크워크 설계 스크립트 파일 '''예제1.lst'''를 마우스로 끌어서 [[File:makeGraph2021exe.png|90px]]에 떨어뜨리면 네트워크 시각화 파일 '''예제1.htm'''이 생성됩니다.

* 네트워크 시각화 파일 '''예제1.htm'''을 클릭하면 브라우저 상에서 다음과 같은 그래프 네트워크가 표현됩니다.

<html>
<iframe width="800" height="480px" src="http://dh.aks.ac.kr/Graph/makeGraph2021/sample1/예제1.htm" frameborder="0" allowfullscreen></iframe>
</html>

==온톨로지 설계 스크립트 파일 작성 방법==

* '''온톨로지 설계 스크립트'''는 일반적인 텍스트 파일('''encoding: utf-8''')로 작성합니다. 확장자는 '''lst'''입니다.

* 스크립트 파일 안에 다음과 같은 데이터를 기록합니다.

=== Script: 예제1.lst===

(예제 1)에서는 가장 간단한 형태의 온톨로지 스크립트를 소개합니다.

<pre>
#Project
h1 나의 첫번째 네트워크 그래프

#Class
사람
동물
음식

#Relation
likes
loves
isCloseTo

#Nodes
철수 사람 철수 files/sample1.htm#Cheol-su
영이 사람 영이 files/sample1.htm#Yeong-i
보미 동물 보미 null
커피 음식 커피 files/sample1.htm#Coffee
크림 음식 아이스크림 files/sample1.htm#IceCream

#Links
철수 크림 likes
영이 커피 likes
영이 보미 isCloseTo
철수 영이 loves

#End
</pre>

===#Project===
*네트워크 그래프의 제목, 주제 등을 표시합니다.
*'''h1''' ~ '''h7'''의 '''헤딩 표시자'''를 사용하여 문자의 크기를 지정할 수 있습니다.
*프로젝트 헤딩은 1줄 또는 2줄 이상, 최대 10줄까지 쓸 수 있습니다.

===#Class===
*그래프로 표시하고자 하는 대상 세계의 '''범주(Class)'''를 지정합니다.
*'''범주(Class)''' 개념에 대해서는 이 '''위키'''의 '''[[온톨로지의 이해]]'''를 참고 하세요.

===#Relation===
*'''노드''' 사이의 '''관계성'''을 지정합니다.
*'''관계성(Relation)''' 개념에 대해서는 이 '''위키'''의 '''[[온톨로지의 이해]]'''를 참고 하세요.

===#Nodes===
*대상 세계에 존재하는 각각의 '''노드(Node)'''를 지정합니다.
*'''노드(Node)''' 개념에 대해서는 이 '''위키'''의 '''[[데이터의 시각화: 네트워크 그래프]]'''를 참고 하세요.
*'''노드''' 지정을 위한 필수 요소는 '''노드 식별자''', '''범주''', '''노드 레이블''' 등 3 가지입니다.
* '''노드 식별자'''는 컴퓨터가 하나의 노드를 유일하게 식별할 수 있게 하는 이름입니다. 중복된 이름이 있어서는 않됩니다.
* '''노드 레이블'''은 그래프 상에서 노드의 이름으로 표시하기 위한 이름입니다. 중복이 있어도 무방합니다.
* 네 번째 요소 '''DATA URL'''을 추가할 경우, 네트워크 그래프 상에서 노드를 클릭하면, 해당 URL로 이동합니다.
*각 '''노드'''의 '''범주''' 이름은 반드시 '''#Class 섹션'''에서 정의된 것이어야 합니다. 그렇지 않은 경우 그래프 생성이 이루어지지 않습니다.

===#Links===
*'''노드(Node)'''와 '''노드(Node)'''를 잇는 '''링크(Link)'''를 지정합니다.
*'''링크(Link)''' 개념에 대해서는 이 '''위키'''의 '''[[데이터의 시각화: 네트워크 그래프]]'''를 참고 하세요.
*'''링크''' 지정은 '''첫번째 노드 식별자(Domain)''', '''두번째 노드 식별자(Range)''', '''두 노드 사이의 관계성(Relation) 이름''' 순으로 기술합니다.
*두 노드 사이의 '''관계성 이름'''은 반드시 #Relation 섹션에서 정의된 것이어야 합니다. 그렇지 않은 경우 그래프 생성이 이루어지지 않습니다.

===#End===
*스크립트의 끝을 알리는 표시자입니다.

==노드와 링크의 모양 지정 방법==

===Script: 예제2.lst===

(예제 2)는 범주별로 노드의 모양을 지정하는 방법과, 관계성 표시 화살표의 모양을 지정하는 방법을 소개합니다.

<pre>
#Class
사람 blue circle
동물 red box
음식 green ellipse

#Relation
likes 좋아한다 arrow
loves 사랑한다 moving-arrows
isCloseTo 친하다 both
</pre>

===#Class===
*'''#Class''' 색션에서 '''범주 이름''' 뒤에 이 범주에 속하는 '''노드'''의 표시 색상, '''노드''' 표시 모양을 추가로 지정할 수 있습니다.
*'''노드 표시 색상''': HTML 문서에서 쓸 수 있는 모든 색상을 사용할 수 있습니다. '''<font color="red">red</font>, <font color="blue">blue</font>, <font color="green">green</font>''' ....
*'''노드 표시 모양''': '''box'''(사각형), '''circle'''(원), '''ellipse'''(타원), '''star'''(별), '''triangle'''(삼각형), '''square'''(정사각형), '''dot'''(점), '''text'''(문자열)

===#Relation===
*'''#Relation''' 색션에서 '''관계성 이름''' 뒤에 관계성의 '''다른 이름''', 관계성 표시 '''화살표의 모양'''을 추가로 지정할 수 있습니다.
*관계성의 '''다른 이름''': 예를 들어, ''''isRelatedTo''''라는 관계성 ''''이름''''에 대해 ''''~와_관계가_있다''''라는 ''''다른 이름 (또는 설명)''''을 병기해 줄 수 있습니다. 그래프 상에서 ''''이름''''과 ''''다른 이름(설명)''''은 선택적으로 표시될 수 있습니다. (예제 5에서 설명)
*'''화살표의 모양''': '''arrow'''(--->), '''inverse'''(<---), '''both'''(<-->), '''moving-arrows'''(->->), '''line'''(----) 중에서 선택할 수 있습니다.

===Graph: 예제2.htm===

* 네크워크 설계 스크립트 파일 '''예제2.lst'''를 마우스로 끌어서 '''MakeGraph 2018 droplet'''에 떨어뜨리면 네트워크 시각화 파일 '''예제2.htm'''이 생성됩니다.
* 네트워크 시각화 파일 '''예제2.htm'''을 클릭하면 브라우저 상에서 다음과 같은 그래프 네트워크가 표현됩니다.

<html>
<iframe width="800" height="480px" src="http://dh.aks.ac.kr/Graph/makeGraph2021/sample1/예제2.htm" frameborder="0" allowfullscreen></iframe>
</html>

==이미지 아이콘의 표시==

===Script: 예제3.lst===

(예제 3)은 노드를 ICON으로 표시하는 방법을 소개합니다.

<pre>
#Nodes
철수 사람 철수 files/sample1.htm#Cheol-su files/Cheol.png
영이 사람 영이 files/sample1.htm#Yeong-i files/Yeong.png
보미 동물 보미 null files/Dog.png
커피 음식 커피 files/sample1.htm#Coffee files/Coffee.png
크림 음식 아이스크림 files/sample1.htm#IceCream files/IceCream.png
</pre>

*'''#Nodes 섹션''' 에서 Hyperlink URL 뒤에 ICON 이미지 URL을 지정하면 해당 노드를 ICON으로 표시한 그래프가 출력됩니다.
*Hyperlink URL을 지정하지 않고, ICON 이미지 URL만 지정하고 싶을 때에는 Hyperlink URL 자리에 '''null'''을 입력하면 됩니다.

===Graph: 예제3.htm===

<html>
<iframe width="800" height="480px" src="http://dh.aks.ac.kr/Graph/makeGraph2021/sample1/예제3.htm" frameborder="0" allowfullscreen></iframe>
</html>

===Script: 예제4.lst===

(예제 4)는 노드 표시의 다양한 방법을 방법을 소개합니다.

<pre>
#Nodes
철수 사람 철수 files/sample1.htm#Cheol-su files/Cheol.png 1
영이 사람 영이 files/sample1.htm#Yeong-i files/Yeong.png 1
보미 동물 보미 null files/Dog.png 2
커피 음식 커피 files/sample1.htm#Coffee files/Coffee.png 0
크림 음식 아이스크림 files/sample1.htm#IceCream files/IceCream.png 0
</pre>

*'''#Nodes 섹션'''에서 이미지 URL 뒤에 노드 표시 옵션을 지정할 수 있습니다.
** 0: 아이콘 감춤. 노드 위치에 ICON을 표시하지 않고, Text Label만 표시합니다. 이 경우, 노드 위치에 커서를 올려 놓을 때만 (hover) ICON 이미지가 표시됩니다.
** 1: 기본 값. 노드를 ICON으로 표시합니다. 이 경우, 노드 위치에 커서를 올려 놓으면 노드 레이블 텍스트를 담은 말풍선이 표시됩니다. 이 텍스트에 밑줄이 있는 것은 클릭 시 Hyperlink가 된다는 표시입니다. (※ Hyperlink URL이 '''null'''인 경우 밑줄이 나타나지 않습니다.)
** 2: Circular Icon: 노드 ICON을 원형으로 표시합니다.

===Graph: 예제4.htm===

<html>
<iframe width="800" height="480px" src="http://dh.aks.ac.kr/Graph/makeGraph2021/sample1/예제4.htm" frameborder="0" allowfullscreen></iframe>
</html>

=='''관계성(링크)'''의 '''다른 이름(설명)'''을 그래프 상에 표시==

===Script: 예제5.lst===

(예제 5)는 그래프 상에 '''관계성(링크)'''을 표시할 때, '''이름''' 대신 '''다른 이름(설명)'''을 표시하는 방법을 소개합니다.

<pre>
#Relation
likes 좋아한다 arrow 2
loves 사랑한다 moving-arrows 2
isCloseTo 친하다 both 2
</pre>

* '''#Relation''' 섹션에서 화살표 모양 지정 뒤에 '''관계성 이름 표시 방법'''을 숫자로 지정할 수 있습니다.
** 0: '''관계성 이름'''이 보이지 않게 합니다. 노드와 노드를 잇는 화살표만 표시됩니다.
** 1: 기본 값. '''관계성 이름'''이 그래프의 링크 화살표 밑에 표시됩니다. 화살표 위에 커서를 놓으면(hover) '''다른 이름(설명)'''을 보이는 말풍선이 표시됩니다.
** 2: 그래프 상에 '''관계성 이름''' 대신 '''다른 이름(설명)'''이 표시됩니다. 화살표 위에 커서를 놓으면 '''관계성 이름'''을 보이는 말풍선이 표시됩니다.
** 3: 그래프 상에 '''관계성 이름'''과 '''다른 이름(설명)'''이 함께 표시됩니다.

===Graph: 예제5.htm===

<html>
<iframe width="800" height="480px" src="http://dh.aks.ac.kr/Graph/makeGraph2021/sample1/예제5.htm" frameborder="0" allowfullscreen></iframe>
</html>

==문제의 원인과 해결==

===네트워크 그래프 생성이 안되는 경우===

===='''#'''으로 시작하는 섹션 이름을 잘못 표기====

* 이 경우, 다음과 같은 Error Message가 표시됩니다.

[[File:networkGraphError1.jpg|500px]]

===='''#Class 섹션'''에서 정의하지 않은 '''범주''' 이름을 '''#Nodes 섹션'''에서 사용====

* 이 경우, 다음과 같은 Error Message가 표시됩니다.

[[File:networkGraphError2.jpg|500px]]

* ☞ 잘못쓴 '''범주''' 이름을 고치거나, 필요한 '''범주''' 이름을 #Class 섹션에 추가합니다.

===='''#Relation 섹션'''에서 정의하지 않은 '''관계성''' 이름을 '''#Links 섹션'''에서 사용====

* 이 경우, 다음과 같은 Error Message가 표시됩니다.

[[File:networkGraphError3.jpg|500px]]

* ☞ 잘못쓴 '''관계성''' 이름을 고치거나, 필요한 '''관계성''' 이름을 '''#Relation 섹션'''에 추가합니다.

===='''#Nodes 섹션'''에서 정의하지 않은 '''노드''' 이름을 '''#Links 섹션'''에서 사용====

* 이 경우, 다음과 같은 Error Message가 표시됩니다.

[[File:networkGraphError4.jpg|500px]]

* ☞ 잘못쓴 '''노드''' 이름을 고치거나, 필요한 '''노드'''에 대한 정보(id, class, label, 참조 Url, icon Url 등)를 '''#Nodes 섹션'''에 추가합니다.

====스크립트 파일('''*.lst''')을 '''UTF-8'''이 아닌 '''Encoding'''으로 저장====

* 이 경우, 다음과 같은 Error Message가 표시됩니다.

[[File:networkGraphError5.jpg|500px]]

* ☞ 에디터상에서 스크립트 파일('''*.lst''')의 '''Encoding'''을 '''UTF-8'''로 변경하여 다시 저장합니다.

===HTML 파일이 만들어졌는데 그래프가 표시되지 않는 경우===

* ☞ PC 상에서 실행한 경우, 인터넷 접속이 되어 있는지 확인하세요. 인터넷에 접속한 상태에서만 실행이 됩니다.

* ☞ 웹 브라우저로 '''IE<sup>TM</sup>'''를 사용하는 경우, '''호환성 보기'''로 설정되어 있으면 해당 사이트 접속시 그래프가 표시되지 않습니다. '''호환성 보기'''를 해제하거나 '''Chrome<sup>TM</sup>''' 등 다른 브라우저를 사용하세요.

===그래프가 망가진 모양으로 표시되는 경우===

* ☞ 노드 표시 ICON 이미지의 URL이 잘못된 경우(이미지 파일이 없는 경우)일 가능성이 많습니다. 정확한 이미지의 URL을 지정하거나 '''#Nodes 섹션'''에서 각 노드의 이미지 표시 여부를 '''0'''으로 한 후 다시 실행해 보세요.

==='''노드''' 이름 또는 '''관계성(링크)''' 이름에 공백 문자 사용===

* '''범주 이름''', '''관계성 이름''', 관계성의 '''다른 이름''', '''노드 식별자''', '''노드 레이블''' 안에는 모두 '''공백 문자(white space)'''를 쓸 수 없습니다. 단어를 띄어쓸 필요가 있을 때에는 공백 문자 대신 ''''_'''' 기호를 쓰세요.

===데이터 파일 안에 홑따옴표("'", single quotation mark) 사용===

* 어디에서도 홑따옴표("'", single quotation mark)가 쓰이면 안됩니다. 다른 기호를 쓰세요.

==위키 페이지에 그래프 삽입하기==

* 위키 문서 상에서 네트워크 그래프를 사용하려면 [[Network Graph in Wiki]] 문서를 참조하세요.
* 한국학중앙연구원 디지털인문학연구소의 위키 시스템이 아닌 경우에는 Html 스크립트 파일을 서버에 업로드하고, 위키 문서에 아래와 같은 스크립트를 삽입하시면 됩니다.

<syntaxhighlight lang="html4strict">
<html>
<iframe width="90%" src="네트워크 그래프 문서의 웹 주소" frameborder="0" allowfullscreen></iframe>
</html>
</syntaxhighlight>

==그래프용 아이콘 URL==

*[http://dh.aks.ac.kr/Encyves/wiki/index.php/그래프용_아이콘 그래프용 아이콘 URL 참조 사이트]

[[분류: 튜토리얼]]

@@ 258번째 줄: / 258번째 줄: @@
 네트워크 그래프가 하면에 출력될 때 하단 우측의 버튼으로 그래프 레이아웃을 변경할 수 있습니다.
-===Normal==
+===Normal===
 [[File:s0-503.jpg|600px]]

@@ 170번째 줄: / 170번째 줄: @@
 *관계성의 '''다른 이름''':  예를 들어, ''''isRelatedTo''''라는 관계성 ''''이름''''에 대해 ''''~와_관계가_있다''''라는 ''''다른 이름 (또는 설명)''''을 병기해 줄 수 있습니다. 그래프 상에서 ''''이름''''과 ''''다른 이름(설명)''''은 선택적으로 표시될 수 있습니다. (예제 5에서 설명)
 *'''화살표의 모양''': '''arrow'''(--->), '''inverse'''(<---), '''both'''(<-->), '''moving-arrows'''(->->), '''line'''(----) 중에서 선택할 수 있습니다.
 ===Graph: 예제2.htm===
@@ 252번째 줄: / 253번째 줄: @@
 <iframe width="800" height="480px" src="http://dh.aks.ac.kr/Graph/makeGraph2021/sample1/예제5.htm" frameborder="0" allowfullscreen></iframe>
 </html>
 ==문제의 원인과 해결==

@@ 64번째 줄: / 64번째 줄: @@
 * 예제 데이터 파일이 있는 sample1 폴더로 가세요.
-* 네크워크 설계 스크립트 파일 '''예제1.lst'''를 마우스로 끌어서 [[File:makeGraph2021exe.png|90px]]에 떨어뜨리면 네트워크 시각화 파일 '''예제1.htm'''이 생성됩니다.
+* 네크워크 설계 스크립트 파일 '''예제1.lst'''를 마우스로 끌어서 [[File:makeGraph2022exe.png|90px]]에 떨어뜨리면 네트워크 시각화 파일 '''예제1.htm'''이 생성됩니다.
 * 네트워크 시각화 파일 '''예제1.htm'''을 클릭하면 브라우저 상에서 다음과 같은 그래프 네트워크가 표현됩니다.

@@ 27번째 줄: / 27번째 줄: @@
 | style="color:green" |
 # '''3 종류의 네트워크 그래프의 레이아웃을 제공하며, 결과 화면 하단 우측의 버튼으로 그래프 형태를 선택할 수 있습니다.'''
-# #Relation 섹션에서 연결선의 모양을 '''sequence'''로 설정하면, 오렌지색 굵은 화살표로 표시됩니다.  <br/ >
+# #Relation 섹션에서 연결선의 모양을 '''sequence'''로 설정하면, 오렌지색 굵은 화살표로 표시됩니다. (ex.) isPreviousTo ~보다_먼저이다 sequence <br/ >
-	#Relationlikes		좋아한다	arrow
-	isPreviousTo ~보다_먼저이다 sequence
 |-
 |}