Skip to content

Commit 7ce6675

Browse files
authored
Merge pull request #390 from hed-standard/develop
Updated what's new and added info on HED NWB extension
2 parents 3ac865d + 6e265bf commit 7ce6675

File tree

6 files changed

+32
-32
lines changed

6 files changed

+32
-32
lines changed

docs/source/HedMatlabTools.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -722,8 +722,8 @@ For the remodeling operations, first and second operation must be the dataset ro
722722
directory and the remodeling file name, respectively.
723723
In this example, dataset `ds003645` has been downloaded from [**openNeuro**](https://openneuro.org) to the `G:\` drive.
724724
The remodeling file used in this example can be found at
725-
See [**HED remodeling quickstart**](HedRemodelingQuickstart)
726-
and [**HED remodeling tools**](HedRemodelingTools) for
725+
See [**HED remodeling quickstart**](HedRemodelingQuickstart.md)
726+
and [**HED remodeling tools**](HedRemodelingTools.md) for
727727
additional information.
728728

729729
(web-service-matlab-demos-anchor)=

docs/source/HedPythonTools.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
The primary codebase for HED support is in Python.
44
Source code for the HED Python tools is available in the
5-
[**hed-python**](https://github.com/hed-standard/hed-pythong) GitHub repository
5+
[**hed-python**](https://github.com/hed-standard/hed-python) GitHub repository
66
See the [**HED tools API documentation**](https://hed-python.readthedocs.io/en/latest/) for
77
detailed information about the HED Tools API.
88

@@ -29,7 +29,7 @@ The HedTools package is available on PyPi and can be installed using:
2929
pip install hedtools
3030
```
3131
Prerelease versions of HedTools are available on the `develop` branch of the
32-
[**hed-python**](https://github.com/hed-standard/hed-pythong) GitHub repository
32+
[**hed-python**](https://github.com/hed-standard/hed-python) GitHub repository
3333
and can be installed using:
3434

3535
```shell

docs/source/HedRemodelingQuickstart.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ for example, during the conversion from the experimental control software format
1616
The tools can be run using a command-line script, called from a Jupyter notebook,
1717
or run using online tools. This quickstart covers the basic concepts of remodeling and
1818
develops some basic examples of how remodeling is used. See the
19-
[**HED remodeling tools**](./HedRemodelingTools)
19+
[**HED remodeling tools**](./HedRemodelingTools.md)
2020
guide for detailed descriptions of the available operations.
2121

2222
* [**What is remodeling?**](what-is-remodeling-anchor)
@@ -170,7 +170,7 @@ the *trial_type* column to *event_type*.
170170
````
171171

172172
Each remodel operation has its own specific set of required parameters
173-
that can be found under [**HED remodeling tools**](./HedRemodelingTools).
173+
that can be found under [**HED remodeling tools**](./HedRemodelingTools.md).
174174
For *rename_columns*, the required operations are *column_mapping* and *ignore_missing*.
175175
Some operations also have optional parameters.
176176

@@ -295,8 +295,8 @@ Event markers such as the participant's response key-press are encoded implicitl
295295
as an offset from the stimulus presentation.
296296
while event encoding includes event markers for each individual event within the trial.
297297

298-
The [**Split rows**](./HedRemodelingTools#split-rows)
299-
explanation under [**HED remodeling tools**](./HedRemodelingTools)
298+
The [**Split rows**](./HedRemodelingTools.md#split-rows)
299+
explanation under [**HED remodeling tools**](./HedRemodelingTools.md)
300300
shows the required parameters for the *split_rows* operation.
301301
The required parameters are *anchor_column*, *new_events*, and *remove_parent_row*.
302302

@@ -396,12 +396,12 @@ if you turn the *Include summaries* option on.
396396
(the-command-line-interface-anchor)=
397397
### The command-line interface
398398

399-
After [**installing the remodeler**](./HedRemodelingTools#installing-the-remodel-tools),
399+
After [**installing the remodeler**](./HedRemodelingTools.md#installing-the-remodel-tools),
400400
you can run the tools on a full BIDS dataset,
401401
or on any directory using the command-line interface using
402402
`run_remodel_backup`, `run_remodel`, and `run_remodel_restore`.
403403
A full overview of all arguments is available at
404-
[**HED remodeling tools**](./HedRemodelingTools#remodel-command-line-arguments).
404+
[**HED remodeling tools**](./HedRemodelingTools.md#remodel-command-line-arguments).
405405

406406
The `run_remodel_backup` is usually run only once for a dataset.
407407
It makes the baseline backup of the event files to assure that nothing will be lost.
@@ -432,9 +432,9 @@ The parameters are as follows:
432432

433433
There are three types of command line arguments:
434434

435-
[**Positional arguments**](./HedRemodelingTools#positional-arguments),
436-
[**Named arguments**](./HedRemodelingTools#named-arguments),
437-
and [**Named arguments with values**](./HedRemodelingTools#named-arguments).
435+
[**Positional arguments**](./HedRemodelingTools.md#positional-arguments),
436+
[**Named arguments**](./HedRemodelingTools.md#named-arguments),
437+
and [**Named arguments with values**](./HedRemodelingTools.md#named-arguments).
438438

439439
The positional arguments, `data_dir` and `model_path` are not optional and must
440440
be the first and second arguments to `run_remodel`, respectively.

docs/source/HedRemodelingTools.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ the tabular files unchanged.
1414

1515
The file remodeling tools can be applied to any tab-separated value (`.tsv`) file
1616
but are particularly useful for restructuring files representing experimental events.
17-
Please read the [**HED remodeling quickstart**](./HedRemodelingQuickstart)
17+
Please read the [**HED remodeling quickstart**](./HedRemodelingQuickstart.md)
1818
tutorials for an introduction and basic use of the tools.
1919

2020
The file remodeling tools can be applied to individual files using the

docs/source/HedValidationGuide.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -250,7 +250,7 @@ Errors, if any are printed to the command line.
250250
#### Remodeling validation summaries
251251

252252
Validation is also available through HED remodeling tool interface.
253-
As explained in [**HED remodeling quickstart**](./HedRemodelingQuickstart),
253+
As explained in [**HED remodeling quickstart**](./HedRemodelingQuickstart.md),
254254
the HED remodeling tools allow users to restructure their event files and/or
255255
summarize their contents in various ways.
256256
Users specify a list of operations in a JSON remodeling file,
@@ -318,7 +318,7 @@ For example, the text file is:
318318
`/root_path/derivatives/remodel/summaries/validate_initial_xxx.txt`
319319
where xxx is the time of generation.
320320

321-
For more information see [**HED remodeling quickstart**](./HedRemodelingQuickstart)
321+
For more information see [**HED remodeling quickstart**](./HedRemodelingQuickstart.md)
322322
for an overview of the remodeling process and
323-
[**HED remodeling tools**](./HedRemodelingTools) for detailed descriptions of
323+
[**HED remodeling tools**](./HedRemodelingTools.md) for detailed descriptions of
324324
the operations that are currently supported.

docs/source/HowCanYouUseHed.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -92,7 +92,7 @@ in post-processing and assure that the conditions are correctly marked.
9292
#### Logs to event files
9393

9494
Although the HED tools do not yet directly support any particular experimental presentation/control
95-
software packages, the HED [**HED remodeling tools**](./HedRemodelingTools) can
95+
software packages, the HED [**HED remodeling tools**](./HedRemodelingTools.md) can
9696
be useful in working with logged data.
9797

9898
Assuming that you can put the information from your experimental log into a tabular form such as:
@@ -108,8 +108,8 @@ Assuming that you can put the information from your experimental log into a tabu
108108
109109
````
110110

111-
The [**summarize column values**](./HedRemodelingTools#summarize-column-values)
112-
operation in the HED [**file remodeling tools**](./HedRemodelingTools)
111+
The [**summarize column values**](./HedRemodelingTools.md#summarize-column-values)
112+
operation in the HED [**file remodeling tools**](./HedRemodelingTools.md)
113113
compiles detailed summaries of the contents of tabular files.
114114
Use the following remodeling file and your tabular log file as input
115115
to the HED online [**event remodeling**](https://hedtools.ucsd.edu/hed_dev/events) tools
@@ -135,10 +135,10 @@ to quickly get an overview of its contents.
135135
### Post-processing the event data
136136

137137
The information that first comes off the experimental logs is usually not directly usable for
138-
sharing and analysis. A number of HED [**HED remodeling tools**](./HedRemodelingTools)
138+
sharing and analysis. A number of HED [**HED remodeling tools**](./HedRemodelingTools.md)
139139
might be helpful for restructuring your first pass at the event files.
140140

141-
The [**remap columns**](./HedRemodelingTools#remap-columns) transformation is
141+
The [**remap columns**](./HedRemodelingTools.md#remap-columns) transformation is
142142
particularly useful during the initial processing of tabular log information
143143
as exemplified by the following example
144144

@@ -395,7 +395,7 @@ to improperly handle these situations, reducing the accuracy of analysis.
395395
At this time, your only option is to do manual checks or write custom code to
396396
detect these types of experiment-specific inconsistencies.
397397
However, work is underway to include some standard types of checks in the
398-
HED [**HED remodeling tools**](./HedRemodelingTools) in future releases.
398+
HED [**HED remodeling tools**](./HedRemodelingTools.md) in future releases.
399399

400400
You may also want to reorganize the event files using the remodeling tools.
401401
See the [**Remap columns**](remap-columns-anchor)
@@ -431,7 +431,7 @@ work and possibly contact with the data authors for correct use and interpretati
431431
You can get a preliminary sense about what is actually in the data by downloading a
432432
single event file (e.g., a BIDS `_events.tsv`) and its associated JSON sidecar
433433
(e.g., a BIDS `_events.json`) and creating HED remodeling tool summaries using the
434-
[**HED online tools for debugging**](./HedRemodelingQuickstart#online-tools-for-debugging).
434+
[**HED online tools for debugging**](./HedRemodelingQuickstart.md#online-tools-for-debugging).
435435
Summaries of particular use for analysts include:
436436

437437
- The [**column value summary**](./HedSummaryGuide.md#column-value-summary) compiles a summary of
@@ -449,11 +449,11 @@ or temporal layout of the experiment.
449449
While HED tag summary and the experimental design summaries require that the dataset have HED annotations, these summaries do not rely on the experiment-specific
450450
event-coding used in each experiment and can be used to compare information for different datasets.
451451

452-
The [**HED remodeling quickstart**](./HedRemodelingQuickstart) tutorial
452+
The [**HED remodeling quickstart**](./HedRemodelingQuickstart.md) tutorial
453453
gives an overview of the remodeling tools and how to use them.
454-
More detailed information can be found in [**HED remodeling tools**](./HedRemodelingTools).
454+
More detailed information can be found in [**HED remodeling tools**](./HedRemodelingTools.md).
455455

456-
The [**Online tools for debugging**](./HedRemodelingQuickstart#online-tools-for-debugging)
456+
The [**Online tools for debugging**](./HedRemodelingQuickstart.md#online-tools-for-debugging)
457457
shows how to use remodeling tools to obtain these summaries without writing any code.
458458

459459
The [**HED conditions and design matrices**](HedConditionsAndDesignMatrices.md) guide explains how
@@ -474,8 +474,8 @@ additional code, while generality allows comparison of criteria across different
474474
experiments.
475475

476476
The factor generation as described in the next section relies on the HED
477-
[**HED remodeling tools**](HedRemodelingTools).
478-
See [**HED remodeling tools**](HedRemodelingTools).
477+
[**HED remodeling tools**](HedRemodelingTools.md).
478+
See [**HED remodeling tools**](HedRemodelingTools.md).
479479

480480
(factor-vectors-and-selection-anchor)=
481481
#### Factor vectors and selection
@@ -490,18 +490,18 @@ rows as the event file (each row corresponding to an event marker).
490490
Factor vectors contain 1's for rows in which a specified criterion is satisfied
491491
and 0's otherwise.
492492

493-
- The [**factor column operation**](./HedRemodelingTools#factor-column)
493+
- The [**factor column operation**](./HedRemodelingTools.md#factor-column)
494494
creates factor vectors based on the unique values in specified columns.
495495
This factor operation does not require any HED information.
496496
<p></p>
497497

498-
- The [**factor HED tags**](./HedRemodelingTools#factor-hed-tags)
498+
- The [**factor HED tags**](./HedRemodelingTools.md#factor-hed-tags)
499499
creates factor vectors based on a HED tag query.
500500
The [**HED search guide**](./HedSearchGuide.md) explains the HED query structure and
501501
available search options.
502502
<p></p>
503503

504-
- The [**factor HED type**](./HedRemodelingTools#factor-hed-type)
504+
- The [**factor HED type**](./HedRemodelingTools.md#factor-hed-type)
505505
creates factors based on a HED tag representing structural information about the data such as
506506
*Condition-variable* (for experimental design and experimental conditions) or *Task*.
507507

0 commit comments

Comments
 (0)