You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/doc/en/3.2.-Files.md
+17-17Lines changed: 17 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,11 +6,11 @@ path: 3.2.-Files
6
6
7
7
## Importing files
8
8
9
-
Import text from plain text documents, docx, epub, md, odt, pdf and rtf (3.8+) documents. Import images from: jpg, jpeg and png. Import audio/video formats: mp3, m4a, mp4, wav, mov, ogg. Pdfs can be coded as text or as an image. Alternatively, you can link to files locally in your computer file system. This may be a good option if you have a specific folder structure that is important to your project.
9
+
Import text from plain text documents, docx, epub, md, odt, pdf, and rtf (3.8+) documents. Import images from: jpg, jpeg, and png. Import audio/video formats: mp3, m4a, mp4, wav, mov, ogg. PDFs can be coded as text or as images. Alternatively, you can link to files locally in your computer's file system. This may be a good option if you have a specific folder structure that is important to your project.
10
10
11
11
Import and link buttons: <imgwidth="92"height="43"alt="Import and link buttons"src="https://github.com/user-attachments/assets/dc98a9ef-0d0c-4365-b444-9b2c3f145cab" />
12
12
13
-
Linked files can be imported into the project folder, and conversely files stored in the project folder can be exported out of the project folder and linked to.
13
+
Linked files can be imported into the project folder, and conversely, files stored in the project folder can be exported out of the project folder and linked to.
14
14
15
15
Import linked, export to linked buttons: <imgwidth="88"height="45"alt="Import linked file, export to linked file buttons"src="https://github.com/user-attachments/assets/81951366-1a88-4069-b82d-8d959cf2aaf4" />
16
16
@@ -21,7 +21,7 @@ PDF importing can be problematic and may need editing as formatting is lost. Lar
21
21
### Pseudonymisation (data de-identification)
22
22
23
23
In version 3.8+ pseudonymisation is available to replace words or phrases.
24
-
For many languages (possibly except Chinese, Japanese, Korean), providing the character before the phrase and the character after the phrase are non-alphabetical and non-numerical, this is an easy cut-off to enact. Pseudonymisation is case-sensitive. Original words must be at least 2 characters long, and pseudonyms must be a least 3 characters long. Alternatively, leave the pseudonym entry blank, for a randomly generated term.
24
+
For many languages (possibly except Chinese, Japanese, Korean), providing the character before the phrase and the character after the phrase are non-alphabetical and non-numerical, this is an easy cut-off to enact. Pseudonymisation is case-sensitive. Original words must be at least 2 characters long, and pseudonyms must be at least 3 characters long. Alternatively, leave the pseudonym entry blank for a randomly generated term.
25
25
26
26
An 'Anonymise on import' button is accessed in Manage files. This allows you to enter a list of original terms to pseudonyms, and must be in place before any importing text documents. It does not apply retrospectively to already imported documents.
27
27
@@ -30,9 +30,9 @@ The button opens a window to allow the user to add, or remove from the list, the
30
30
31
31
The list you create is stored within the project folder, the qda folder. The list is stored in json format. After all importing is done, the researcher can remove the file to a different safe location, for reference as needed. The json file can be opened in a text editor such as NotePad.
32
32
33
-
Imported text files, and qualitative columns in imported surveys will be pseudonymised.
33
+
Imported text files and qualitative columns in imported surveys will be pseudonymised.
34
34
35
-
PDF files are not pseudonymised for two reasons. The PDF page can be viewed as is, in _Code Images_. Also, the exact text is needed for the plain text to PDF text, in the Code PDF area.
35
+
PDF files are not pseudonymised for two reasons. The PDF page can be viewed as is, in _Code Images_. Also, the exact text is needed for the plain text to PDF text in the Code PDF area.
36
36
37
37
## Auto speaker codings
38
38
@@ -47,7 +47,7 @@ PDF files are not pseudonymised for two reasons. The PDF page can be viewed as i
Each file is preceded with an icon that describes the type of file. Other columns show the file name, date of creation/upload, association with cases and other attributes. The screenshot above shows a use created attribute called 'origin' and reference columns (where a file is linked to a reference).
50
+
Each file is preceded by an icon that describes the type of file. Other columns show the file name, date of creation/upload, association with cases, and other attributes. The screenshot above shows a use created attribute called 'origin' and reference columns (where a file is linked to a reference).
51
51
52
52
## General functions
53
53
@@ -62,7 +62,7 @@ This button allows you to bulk rename files:
62
62
63
63
## Large text files
64
64
65
-
When coding really large text files QualCoder becomes slow. In _Code Text_, QualCoder can split the files into 50,000 character chunks to reduce the slowness of the program. However, the best option when importing large text files is to split them into separate sections and load those smaller sections as separate files instead. Give each filename some ordered logic too, e.g. book_chap01.txt, book_chap02.txt.
65
+
When coding really large text files QualCoder becomes slow. In _Code Text_, QualCoder can split the files into 50,000 character chunks to reduce the slowness of the program. However, the best option when importing large text files is to split them into separate sections and load those smaller sections as separate files instead. Give each filename some ordered logic too, e.g., book_chap01.txt, book_chap02.txt.
66
66
67
67
## Attributes
68
68
@@ -76,16 +76,16 @@ Attributes can be exported to an Excel file via a button: <img width="53" height
76
76
77
77
### Filtering rows
78
78
79
-
The right-click context menu also allow you to re-order the files according to name, date, and file-type and when right clicking in the name or date columns. You can show only selected attribute types: Choose Show this value option
79
+
The right-click context menu also allows you to re-order the files according to name, date, and file-type and when right clicking in the name or date columns. You can show only selected attribute types: Choose Show this value option
80
80
You can also select Show values like. Show values like can be applied multiple times to further shorten the list of displayed rows.
81
81
82
82
### Column visibility
83
83
84
-
Sometimes a lot of columns can be displayed which can be overwhelming. You can hide columns by right-click on the table header row for options to hide that column or to hide columns beginning with specific text. Or to show columns where the column name starts with specific text.
84
+
Sometimes, a lot of columns can be displayed, which can be overwhelming. You can hide columns by right-clicking on the table header row for options to hide that column or to hide columns beginning with specific text. Or to show columns where the column name starts with specific text.
85
85
86
86
### Save and load column and row filters
87
87
88
-
There are three buttons to save, load and delete filter settings, so that you can view the mange files table in ways that you want, quickly.
88
+
There are three buttons to save, load and delete filter settings, so that you can view the manage files table in ways that you want, quickly.
89
89
90
90
<imgwidth="132"height="47"alt="Buttons to save, load and delete table filters"src="https://github.com/user-attachments/assets/96ae69f5-1493-4aa8-a3f5-31ee15c22fef" />
91
91
@@ -103,13 +103,13 @@ You can assign a file to a case via right-click menu when in the cases column.
103
103
104
104
## Artificial Intelligence
105
105
106
-
If you have enabled AI integration in QualCoder, newly imported text files will be read by the local AI model and stored in its local memory. This happens in the background (status bar shows "AI: reading"). You can continue to use QualCoder, but the AIenhanced features will not be available until the AI has finished updating its memory. This also happens if you edit an already imported text file in QualCoder.
106
+
If you have enabled AI integration in QualCoder, newly imported text files will be read by the local AI model and stored in its local memory. This happens in the background (status bar shows "AI: reading"). You can continue to use QualCoder, but the AI-enhanced features will not be available until the AI has finished updating its memory. This also happens if you edit an already imported text file in QualCoder.
107
107
108
108
If you ever get the impression that the AI memory is out of sync and has missed some updates to your data (which should not happen under normal circumstances), you can rebuild the memory from scratch by selecting "AI > Rebuild Internal Memory". This will reread all documents, which may take a while.
109
109
110
110
## Text file creation and editing
111
111
112
-
You can create and enter text into text in the database, by pressing the pencil icon.
112
+
You can create and enter text into text in the database by pressing the pencil icon.
113
113
114
114
Create text entry button: <imgwidth="57"height="47"alt="Pencil icon button, to create a plain text file"src="https://github.com/user-attachments/assets/3e25677d-56de-48b5-81e3-e292979672be" />
115
115
@@ -119,13 +119,13 @@ Sections of the text file or audio/video transcribed file will have sections of
119
119
120
120
You can select text that is not underlined and copy/replace without problems. You can click on a position (**without selecting a section of text**) to then type, delete, or paste text. This can occur in underlined (coded, annotated, case-assigned) or not underlined (not coded/annotated/case-assigned) text locations. You will see the underlines shift as text is added or removed.
121
121
122
-
**There are some limitations: It is best to avoid selecting sections of text to delete (or to type or paste over) if those sections have a combination of not underlined (not coded/annotated/case-assigned) and underlined (coded, annotated, case-assigned). The reason is that positions of the underlying codes/annotations/case-assigned may not correctly match as intended. If you have made a change that you think has affected these coded/annotated/case-assigned positions badly, exit the text editing window by pressing the Cancel button.**
122
+
**There are some limitations: It is best to avoid selecting sections of text to delete (or to type or paste over) if those sections have a combination of not underlined (not coded/annotated/case-assigned) and underlined (coded, annotated, case-assigned). The reason is that the positions of the underlying codes/annotations/case-assigned may not correctly match as intended. If you have made a change that you think has affected these coded/annotated/case-assigned positions badly, exit the text editing window by pressing the Cancel button.**
123
123
124
124
## Audio and Video files
125
125
126
126
Video (mov, mp4, wmv, ogg) and audio files (wav, mp3, m4a) can be imported. Loading an audio or video file will also automatically create a blank text transcribed file. This file will have the same name as the audio or video file, but have a '.txt' suffix. Initially, this text transcription will be empty. You can transcribe the file yourself or get the file professionally transcribed and copy and paste the text into this file.
127
127
128
-
You can open an audio or video file to view. for video, this opens two windows, one for viewing the video and one for the controls and a transcript, shown below. When an audio or video file is loaded into QualCoder a blank text transcription file is automatically created. The transcription file name defaults to videoname.txt.
128
+
You can open an audio or video file to view. For video, this opens two windows, one for viewing the video and one for the controls and a transcript, shown below. When an audio or video file is loaded into QualCoder a blank text transcription file is automatically created. The transcription file name defaults to videoname.txt.
129
129
130
130
The transcribed text file is created and stored within the database, and can be exported to a text file. The file can be edited. **Important note: The edits occur within the database. An original text file is NOT changed. Transcriptions cannot be linked as an external file.**
131
131
@@ -186,7 +186,7 @@ Sections of the text file or audio/video transcribed file will have sections of
186
186
187
187
You can select text that is not underlined and copy/replace without problems. You can click on a position (**without selecting text**) to then type, delete, or paste text. This can occur in underlined (coded, annotated, case-assigned) or not underlined (not coded/annotated/case-assigned) text locations. You will see the underlines shift as text is added or removed.
188
188
189
-
**There are some limitations: It is best to avoid selecting sections of text to delete (or to type or paste over) if those sections have a combination of not underlined (not coded/annotated/case-assigned) and underlined (coded, annotated, case-assigned). The reason is that positions of the underlying codes/annotations/case-assigned may not correctly match as intended. If you have made a change that you think has affected these coded/annotated/case-assigned positions badly, exit the text editing window by pressing the Cancel button.**
189
+
**There are some limitations: It is best to avoid selecting sections of text to delete (or to type or paste over) if those sections have a combination of not underlined (not coded/annotated/case-assigned) and underlined (coded, annotated, case-assigned). The reason is that the positions of the underlying codes/annotations/case-assigned may not correctly match as intended. If you have made a change that you think has affected these coded/annotated/case-assigned positions badly, exit the text editing window by pressing the Cancel button.**
190
190
191
191
## Example files
192
192
@@ -196,8 +196,8 @@ There are a few sample files in the Examples folder. These can be used to test i
196
196
197
197
If your project contains externally linked files, these files can be moved, renamed, or deleted.
198
198
199
-
The Manage bad links feature allows you to edit the existing link and replace it with a new one, by finding the correct file and it’s location. Bad links do affect images, audio and video files. Text is not impacted unless you need to review an original text document. This is because the plain text, on which coding occurs, is imported into the QualCoder database.
199
+
The Manage bad links feature allows you to edit the existing link and replace it with a new one, by finding the correct file and its location. Bad links do affect images, audio and video files. Text is not impacted unless you need to review an original text document. This is because the plain text, on which coding occurs, is imported into the QualCoder database.
200
200
201
-
The automated search takes time and looks through the user's home directory for up to 2 matching file names. This intended to speed up finding the link to files where the link is currently pointing to nothing.
201
+
The automated search takes time and looks through the user's home directory for up to 2 matching file names. This is intended to speed up finding the link to files where the link is currently pointing to nothing.
0 commit comments