Reference Lines and Reference Range
The xViz Gantt Chart provides you with the option to display Reference Lines (based on dates) and Reference Ranges on the chart thereby giving an indication of where you are in the project and to assess the level of completeness.
In this document:
Introduction
Reference Line - A date line spanning across all the tasks. Configuration of one date will add the reference line on the Chart.
![](https://docs.xviz.com/~gitbook/image?url=https%3A%2F%2F382510089-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FIuuIZWiXEx25eV75hmmJ%252Fuploads%252FeDcItFd1vt04jvr6UfTn%252F0.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=d3443a37&sv=1)
Reference Band - Range of continuous dates highlighted in the tasks. Configuring two dates ranges will be highlighted as a band in the chart.
![](https://docs.xviz.com/~gitbook/image?url=https%3A%2F%2F382510089-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FIuuIZWiXEx25eV75hmmJ%252Fuploads%252FeGEHAsjVKEn9Z8cqyzki%252F1.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=fa92a90&sv=1)
Setting up using configurations:
Go to the Advanced Editor -> References tab
![](https://docs.xviz.com/~gitbook/image?url=https%3A%2F%2F382510089-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FIuuIZWiXEx25eV75hmmJ%252Fuploads%252FQNsYuGl9rQO5QxZQsTHa%252F3.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=25854fbe&sv=1)
a. For Reference lines
The xViz Gantt provides users the option to set multiple reference lines based on different logic:
Date configuration
We need to configure one single date to add the Reference Line on the Chart:
First-of-date – Displays Reference Line on the earliest start date from the data where the Timeline starts.
![](https://docs.xviz.com/~gitbook/image?url=https%3A%2F%2F382510089-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FIuuIZWiXEx25eV75hmmJ%252Fuploads%252FwNmXT7XKGKjzSZadEbM2%252Fimage.png%3Falt%3Dmedia%26token%3D2bbeb995-21f0-423c-91bf-295d6299eb61&width=768&dpr=4&quality=100&sign=a1a5758&sv=1)
Last-of-date- Displays Reference Line on the latest start date from the data, where the Timeline ends.
Figure 5: Reference Line option Last-of-date in the xViz Gantt Chart Today- Displays Reference Line on the present day dynamically.
Figure 6: Reference Line option Today in the xViz Gantt Chart Custom Date- Displays Reference Line for the static date provided in the configuration.
![](https://docs.xviz.com/~gitbook/image?url=https%3A%2F%2F382510089-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FIuuIZWiXEx25eV75hmmJ%252Fuploads%252FaJOOXs3Sh9KpVx4FQNYb%252Fimage.png%3Falt%3Dmedia%26token%3D47c43a84-5019-4b3c-8e1d-aa9612b09fe0&width=768&dpr=4&quality=100&sign=6da54bf2&sv=1)
Formatting options for Reference Lines:
![](https://docs.xviz.com/~gitbook/image?url=https%3A%2F%2F382510089-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FIuuIZWiXEx25eV75hmmJ%252Fuploads%252FffOP8CNMimS2DoE3cYP0%252F12.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=8768806a&sv=1)
Reference Color - Choose from color palette and set the color as per needs.
Display Line Type and Stroke - Apply Line type formatting from the options below:
Dotted
Dashed
Solid
Dashed-Dotted
Adjust the Width of the Line type using Stroke Option.
Text- Font Weight, Position and Background-Format the text using Font size, Position, and background color options.
b. Reference Band
Use the reference range, Custom Date Range option to highlight a specific range on your Timeline.
Date configuration
We need to configure Custom Date from and Date to dates to highlight the specific Range in the Chart.
![](https://docs.xviz.com/~gitbook/image?url=https%3A%2F%2F382510089-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FIuuIZWiXEx25eV75hmmJ%252Fuploads%252Fnf7YQ4OP6yEbG7ipsNYD%252Fimage.png%3Falt%3Dmedia%26token%3D69a7ba16-1066-49b5-8bf7-f5b3da57eef7&width=768&dpr=4&quality=100&sign=982758b1&sv=1)
For the date range as well, the from and to dates can be set using the different date options shown in Reference Line section.
Formatting options for Reference Band:
Band Pattern and Color: Choose from various Patterns provided as per needs and set the color using color palette.
![](https://docs.xviz.com/~gitbook/image?url=https%3A%2F%2F382510089-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FIuuIZWiXEx25eV75hmmJ%252Fuploads%252FyzxNdGvAkt9oLBYWxgrk%252Fimage.png%3Falt%3Dmedia%26token%3Dda67bdbd-96ad-49c0-9139-1c36343a65b3&width=768&dpr=4&quality=100&sign=233c4da3&sv=1)
Text- Font Weight, Position and Background-Format the text using Font size, Position, and background color options.
Data driven reference line and range using the data fields of References:
We can also display the Reference line and Reference Range using the Data Fields of Reference Start Date and Reference End Date.
![](https://docs.xviz.com/~gitbook/image?url=https%3A%2F%2F382510089-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FIuuIZWiXEx25eV75hmmJ%252Fuploads%252FkbSdqj7voeRbtxIFEDox%252F17.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=d594c08f&sv=1)
In the above example, ‘Planned Start’ measure is added in Reference Start Date and ‘Planned End’ measure is added in Reference End Date. ‘Task’ measure is added to Reference Text which will display the text on the Reference Line.
![](https://docs.xviz.com/~gitbook/image?url=https%3A%2F%2F382510089-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FIuuIZWiXEx25eV75hmmJ%252Fuploads%252FQbdHkgHHZhArF1UHO2JA%252F18.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=27c91c45&sv=1)
From the above example, the Reference Line is displayed using dotted lines, the Range pattern is displayed using checkerboard and the text is displayed on the lines.
Steps to configure:
Go to the Format Pane->References.
Format the lines and the range using the options as shown below:
![](https://docs.xviz.com/~gitbook/image?url=https%3A%2F%2F382510089-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FIuuIZWiXEx25eV75hmmJ%252Fuploads%252FhDmB0SAOhSzbn9gVCc0V%252Fimage.png%3Falt%3Dmedia%26token%3D9a9a6918-bf26-41d0-ba78-8270fb4b7257&width=768&dpr=4&quality=100&sign=4b1addeb&sv=1)
Line type has four options:
Dotted
Solid
Dashed
Dashed-dotted.
![](https://docs.xviz.com/~gitbook/image?url=https%3A%2F%2F382510089-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FIuuIZWiXEx25eV75hmmJ%252Fuploads%252FtbbVtXQ8QxMpgzWfpTpf%252Fimage.png%3Falt%3Dmedia%26token%3D530d5d30-0e9a-404c-b72a-ebc930b8b6a1&width=768&dpr=4&quality=100&sign=805ee242&sv=1)
The width of the Line can be set using Line Stroke option and the color can be set using Line Color option.
There are fourteen options to set the Range Pattern:
![](https://docs.xviz.com/~gitbook/image?url=https%3A%2F%2F382510089-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FIuuIZWiXEx25eV75hmmJ%252Fuploads%252FXR2KSJFvrHvNQsusbsHx%252Fimage.png%3Falt%3Dmedia%26token%3Da38f931f-d550-448c-9a2b-425214c5ea1e&width=768&dpr=4&quality=100&sign=7687d748&sv=1)
Text can be formatted using the weight, color and text type options.
Try the xViz Gantt Chart (Microsoft certified) for Power BI from Microsoft AppSource here.
Last updated